Skip to contentSkip to conversation

futex.2, mount_setattr.2, proc.5, netlink.7, tcp.7: tfix

PATCH In review Samanta Navarro 3 participants 6 messages Nov 13, 2021 – Nov 29, 2021 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 futex.2, mount_setattr.2, proc.5, netlink.7, tcp.7: tfix

Typos found with codespell.

---
 man2/futex.2         | 2 +-
 man2/mount_setattr.2 | 2 +-
 man5/proc.5          | 4 ++--
 man7/netlink.7       | 2 +-
 man7/tcp.7           | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)
man2/futex.2 +1 -1
index 1dd77ac..7210030 100644
@@ -1137,7 +1137,7 @@ except that the clock against which
 is measured is selectable.
 By default, the (absolute) timeout specified in
 .I timeout
-is measured againt the
+is measured against the
 .B CLOCK_MONOTONIC
 clock, but if the
 .B FUTEX_CLOCK_REALTIME
man2/mount_setattr.2 +1 -1
index 77233f5..ca56256 100644
@@ -986,7 +986,7 @@ main(int argc, char *argv[])
 .\"     because. Because making assumptions about the current working directory
 .\"     of the calling process is just too easy to get wrong; especially when
 .\"     pivot_root() or chroot() are in play.
-.\"     My absolut preference (joke intended) is to open a well-known starting
+.\"     My absolute preference (joke intended) is to open a well-known starting
 .\"     point with an absolute path to get a dirfd and then scope all future
 .\"     operations beneath that dirfd. This already works with old-style
 .\"     openat() and _very_ cautious programming but openat2() and its
man5/proc.5 +2 -2
index c668462..3f16dcd 100644
@@ -3068,7 +3068,7 @@ Further information about the zones can be found in
 .IR /proc/zoneinfo .
 .TP
 .I /proc/bus
-Contains subdirectories for installed busses.
+Contains subdirectories for installed buses.
 .TP
 .I /proc/bus/pccard
 Subdirectory for PCMCIA devices when
@@ -3079,7 +3079,7 @@ is set at kernel compilation time.
 .TP
 .I /proc/bus/pci
 Contains various bus subdirectories and pseudo-files containing
-information about PCI busses, installed devices, and device
+information about PCI buses, installed devices, and device
 drivers.
 Some of these files are not ASCII.
 .TP
man7/netlink.7 +1 -1
index 6b04fea..2991ec7 100644
@@ -191,7 +191,7 @@ structure,
 .B NLMSG_DONE
 message terminates a multipart message.
 Error messages get the
-original request appened, unless the user requests to cap the
+original request appended, unless the user requests to cap the
 error message, and get extra error data if requested.
 .PP
 .in +4n
man7/tcp.7 +1 -1
index 0a7c61a..8a871fc 100644
@@ -1161,7 +1161,7 @@ This option takes an
 as an argument.
 When the value is greater than 0,
 it specifies the maximum amount of time in milliseconds that transmitted
-data may remain unacknowledged, or bufferred data may remain untransmitted
+data may remain unacknowledged, or buffered data may remain untransmitted
 (due to zero window size) before TCP will forcibly close the
 corresponding connection and return
 .B ETIMEDOUT
Signature · 1 line
2.33.1
#1 lore raw

Hi Samanta,

Quoted 1 line · Samanta Navarro

Typos found with codespell.

[...]

man2/mount_setattr.2 main(int argc, char *argv[]) · line 992

Quoted 13 lines
man2/mount_setattr.2 +1 -1
index 77233f5..ca56256 100644
@@ -986,7 +986,7 @@ main(int argc, char *argv[])
 .\"     because. Because making assumptions about the current working directory
 .\"     of the calling process is just too easy to get wrong; especially when
 .\"     pivot_root() or chroot() are in play.
-.\"     My absolut preference (joke intended) is to open a well-known starting
+.\"     My absolute preference (joke intended) is to open a well-known starting
 .\"     point with an absolute path to get a dirfd and then scope all future
 .\"     operations beneath that dirfd. This already works with old-style
 .\"     openat() and _very_ cautious programming but openat2() and its

I always thought the foregoing was a double entendre expressing the author's taste for vodka...

Regards,
Branden

#2 lore raw

Hi Branden and Samanta,

Quoted 5 lines · G. Branden Robinson

Hi Samanta,

Quoted 1 line · Samanta Navarro

Typos found with codespell.

[...]

Quoted 16 lines

man2/mount_setattr.2 main(int argc, char *argv[]) · line 992

Quoted 13 lines
man2/mount_setattr.2 +1 -1
index 77233f5..ca56256 100644
@@ -986,7 +986,7 @@ main(int argc, char *argv[])
  .\"     because. Because making assumptions about the current working directory
  .\"     of the calling process is just too easy to get wrong; especially when
  .\"     pivot_root() or chroot() are in play.
-.\"     My absolut preference (joke intended) is to open a well-known starting
+.\"     My absolute preference (joke intended) is to open a well-known starting
  .\"     point with an absolute path to get a dirfd and then scope all future
  .\"     operations beneath that dirfd. This already works with old-style
  .\"     openat() and _very_ cautious programming but openat2() and its

I always thought the foregoing was a double entendre expressing the author's taste for vodka...

Yes. There have been other attempts to patch this[1], but I'll defend the author's joke, even if I don't share his preferences for liquid ingestion. :)

[1]: https://lore.kernel.org/linux-man/[email protected]/

Cheers,
Alex

Signature · 3 lines
Alejandro Colomar
Linux man-pages comaintainer; http://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/
#3 lore raw

Hi Samanta,

Quoted 27 lines · Alejandro Colomar (man-pages)

Hi Branden and Samanta,

Quoted 15 lines · G. Branden Robinson

Hi Samanta,

Quoted 1 line · Samanta Navarro

Typos found with codespell.

[...]

Quoted 10 lines
man2/mount_setattr.2 +0 -0
index 77233f5..ca56256 100644
@@ -986,7 +986,7 @@ main(int argc, char *argv[])

  .\"     because. Because making assumptions about the current working directory .\"     of the calling process is just too easy to get wrong; especially when .\"     pivot_root() or chroot() are in play.
-.\"     My absolut preference (joke intended) is to open a well-known starting

Quoted 8 lines
Quoted 5 lines

+.\"     My absolute preference (joke intended) is to open a well-known starting
  .\"     point with an absolute path to get a dirfd and then scope all future .\"     operations beneath that dirfd. This already works with old-style .\"     openat() and _very_ cautious programming but openat2() and its

I always thought the foregoing was a double entendre expressing the author's taste for vodka...

Quoted 3 lines

Yes.  There have been other attempts to patch this[1], but I'll defend the author's joke, even if I don't share his preferences for liquid ingestion. :)

[1]: https://lore.kernel.org/linux-man/[email protected]/

However, I like the rest of the patch. I you don't mind, could you please resend it without fixing the joke?

Thanks,
Alex

Signature · 3 lines
Alejandro Colomar
Linux man-pages comaintainer; http://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/
#4 lore raw

Typos found with codespell.

---
 man2/futex.2         | 2 +-
 man2/mount_setattr.2 | 2 +-
 man5/proc.5          | 4 ++--
 man7/netlink.7       | 2 +-
 man7/tcp.7           | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)
man2/futex.2 +1 -1
index 1dd77ac..7210030 100644
@@ -1137,7 +1137,7 @@ except that the clock against which
 is measured is selectable.
 By default, the (absolute) timeout specified in
 .I timeout
-is measured againt the
+is measured against the
 .B CLOCK_MONOTONIC
 clock, but if the
 .B FUTEX_CLOCK_REALTIME
man5/proc.5 +2 -2
index c668462..3f16dcd 100644
@@ -3068,7 +3068,7 @@ Further information about the zones can be found in
 .IR /proc/zoneinfo .
 .TP
 .I /proc/bus
-Contains subdirectories for installed busses.
+Contains subdirectories for installed buses.
 .TP
 .I /proc/bus/pccard
 Subdirectory for PCMCIA devices when
@@ -3079,7 +3079,7 @@ is set at kernel compilation time.
 .TP
 .I /proc/bus/pci
 Contains various bus subdirectories and pseudo-files containing
-information about PCI busses, installed devices, and device
+information about PCI buses, installed devices, and device
 drivers.
 Some of these files are not ASCII.
 .TP
man7/netlink.7 +1 -1
index 6b04fea..2991ec7 100644
@@ -191,7 +191,7 @@ structure,
 .B NLMSG_DONE
 message terminates a multipart message.
 Error messages get the
-original request appened, unless the user requests to cap the
+original request appended, unless the user requests to cap the
 error message, and get extra error data if requested.
 .PP
 .in +4n
man7/tcp.7 +1 -1
index 0a7c61a..8a871fc 100644
@@ -1161,7 +1161,7 @@ This option takes an
 as an argument.
 When the value is greater than 0,
 it specifies the maximum amount of time in milliseconds that transmitted
-data may remain unacknowledged, or bufferred data may remain untransmitted
+data may remain unacknowledged, or buffered data may remain untransmitted
 (due to zero window size) before TCP will forcibly close the
 corresponding connection and return
 .B ETIMEDOUT
Signature · 1 line
2.34.0
#5 lore raw

Hi Samanta,

Quoted 4 lines · Samanta Navarro

Typos found with codespell.

Patch applied.

I had to manually remove the changes to futex.2, since that typo had already been fixed a couple of months ago in my tree, so I also renamed the subject.

Thanks,

Alex

Quoted 70 lines
---
  man2/futex.2         | 2 +-
  man2/mount_setattr.2 | 2 +-
  man5/proc.5          | 4 ++--
  man7/netlink.7       | 2 +-
  man7/tcp.7           | 2 +-
  5 files changed, 6 insertions(+), 6 deletions(-)
man2/futex.2 +1 -1
index 1dd77ac..7210030 100644
@@ -1137,7 +1137,7 @@ except that the clock against which
  is measured is selectable.
  By default, the (absolute) timeout specified in
  .I timeout
-is measured againt the
+is measured against the
  .B CLOCK_MONOTONIC
  clock, but if the
  .B FUTEX_CLOCK_REALTIME
man5/proc.5 +2 -2
index c668462..3f16dcd 100644
@@ -3068,7 +3068,7 @@ Further information about the zones can be found in
  .IR /proc/zoneinfo .
  .TP
  .I /proc/bus
-Contains subdirectories for installed busses.
+Contains subdirectories for installed buses.
  .TP
  .I /proc/bus/pccard
  Subdirectory for PCMCIA devices when
@@ -3079,7 +3079,7 @@ is set at kernel compilation time.
  .TP
  .I /proc/bus/pci
  Contains various bus subdirectories and pseudo-files containing
-information about PCI busses, installed devices, and device
+information about PCI buses, installed devices, and device
  drivers.
  Some of these files are not ASCII.
  .TP
man7/netlink.7 +1 -1
index 6b04fea..2991ec7 100644
@@ -191,7 +191,7 @@ structure,
  .B NLMSG_DONE
  message terminates a multipart message.
  Error messages get the
-original request appened, unless the user requests to cap the
+original request appended, unless the user requests to cap the
  error message, and get extra error data if requested.
  .PP
  .in +4n
man7/tcp.7 +1 -1
index 0a7c61a..8a871fc 100644
@@ -1161,7 +1161,7 @@ This option takes an
  as an argument.
  When the value is greater than 0,
  it specifies the maximum amount of time in milliseconds that transmitted
-data may remain unacknowledged, or bufferred data may remain untransmitted
+data may remain unacknowledged, or buffered data may remain untransmitted
  (due to zero window size) before TCP will forcibly close the
  corresponding connection and return
  .B ETIMEDOUT
Signature · 2 lines
Alejandro Colomar
Linux man-pages comaintainer; http://www.kernel.org/doc/man-pages/