Skip to contentSkip to conversation

man/man2/*: Miscellaneous fixes

PATCH Applied Seth McDonald 2 participants 9 messages Feb 22 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

cover man/man2/*: Miscellaneous fixes

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

Signature · 1 line
2.53.0.1
#1 lore raw

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

---
 man/man2/open_tree.2 | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)
man/man2/open_tree.2 +5 -3
index ad23caf15113..3e587f7be14b 100644
@@ -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
Signature · 1 line
2.53.0.1
#2 lore raw

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

In reply to Seth McDonald
---
 man/man2/perfmonctl.2 | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
man/man2/perfmonctl.2 +3 -3
index 08d052cd3eaa..b84aac5e97e0 100644
@@ -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
Signature · 1 line
2.53.0.1
#3 lore raw

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

In reply to Seth McDonald
---
 man/man2/process_madvise.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
man/man2/process_madvise.2 +1 -1
index 446617c4a4a5..7aa36b197487 100644
@@ -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
Signature · 1 line
2.53.0.1
#4 lore raw

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

In reply to Seth McDonald
---
 man/man2/readv.2 | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)
man/man2/readv.2 +8 -4
index 765d487b9ff1..51549cf8214a 100644
@@ -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
Signature · 1 line
2.53.0.1
#6 lore raw

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

In reply to Seth McDonald
---
 man/man2/s390_guarded_storage.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
man/man2/s390_guarded_storage.2 +1 -1
index 1a2e8a30cf99..2f17385050ca 100644
@@ -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
Signature · 1 line
2.53.0.1
#7 lore raw
In reply to Seth McDonald

Hi Seth,

Quoted 4 lines · Seth McDonald

Hi Alex,

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

Thanks!

Quoted 3 lines

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 <[email protected]>
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 <[email protected]>
To: Alejandro Colomar <[email protected]>
Cc: Seth McDonald <[email protected]>, [email protected]
Subject: [PATCH 1/5] man/man2/open_tree.2: HISTORY: ffix
Message-ID: <3b27c0e095e33180f26181043f64f1a52a6066e8.1771750388.git.dev@sethm.id.au>
References: <[email protected]>
In-Reply-To: <[email protected]>

---

Have a lovely night!
Alex

Quoted 25 lines

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

Signature · 1 line
2.53.0.1
Signature · 1 line
<https://www.alejandro-colomar.es>
maintainer Applied
#8 lore raw
In reply to Seth McDonald

Hi Seth,

Quoted 9 lines · Seth McDonald

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.

Quoted 6 lines

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

Quoted 18 lines
 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

Signature · 1 line
2.53.0.1
Signature · 1 line
<https://www.alejandro-colomar.es>
#5 lore raw

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

In reply to Seth McDonald
Quoted 21 lines · Seth McDonald
---
 man/man2/readv.2 | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)
man/man2/readv.2 +4 -2
index 765d487b9ff1..51549cf8214a 100644
@@ -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.

man/man2/readv.2 .SH HISTORY · line 478

Quoted 10 lines
man/man2/readv.2 +4 -2
 .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
Quoted 2 lines
Signature · 1 line
2.53.0.1
Signature · 1 line
<https://www.alejandro-colomar.es>