[PATCH 00/16] man2: fix wrong/non-existent section references

[PATCH 00/16] man2: fix wrong/non-existent section references

[Kir Kolyshkin]

Commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections") results in many wrong section references.

This patch series tries to fix some of these issues in man2 section
which I was able to find.

*** BLURB HERE ***

Kir Kolyshkin (16):
  cacheflush.2: fix section reference
  clone.2: fix wrong section reference
  execve.2: fix wrong section reference
  gethostname.2: fix section reference
  getpriority.2: move info from NOTES to HISTORY
  gettimeofday.2: fix wrong section reference
  ioperm.2: fix wrong section reference
  kill.2: fix wrong section reference
  mkdir.2: fix wrong section reference
  mmap.2: fix wrong section reference
  nice.2: fix wrong section reference
  open.2: fix wrong section reference
  readdir.2: fix wrong section reference
  semctl.2: fix wrong section reference
  uname.2: fix wrong section reference
  wait.2: fix wrong section reference

 man/man2/cacheflush.2   |  2 +-
 man/man2/clone.2        |  2 +-
 man/man2/execve.2       |  2 +-
 man/man2/gethostname.2  |  2 +-
 man/man2/getpriority.2  | 32 ++++++++++++++++----------------
 man/man2/gettimeofday.2 |  2 +-
 man/man2/ioperm.2       |  2 +-
 man/man2/kill.2         |  2 +-
 man/man2/mkdir.2        |  2 +-
 man/man2/mmap.2         |  2 +-
 man/man2/nice.2         |  2 +-
 man/man2/open.2         |  4 ++--
 man/man2/readdir.2      |  2 +-
 man/man2/semctl.2       |  2 +-
 man/man2/uname.2        |  2 +-
 man/man2/wait.2         |  2 +-
 16 files changed, 32 insertions(+), 32 deletions(-)

-- 
2.45.2

[PATCH 01/16] cacheflush.2: fix section reference

[Kir Kolyshkin]

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/cacheflush.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/cacheflush.2 b/man/man2/cacheflush.2
index bc38355e6..0e3b4ac62 100644
--- a/man/man2/cacheflush.2
+++ b/man/man2/cacheflush.2
@@ -18,7 +18,7 @@ .SH SYNOPSIS
 .P
 .IR Note :
 On some architectures,
-there is no glibc wrapper for this system call; see NOTES.
+there is no glibc wrapper for this system call; see VERSIONS.
 .SH DESCRIPTION
 .BR cacheflush ()
 flushes the contents of the indicated cache(s) for the
-- 
2.45.2

[PATCH 02/16] clone.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> For the prototype of the raw clone() system call, see NOTES

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this prototype is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/clone.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/clone.2 b/man/man2/clone.2
index 655e50b82..90ab5cadf 100644
--- a/man/man2/clone.2
+++ b/man/man2/clone.2
@@ -58,7 +58,7 @@ .SH SYNOPSIS
 .BI "                                       void *_Nullable " tls ,
 .BI "                                       pid_t *_Nullable " child_tid " \fR*/\fP );"
 .P
-/* For the prototype of the raw clone() system call, see NOTES */
+/* For the prototype of the raw clone() system call, see VERSIONS. */
 .P
 .BR "#include <linux/sched.h>" "    /* Definition of " "struct clone_args" " */"
 .BR "#include <sched.h>" "          /* Definition of " CLONE_* " constants */"
-- 
2.45.2

[PATCH 03/16] execve.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> For portable use, optional-arg should either be absent, or be
> specified as a single word (i.e., it should not contain white
> space); see NOTES below.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about optional-arg is in
VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/execve.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/execve.2 b/man/man2/execve.2
index 997bb4724..1802258ae 100644
--- a/man/man2/execve.2
+++ b/man/man2/execve.2
@@ -362,7 +362,7 @@ .SS Interpreter scripts
 For portable use,
 .I optional-arg
 should either be absent, or be specified as a single word (i.e., it
-should not contain white space); see NOTES below.
+should not contain white space); see VERSIONS below.
 .P
 Since Linux 2.6.28,
 .\" commit bf2a9a39639b8b51377905397a5005f444e9a892
-- 
2.45.2

[PATCH 04/16] gethostname.2: fix section reference

[Kir Kolyshkin]

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/gethostname.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/gethostname.2 b/man/man2/gethostname.2
index 1a9fc0d2f..ad9e96b3f 100644
--- a/man/man2/gethostname.2
+++ b/man/man2/gethostname.2
@@ -69,7 +69,7 @@ .SH DESCRIPTION
 .I len
 bytes.
 If the null-terminated hostname is too large to fit,
-then the name is truncated, and no error is returned (but see NOTES below).
+then the name is truncated, and no error is returned (but see VERSIONS below).
 POSIX.1 says that if such truncation occurs,
 then it is unspecified whether the returned buffer
 includes a terminating null byte.
-- 
2.45.2

[PATCH 05/16] getpriority.2: move info from NOTES to HISTORY

[Kir Kolyshkin]

In the spirit of commit 4131356cd ("man*/, man-pages.7: VERSIONS,
STANDARDS, HISTORY: Reorganize sections"), move the historical
information about EPERM error from NOTES to HISTORY, and fix the
section reference accordingly.

Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/getpriority.2 | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/man/man2/getpriority.2 b/man/man2/getpriority.2
index 111b591b5..4784407ee 100644
--- a/man/man2/getpriority.2
+++ b/man/man2/getpriority.2
@@ -138,7 +138,7 @@ .SH ERRORS
 and was not privileged (on Linux: did not have the
 .B CAP_SYS_NICE
 capability).
-But see NOTES below.
+But see HISTORY below.
 .TP
 .B ESRCH
 No process was located using the
@@ -151,21 +151,6 @@ .SH STANDARDS
 .SH HISTORY
 POSIX.1-2001,
 SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD).
-.SH NOTES
-For further details on the nice value, see
-.BR sched (7).
-.P
-.IR Note :
-the addition of the "autogroup" feature in Linux 2.6.38 means that
-the nice value no longer has its traditional effect in many circumstances.
-For details, see
-.BR sched (7).
-.P
-A child created by
-.BR fork (2)
-inherits its parent's nice value.
-The nice value is preserved across
-.BR execve (2).
 .P
 The details on the condition for
 .B EPERM
@@ -182,6 +167,21 @@ .SH NOTES
 4.3BSD, FreeBSD 4.3, OpenBSD-2.5, ...) behave in the same
 manner as Linux 2.6.12 and later.
 .\"
+.SH NOTES
+For further details on the nice value, see
+.BR sched (7).
+.P
+.IR Note :
+the addition of the "autogroup" feature in Linux 2.6.38 means that
+the nice value no longer has its traditional effect in many circumstances.
+For details, see
+.BR sched (7).
+.P
+A child created by
+.BR fork (2)
+inherits its parent's nice value.
+The nice value is preserved across
+.BR execve (2).
 .SS C library/kernel differences
 The getpriority system call returns nice values translated to the range 40..1,
 since a negative return value would be interpreted as an error.
-- 
2.45.2

[PATCH 06/16] gettimeofday.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> The use of the timezone structure is obsolete; the tz argument should
> normally be specified as NULL. (See NOTES below.)

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/gettimeofday.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/gettimeofday.2 b/man/man2/gettimeofday.2
index e0231e230..b7fba16d8 100644
--- a/man/man2/gettimeofday.2
+++ b/man/man2/gettimeofday.2
@@ -105,7 +105,7 @@ .SH DESCRIPTION
 structure is obsolete; the
 .I tz
 argument should normally be specified as NULL.
-(See NOTES below.)
+See VERSIONS.
 .P
 Under Linux, there are some peculiar "warp clock" semantics associated
 with the
-- 
2.45.2

[PATCH 07/16] ioperm.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> Permissions are inherited by the child created by fork (2)
> (but see HISTORY).

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about permission
inheritance is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/ioperm.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/ioperm.2 b/man/man2/ioperm.2
index a2cde4721..5b6550e46 100644
--- a/man/man2/ioperm.2
+++ b/man/man2/ioperm.2
@@ -50,7 +50,7 @@ .SH DESCRIPTION
 .P
 Permissions are inherited by the child created by
 .BR fork (2)
-(but see NOTES).
+(but see HISTORY).
 Permissions are preserved across
 .BR execve (2);
 this is useful for giving port access permissions to unprivileged
-- 
2.45.2

Re: [PATCH 07/16] ioperm.2: fix wrong section reference

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1190 bytes --]

On Mon, Jun 17, 2024 at 04:10:19PM GMT, Kir Kolyshkin wrote:
> The man page says:
> 
> > Permissions are inherited by the child created by fork (2)
> > (but see HISTORY).
> 
> Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
> HISTORY: Reorganize sections"), the discussion about permission
> inheritance is in VERSIONS.

The commit message is inconsistent.  Here it says VERSIONS.
> 
> Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
> Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
> ---
>  man/man2/ioperm.2 | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man/man2/ioperm.2 b/man/man2/ioperm.2
> index a2cde4721..5b6550e46 100644
> --- a/man/man2/ioperm.2
> +++ b/man/man2/ioperm.2
> @@ -50,7 +50,7 @@ .SH DESCRIPTION
>  .P
>  Permissions are inherited by the child created by
>  .BR fork (2)
> -(but see NOTES).
> +(but see HISTORY).

But it's changed to HISTORY.

>  Permissions are preserved across
>  .BR execve (2);
>  this is useful for giving port access permissions to unprivileged
> -- 
> 2.45.2
> 
> 

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2 07/16] ioperm.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> Permissions are inherited by the child created by fork (2)
> (but see NOTES).

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the relevant information is in HISTORY.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/ioperm.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/ioperm.2 b/man/man2/ioperm.2
index a2cde4721..5b6550e46 100644
--- a/man/man2/ioperm.2
+++ b/man/man2/ioperm.2
@@ -50,7 +50,7 @@ .SH DESCRIPTION
 .P
 Permissions are inherited by the child created by
 .BR fork (2)
-(but see NOTES).
+(but see HISTORY).
 Permissions are preserved across
 .BR execve (2);
 this is useful for giving port access permissions to unprivileged
-- 
2.45.2

Re: [PATCH v2 07/16] ioperm.2: fix wrong section reference

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1131 bytes --]

Hi Kir,

On Tue, Jun 18, 2024 at 10:35:21AM GMT, Kir Kolyshkin wrote:
> The man page says:
> 
> > Permissions are inherited by the child created by fork (2)
> > (but see NOTES).
> 
> Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
> HISTORY: Reorganize sections"), the relevant information is in HISTORY.
> 
> Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
> Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>

Patch applied; thanks.

Have a lovely day!
Alex

> ---
>  man/man2/ioperm.2 | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man/man2/ioperm.2 b/man/man2/ioperm.2
> index a2cde4721..5b6550e46 100644
> --- a/man/man2/ioperm.2
> +++ b/man/man2/ioperm.2
> @@ -50,7 +50,7 @@ .SH DESCRIPTION
>  .P
>  Permissions are inherited by the child created by
>  .BR fork (2)
> -(but see NOTES).
> +(but see HISTORY).
>  Permissions are preserved across
>  .BR execve (2);
>  this is useful for giving port access permissions to unprivileged
> -- 
> 2.45.2
> 

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 08/16] kill.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> (Historically, the rules were different; see NOTES.)

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the historical rules moved to HISTORY.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/kill.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/kill.2 b/man/man2/kill.2
index 16500fba2..8a9317930 100644
--- a/man/man2/kill.2
+++ b/man/man2/kill.2
@@ -77,7 +77,7 @@ .SH DESCRIPTION
 .BR SIGCONT ,
 it suffices when the sending and receiving
 processes belong to the same session.
-(Historically, the rules were different; see NOTES.)
+(Historically, the rules were different; see HISTORY.)
 .SH RETURN VALUE
 On success (at least one signal was sent), zero is returned.
 On error, \-1 is returned, and
-- 
2.45.2

[PATCH 09/16] mkdir.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> Whether other mode bits are honored for the created directory depends
> on the operating system. For Linux, see VERSIONS below.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about permission
inheritance is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/mkdir.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/mkdir.2 b/man/man2/mkdir.2
index 1d9cddbe6..3e56475c3 100644
--- a/man/man2/mkdir.2
+++ b/man/man2/mkdir.2
@@ -53,7 +53,7 @@ .SH DESCRIPTION
 Whether other
 .I mode
 bits are honored for the created directory depends on the operating system.
-For Linux, see NOTES below.
+For Linux, see VERSIONS below.
 .P
 The newly created directory will be owned by the effective user ID of the
 process.
-- 
2.45.2

[PATCH 10/16] mmap.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> See NOTES for information on feature test macro requirements.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/mmap.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/mmap.2 b/man/man2/mmap.2
index 12d60f500..a7a429137 100644
--- a/man/man2/mmap.2
+++ b/man/man2/mmap.2
@@ -34,7 +34,7 @@ .SH SYNOPSIS
 .BI "int munmap(void " addr [. length "], size_t " length );
 .fi
 .P
-See NOTES for information on feature test macro requirements.
+See VERSIONS for information on feature test macro requirements.
 .SH DESCRIPTION
 .BR mmap ()
 creates a new mapping in the virtual address space of
-- 
2.45.2

[PATCH 11/16] nice.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> On success, the new nice value is returned (but see NOTES below).

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/nice.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/nice.2 b/man/man2/nice.2
index 20d8d8ec1..743286eae 100644
--- a/man/man2/nice.2
+++ b/man/man2/nice.2
@@ -51,7 +51,7 @@ .SH DESCRIPTION
 .BR getrlimit (2)
 for details.
 .SH RETURN VALUE
-On success, the new nice value is returned (but see NOTES below).
+On success, the new nice value is returned (but see VERSIONS below).
 On error, \-1 is returned, and
 .I errno
 is set to indicate the error.
-- 
2.45.2

[PATCH 12/16] open.2: fix wrong section reference

[Kir Kolyshkin]

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about O_SYNC and O_DSYNC
is now under VERSIONS / Synchronized I/O.

While at it, fix the typesetting.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/open.2 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man/man2/open.2 b/man/man2/open.2
index 1e98a1df4..88d065179 100644
--- a/man/man2/open.2
+++ b/man/man2/open.2
@@ -418,7 +418,7 @@ .SH DESCRIPTION
 .BR write (2)
 was followed by a call to
 .BR fdatasync (2)).
-.IR "See NOTES below" .
+See VERSIONS.
 .TP
 .B O_EXCL
 Ensure that this call creates the file:
@@ -776,7 +776,7 @@ .SH DESCRIPTION
 .BR write (2)
 was followed by a call to
 .BR fsync (2)).
-.IR "See NOTES below" .
+See VERSIONS.
 .TP
 .BR O_TMPFILE " (since Linux 3.11)"
 .\" commit 60545d0d4610b02e55f65d141c95b18ccf855b6e
-- 
2.45.2

[PATCH 13/16] readdir.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> There is no definition of struct old_linux_dirent; see NOTES.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/readdir.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/readdir.2 b/man/man2/readdir.2
index 1fb02f7d5..e4b58a652 100644
--- a/man/man2/readdir.2
+++ b/man/man2/readdir.2
@@ -25,7 +25,7 @@ .SH SYNOPSIS
 .IR Note :
 There is no definition of
 .BR "struct old_linux_dirent" ;
-see NOTES.
+see VERSIONS.
 .SH DESCRIPTION
 This is not the function you are interested in.
 Look at
-- 
2.45.2

[PATCH 14/16] semctl.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> GETPID
> 	Return the sempid value for the semnum-th semaphore of
>	the set. This is the PID of the process that last
> 	performed an operation on that semaphore (but see NOTES).

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/semctl.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/semctl.2 b/man/man2/semctl.2
index 243919c73..4dad99ea4 100644
--- a/man/man2/semctl.2
+++ b/man/man2/semctl.2
@@ -317,7 +317,7 @@ .SH DESCRIPTION
 .IR semnum \-th
 semaphore of the set.
 This is the PID of the process that last performed an operation on
-that semaphore (but see NOTES).
+that semaphore (but see VERSIONS).
 The calling process must have read permission on the semaphore set.
 .TP
 .B GETVAL
-- 
2.45.2

[PATCH 15/16] uname.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> The length of the arrays in a struct utsname is unspecified (see NOTES);

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS and
HISTORY.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/uname.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/uname.2 b/man/man2/uname.2
index 572bfd3a6..09453dc9c 100644
--- a/man/man2/uname.2
+++ b/man/man2/uname.2
@@ -44,7 +44,7 @@ .SH DESCRIPTION
 .P
 The length of the arrays in a
 .I struct utsname
-is unspecified (see NOTES);
+is unspecified (see VERSIONS and HISTORY);
 the fields are terminated by a null byte (\[aq]\[rs]0\[aq]).
 .SH RETURN VALUE
 On success, zero is returned.
-- 
2.45.2

[PATCH 16/16] wait.2: fix wrong section reference

[Kir Kolyshkin]

The man page says:

> This is the glibc and POSIX interface; see
> NOTES for information on the raw system call.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
---
 man/man2/wait.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/wait.2 b/man/man2/wait.2
index dbbb8abf5..46baa6da6 100644
--- a/man/man2/wait.2
+++ b/man/man2/wait.2
@@ -42,7 +42,7 @@ .SH SYNOPSIS
 .BI "int waitid(idtype_t " idtype ", id_t " id \
 ", siginfo_t *" infop ", int " options );
                 /* This is the glibc and POSIX interface; see
-                   NOTES for information on the raw system call. */
+                   VERSIONS for information on the raw system call. */
 .fi
 .P
 .RS -4
-- 
2.45.2

Re: [PATCH 00/16] man2: fix wrong/non-existent section references

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1921 bytes --]

Hi Kir,

On Mon, Jun 17, 2024 at 04:10:12PM GMT, Kir Kolyshkin wrote:
> Commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
> Reorganize sections") results in many wrong section references.
> 
> This patch series tries to fix some of these issues in man2 section
> which I was able to find.

Thanks!  I've applied all patches, except 07 (the commit message didn't
match the diff).

Have a lovely day!
Alex

> 
> *** BLURB HERE ***
> 
> Kir Kolyshkin (16):
>   cacheflush.2: fix section reference
>   clone.2: fix wrong section reference
>   execve.2: fix wrong section reference
>   gethostname.2: fix section reference
>   getpriority.2: move info from NOTES to HISTORY
>   gettimeofday.2: fix wrong section reference
>   ioperm.2: fix wrong section reference
>   kill.2: fix wrong section reference
>   mkdir.2: fix wrong section reference
>   mmap.2: fix wrong section reference
>   nice.2: fix wrong section reference
>   open.2: fix wrong section reference
>   readdir.2: fix wrong section reference
>   semctl.2: fix wrong section reference
>   uname.2: fix wrong section reference
>   wait.2: fix wrong section reference
> 
>  man/man2/cacheflush.2   |  2 +-
>  man/man2/clone.2        |  2 +-
>  man/man2/execve.2       |  2 +-
>  man/man2/gethostname.2  |  2 +-
>  man/man2/getpriority.2  | 32 ++++++++++++++++----------------
>  man/man2/gettimeofday.2 |  2 +-
>  man/man2/ioperm.2       |  2 +-
>  man/man2/kill.2         |  2 +-
>  man/man2/mkdir.2        |  2 +-
>  man/man2/mmap.2         |  2 +-
>  man/man2/nice.2         |  2 +-
>  man/man2/open.2         |  4 ++--
>  man/man2/readdir.2      |  2 +-
>  man/man2/semctl.2       |  2 +-
>  man/man2/uname.2        |  2 +-
>  man/man2/wait.2         |  2 +-
>  16 files changed, 32 insertions(+), 32 deletions(-)
> 
> -- 
> 2.45.2
> 
> 

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]