[PATCH 0/5] man/man2/*: Miscellaneous fixes

[PATCH 0/5] man/man2/*: Miscellaneous fixes

[Seth McDonald]

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

Hi Alex,

This is just a handful of minor fixes I came across, mainly for making
some formatting more consistent.

Btw, could you let me know if these patches' *PGP signatures are valid?
I've written a script to help with signing outgoing patches and want to
make sure it's working correctly.

Seth McDonald (5):
  man/man2/open_tree.2: HISTORY: ffix
  man/man2/perfmonctl.2: HISTORY: wfix
  man/man2/process_madvise.2: HISTORY: ffix
  man/man2/readv.2: HISTORY: ffix
  man/man2/s390_guarded_storage.2: HISTORY: ffix

 man/man2/open_tree.2            |  8 +++++---
 man/man2/perfmonctl.2           |  6 +++---
 man/man2/process_madvise.2      |  2 +-
 man/man2/readv.2                | 12 ++++++++----
 man/man2/s390_guarded_storage.2 |  2 +-
 5 files changed, 18 insertions(+), 12 deletions(-)

Range-diff:
-:  ------------ > 1:  3b27c0e095e3 man/man2/open_tree.2: HISTORY: ffix
-:  ------------ > 2:  5be05e964e14 man/man2/perfmonctl.2: HISTORY: wfix
-:  ------------ > 3:  e0ecd2307cf9 man/man2/process_madvise.2: HISTORY: ffix
-:  ------------ > 4:  f336517a9084 man/man2/readv.2: HISTORY: ffix
-:  ------------ > 5:  464d2acd9d62 man/man2/s390_guarded_storage.2: HISTORY: ffix

base-commit: 8f299601fb600d305279acc03a92437a8378d0b6
-- 
2.53.0.1

[-- Attachment #2: *PGP Signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

[PATCH 1/5] man/man2/open_tree.2: HISTORY: ffix

[Seth McDonald]

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

Signed-off-by: Seth McDonald <dev@sethm.id.au>
---
 man/man2/open_tree.2 | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/man/man2/open_tree.2 b/man/man2/open_tree.2
index ad23caf15113..3e587f7be14b 100644
--- a/man/man2/open_tree.2
+++ b/man/man2/open_tree.2
@@ -491,12 +491,14 @@ .SH ERRORS
 .SH STANDARDS
 Linux.
 .SH HISTORY
-.SS open_tree()
-Linux 5.2.
+.TP
+.BR open_tree ()
+Linux 5.2,
 .\" commit a07b20004793d8926f78d63eb5980559f7813404
 .\" commit 400913252d09f9cfb8cce33daee43167921fc343
 glibc 2.36.
-.SS open_tree_attr()
+.TP
+.BR open_tree_attr ()
 Linux 6.15.
 .\" commit c4a16820d90199409c9bf01c4f794e1e9e8d8fd8
 .\" commit 7a54947e727b6df840780a66c970395ed9734ebe
-- 
2.53.0.1

[-- Attachment #2: *PGP Signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

[PATCH 2/5] man/man2/perfmonctl.2: HISTORY: wfix

[Seth McDonald]

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

Signed-off-by: Seth McDonald <dev@sethm.id.au>
---
 man/man2/perfmonctl.2 | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/man/man2/perfmonctl.2 b/man/man2/perfmonctl.2
index 08d052cd3eaa..b84aac5e97e0 100644
--- a/man/man2/perfmonctl.2
+++ b/man/man2/perfmonctl.2
@@ -181,12 +181,12 @@ .SH RETURN VALUE
 .SH STANDARDS
 Linux on IA-64.
 .SH HISTORY
-Added in Linux 2.4;
+Linux 2.4.
 .\" commit ecf5b72d5f66af843f189dfe9ce31598c3e48ad7
-removed in Linux 5.10.
+Removed in Linux 5.10.
 .P
 This system call was broken for many years,
-and ultimately removed in Linux 5.10.
+and was ultimately removed in Linux 5.10.
 .P
 glibc does not provide a wrapper for this system call;
 on kernels where it exists, call it using
-- 
2.53.0.1

[-- Attachment #2: *PGP Signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

[PATCH 3/5] man/man2/process_madvise.2: HISTORY: ffix

[Seth McDonald]

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

Signed-off-by: Seth McDonald <dev@sethm.id.au>
---
 man/man2/process_madvise.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/process_madvise.2 b/man/man2/process_madvise.2
index 446617c4a4a5..7aa36b197487 100644
--- a/man/man2/process_madvise.2
+++ b/man/man2/process_madvise.2
@@ -184,7 +184,7 @@ .SH ERRORS
 .SH STANDARDS
 Linux.
 .SH HISTORY
-Linux 5.10.
+Linux 5.10,
 .\" Linux commit ecb8ac8b1f146915aa6b96449b66dd48984caacc
 glibc 2.36.
 .\" glibc commit d19ee3473d68ca0e794f3a8b7677a0983ae1342e
-- 
2.53.0.1

[-- Attachment #2: *PGP Signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

[PATCH 4/5] man/man2/readv.2: HISTORY: ffix

[Seth McDonald]

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

Signed-off-by: Seth McDonald <dev@sethm.id.au>
---
 man/man2/readv.2 | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/man/man2/readv.2 b/man/man2/readv.2
index 765d487b9ff1..51549cf8214a 100644
--- a/man/man2/readv.2
+++ b/man/man2/readv.2
@@ -462,13 +462,17 @@ .SH HISTORY
 .\" The readv/writev system calls were buggy before Linux 1.3.40.
 .\" (Says release.libc.)
 .P
-.BR preadv (),
-.BR pwritev ():
+.TP
+.BR preadv ()
+.TQ
+.BR pwritev ()
 Linux 2.6.30,
 glibc 2.10.
 .P
-.BR preadv2 (),
-.BR pwritev2 ():
+.TP
+.BR preadv2 ()
+.TQ
+.BR pwritev2 ()
 Linux 4.6,
 glibc 2.26.
 .SS Historical C library/kernel differences
-- 
2.53.0.1

[-- Attachment #2: *PGP Signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

[PATCH 5/5] man/man2/s390_guarded_storage.2: HISTORY: ffix

[Seth McDonald]

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

Signed-off-by: Seth McDonald <dev@sethm.id.au>
---
 man/man2/s390_guarded_storage.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/man2/s390_guarded_storage.2 b/man/man2/s390_guarded_storage.2
index 1a2e8a30cf99..2f17385050ca 100644
--- a/man/man2/s390_guarded_storage.2
+++ b/man/man2/s390_guarded_storage.2
@@ -133,7 +133,7 @@ .SH STANDARDS
 Linux on s390.
 .SH HISTORY
 .\" 916cda1aa1b412d7cf2991c3af7479544942d121, v4.12-rc1~139^2~56^2
-Linux 4.12.
+Linux 4.12,
 System z14.
 .SH NOTES
 The description of the guarded storage facility along with related
-- 
2.53.0.1

[-- Attachment #2: *PGP Signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

Re: [PATCH 0/5] man/man2/*: Miscellaneous fixes

[Alejandro Colomar]

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

Hi Seth,

On 2026-02-22T20:12:10+1000, Seth McDonald wrote:
> Hi Alex,
> 
> This is just a handful of minor fixes I came across, mainly for making
> some formatting more consistent.

Thanks!

> Btw, could you let me know if these patches' *PGP signatures are valid?
> I've written a script to help with signing outgoing patches and want to
> make sure it's working correctly.

The signatures seem correct.  Here's part what I see in the first patch:

	[-- Begin signature information --]
	Good signature from: Seth McDonald <dev@sethm.id.au>
		    created: Sun Feb 22 11:12:52 2026
	WARNING: We have NO indication whether the key belongs to the person named as shown above
	Fingerprint: E9D1 26A5 F0D4 9DF7 792B  C2E2 B4BF 4530 D39B 2D51
	[-- End signature information --]

	[-- The following data is signed --]
	Date: Sun, 22 Feb 2026 20:12:11 +1000
	From: Seth McDonald <dev@sethm.id.au>
	To: Alejandro Colomar <alx@kernel.org>
	Cc: Seth McDonald <dev@sethm.id.au>, linux-man@vger.kernel.org
	Subject: [PATCH 1/5] man/man2/open_tree.2: HISTORY: ffix
	Message-ID: <3b27c0e095e33180f26181043f64f1a52a6066e8.1771750388.git.dev@sethm.id.au>
	References: <cover.1771750388.git.dev@sethm.id.au>
	In-Reply-To: <cover.1771750388.git.dev@sethm.id.au>

	Signed-off-by: Seth McDonald <dev@sethm.id.au>
	---

Have a lovely night!
Alex

> 
> Seth McDonald (5):
>   man/man2/open_tree.2: HISTORY: ffix
>   man/man2/perfmonctl.2: HISTORY: wfix
>   man/man2/process_madvise.2: HISTORY: ffix
>   man/man2/readv.2: HISTORY: ffix
>   man/man2/s390_guarded_storage.2: HISTORY: ffix
> 
>  man/man2/open_tree.2            |  8 +++++---
>  man/man2/perfmonctl.2           |  6 +++---
>  man/man2/process_madvise.2      |  2 +-
>  man/man2/readv.2                | 12 ++++++++----
>  man/man2/s390_guarded_storage.2 |  2 +-
>  5 files changed, 18 insertions(+), 12 deletions(-)
> 
> Range-diff:
> -:  ------------ > 1:  3b27c0e095e3 man/man2/open_tree.2: HISTORY: ffix
> -:  ------------ > 2:  5be05e964e14 man/man2/perfmonctl.2: HISTORY: wfix
> -:  ------------ > 3:  e0ecd2307cf9 man/man2/process_madvise.2: HISTORY: ffix
> -:  ------------ > 4:  f336517a9084 man/man2/readv.2: HISTORY: ffix
> -:  ------------ > 5:  464d2acd9d62 man/man2/s390_guarded_storage.2: HISTORY: ffix
> 
> base-commit: 8f299601fb600d305279acc03a92437a8378d0b6
> -- 
> 2.53.0.1



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

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

Re: [PATCH 0/5] man/man2/*: Miscellaneous fixes

[Alejandro Colomar]

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

Hi Seth,

On 2026-02-22T20:12:10+1000, Seth McDonald wrote:
> Hi Alex,
> 
> This is just a handful of minor fixes I came across, mainly for making
> some formatting more consistent.
> 
> Btw, could you let me know if these patches' *PGP signatures are valid?
> I've written a script to help with signing outgoing patches and want to
> make sure it's working correctly.
> 
> Seth McDonald (5):
>   man/man2/open_tree.2: HISTORY: ffix
>   man/man2/perfmonctl.2: HISTORY: wfix
>   man/man2/process_madvise.2: HISTORY: ffix
>   man/man2/readv.2: HISTORY: ffix
>   man/man2/s390_guarded_storage.2: HISTORY: ffix

I've applied all the patches; thanks!


Cheers,
Alex

> 
>  man/man2/open_tree.2            |  8 +++++---
>  man/man2/perfmonctl.2           |  6 +++---
>  man/man2/process_madvise.2      |  2 +-
>  man/man2/readv.2                | 12 ++++++++----
>  man/man2/s390_guarded_storage.2 |  2 +-
>  5 files changed, 18 insertions(+), 12 deletions(-)
> 
> Range-diff:
> -:  ------------ > 1:  3b27c0e095e3 man/man2/open_tree.2: HISTORY: ffix
> -:  ------------ > 2:  5be05e964e14 man/man2/perfmonctl.2: HISTORY: wfix
> -:  ------------ > 3:  e0ecd2307cf9 man/man2/process_madvise.2: HISTORY: ffix
> -:  ------------ > 4:  f336517a9084 man/man2/readv.2: HISTORY: ffix
> -:  ------------ > 5:  464d2acd9d62 man/man2/s390_guarded_storage.2: HISTORY: ffix
> 
> base-commit: 8f299601fb600d305279acc03a92437a8378d0b6
> -- 
> 2.53.0.1



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

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

Re: [PATCH 4/5] man/man2/readv.2: HISTORY: ffix

[Alejandro Colomar]

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

On 2026-02-22T20:12:14+1000, Seth McDonald wrote:
> Signed-off-by: Seth McDonald <dev@sethm.id.au>
> ---
>  man/man2/readv.2 | 12 ++++++++----
>  1 file changed, 8 insertions(+), 4 deletions(-)
> 
> diff --git a/man/man2/readv.2 b/man/man2/readv.2
> index 765d487b9ff1..51549cf8214a 100644
> --- a/man/man2/readv.2
> +++ b/man/man2/readv.2
> @@ -462,13 +462,17 @@ .SH HISTORY
>  .\" The readv/writev system calls were buggy before Linux 1.3.40.
>  .\" (Says release.libc.)
>  .P
> -.BR preadv (),
> -.BR pwritev ():
> +.TP
> +.BR preadv ()
> +.TQ
> +.BR pwritev ()
>  Linux 2.6.30,
>  glibc 2.10.
>  .P
> -.BR preadv2 (),
> -.BR pwritev2 ():
> +.TP
> +.BR preadv2 ()
> +.TQ
> +.BR pwritev2 ()
>  Linux 4.6,
>  glibc 2.26.
>  .SS Historical C library/kernel differences

This patch had issues:

	remote: mandoc: .tmp/man/man2/readv.2:464:2: WARNING: skipping paragraph macro: PP empty
	remote: mandoc: .tmp/man/man2/readv.2:471:2: WARNING: skipping paragraph macro: PP empty
	remote: make: *** [/home/alx/src/linux/man-pages/man-pages/contrib/share/mk/lint/man/mandoc.mk:31: .tmp/man/man2/readv.2.lint-man.mandoc.touch] Error 1

So I amended it:

	diff --git i/man/man2/readv.2 w/man/man2/readv.2
	index 51549cf8214a..cbfc1e0ffa83 100644
	--- i/man/man2/readv.2
	+++ w/man/man2/readv.2
	@@ -461,14 +461,12 @@ .SH HISTORY
	 .\" as the return type.
	 .\" The readv/writev system calls were buggy before Linux 1.3.40.
	 .\" (Says release.libc.)
	-.P
	 .TP
	 .BR preadv ()
	 .TQ
	 .BR pwritev ()
	 Linux 2.6.30,
	 glibc 2.10.
	-.P
	 .TP
	 .BR preadv2 ()
	 .TQ

> -- 
> 2.53.0.1



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

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