* [PATCH 00/11] man2/: punctuate long numeric strings with digit separators @ 2023-02-07 20:32 Brian Inglis 2023-02-07 20:32 ` [PATCH 01/11] man2/shmget.2: fix limit units suffix from SI to IEC Brian Inglis ` (11 more replies) 0 siblings, 12 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar man2/: use C digit separators with \\[aq] to show "'" or ISO/IEC suffixes to clarify long binary, octal, hex, decimal numeric strings; use consistent interval notation for value ranges; fix minor discrepancies. [PATCH 01/11] man2/shmget.2: fix limit units suffix from SI to IEC [PATCH 02/11] man2/spu_run.2: fix example comment status code or-ed [PATCH 03/11] man2/: use consistent interval notation for value [PATCH 04/11] man2/open.2: punctuate octal perms with digit [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit [PATCH 07/11] man2/statfs.2: punctuate hex in docs with digit [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix [PATCH 10/11] man2/futex.2: change limit to use ISO suffix [PATCH 11/11] man2/: punctuate long numeric strings with digit Brian Inglis (11): man2/shmget.2: fix limit units suffix from SI to IEC man2/spu_run.2: fix example comment status code or-ed value man2/: use consistent interval notation for value ranges man2/open.2: punctuate octal perms with digit separators man2/reboot.2: show BCD dates in hex not decimal man2/reboot.2: punctuate hex in docs with digit separators man2/statfs.2: punctuate hex in docs with digit separators man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs man2/getrandom.2: change limit to use IEC suffix man2/futex.2: change limit to use ISO suffix man2/: punctuate long numeric strings with digit separators man2/add_key.2 | 2 +- man2/adjtimex.2 | 12 ++--- man2/clock_getres.2 | 2 +- man2/clock_nanosleep.2 | 2 +- man2/eventfd.2 | 6 +-- man2/execve.2 | 2 +- man2/fcntl.2 | 4 +- man2/futex.2 | 2 +- man2/getitimer.2 | 4 +- man2/getrandom.2 | 2 +- man2/gettimeofday.2 | 2 +- man2/ioctl.2 | 4 +- man2/ioctl_console.2 | 2 +- man2/ioctl_getfsmap.2 | 4 +- man2/ioperm.2 | 2 +- man2/kexec_load.2 | 2 +- man2/link.2 | 4 +- man2/msgget.2 | 2 +- man2/nanosleep.2 | 4 +- man2/open.2 | 32 ++++++------ man2/pciconfig_read.2 | 2 +- man2/perf_event_open.2 | 2 +- man2/personality.2 | 8 +-- man2/prctl.2 | 2 +- man2/read.2 | 2 +- man2/reboot.2 | 24 ++++----- man2/semget.2 | 4 +- man2/sendfile.2 | 2 +- man2/shmget.2 | 2 +- man2/sigaction.2 | 4 +- man2/spu_run.2 | 8 +-- man2/statfs.2 | 110 ++++++++++++++++++++--------------------- man2/statx.2 | 2 +- man2/syscall.2 | 2 +- man2/timer_settime.2 | 4 +- man2/timerfd_create.2 | 2 +- man2/truncate.2 | 4 +- man2/utimensat.2 | 6 +-- man2/write.2 | 2 +- 39 files changed, 144 insertions(+), 144 deletions(-) -- 2.39.0 ^ permalink raw reply [flat|nested] 16+ messages in thread
* [PATCH 01/11] man2/shmget.2: fix limit units suffix from SI to IEC 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 02/11] man2/spu_run.2: fix example comment status code or-ed value Brian Inglis ` (10 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 74 bytes --] --- man2/shmget.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0001-man2-shmget.2-fix-limit-units-suffix-from-SI-to-IEC.patch --] [-- Type: text/x-patch; name="0001-man2-shmget.2-fix-limit-units-suffix-from-SI-to-IEC.patch", Size: 496 bytes --] diff --git a/man2/shmget.2 b/man2/shmget.2 index cdb2d3bee4b5..4bc18bedf3a9 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -354,7 +354,7 @@ for a discussion of why this default value (rather than is used. .IP From Linux 2.2 up to Linux 3.15, the default value of -this limit was 0x2000000 (32\ MB). +this limit was 0x2000000 (32\ MiB). .IP Because it is not possible to map just part of a shared memory segment, the amount of virtual memory places another limit on the maximum size of a ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 02/11] man2/spu_run.2: fix example comment status code or-ed value 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis 2023-02-07 20:32 ` [PATCH 01/11] man2/shmget.2: fix limit units suffix from SI to IEC Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 03/11] man2/: use consistent interval notation for value ranges Brian Inglis ` (9 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 75 bytes --] --- man2/spu_run.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0002-man2-spu_run.2-fix-example-comment-status-code-or-ed.patch --] [-- Type: text/x-patch; name="0002-man2-spu_run.2-fix-example-comment-status-code-or-ed.patch", Size: 432 bytes --] diff --git a/man2/spu_run.2 b/man2/spu_run.2 index 00d552986052..139f10a97a80 100644 --- a/man2/spu_run.2 +++ b/man2/spu_run.2 @@ -245,7 +245,7 @@ int main(void) err(EXIT_FAILURE, "open"); /* - * We should see a status code of 0x1234002: + * We should see a status code of 0x12340002: * 0x00000002 (spu was stopped due to stop\-and\-signal) * | 0x12340000 (the stop\-and\-signal code) */ ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 03/11] man2/: use consistent interval notation for value ranges 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis 2023-02-07 20:32 ` [PATCH 01/11] man2/shmget.2: fix limit units suffix from SI to IEC Brian Inglis 2023-02-07 20:32 ` [PATCH 02/11] man2/spu_run.2: fix example comment status code or-ed value Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 04/11] man2/open.2: punctuate octal perms with digit separators Brian Inglis ` (8 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 245 bytes --] --- man2/clock_getres.2 | 2 +- man2/clock_nanosleep.2 | 2 +- man2/getitimer.2 | 4 ++-- man2/gettimeofday.2 | 2 +- man2/nanosleep.2 | 4 ++-- man2/utimensat.2 | 2 +- 6 files changed, 8 insertions(+), 8 deletions(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0003-man2-use-consistent-interval-notation-for-value-rang.patch --] [-- Type: text/x-patch; name="0003-man2-use-consistent-interval-notation-for-value-rang.patch", Size: 2983 bytes --] diff --git a/man2/clock_getres.2 b/man2/clock_getres.2 index 501c878cae4e..ee0fa6735865 100644 --- a/man2/clock_getres.2 +++ b/man2/clock_getres.2 @@ -272,7 +272,7 @@ does not refer to a valid instance of a clock object. .I tp.tv_sec is negative or .I tp.tv_nsec -is outside the range [0..999,999,999]. +is outside the range [0, 999,999,999]. .TP .B EINVAL The diff --git a/man2/clock_nanosleep.2 b/man2/clock_nanosleep.2 index 5afc2025c853..5da8d15699c2 100644 --- a/man2/clock_nanosleep.2 +++ b/man2/clock_nanosleep.2 @@ -158,7 +158,7 @@ The sleep was interrupted by a signal handler; see .B EINVAL The value in the .I tv_nsec -field was not in the range 0 to 999999999 or +field was not in the range [0, 999999999] or .I tv_sec was negative. .TP diff --git a/man2/getitimer.2 b/man2/getitimer.2 index 093752b620ed..80745dd78c99 100644 --- a/man2/getitimer.2 +++ b/man2/getitimer.2 @@ -158,7 +158,7 @@ or (since Linux 2.6.22) one of the .I tv_usec fields in the structure pointed to by .I new_value -contains a value outside the range 0 to 999999. +contains a value outside the range [0, 999999]. .SH STANDARDS POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD). POSIX.1-2008 marks @@ -253,7 +253,7 @@ POSIX.1-2001 says that .BR setitimer () should fail if a .I tv_usec -value is specified that is outside of the range 0 to 999999. +value is specified that is outside of the range [0, 999999]. However, up to and including Linux 2.6.21, Linux does not give an error, but instead silently adjusts the corresponding seconds value for the timer. diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index 6f1cd33d6512..d7219f9d42a4 100644 --- a/man2/gettimeofday.2 +++ b/man2/gettimeofday.2 @@ -152,7 +152,7 @@ is invalid. .I tv.tv_sec is negative or .I tv.tv_usec -is outside the range [0..999,999]. +is outside the range [0, 999999]. .TP .BR EINVAL " (since Linux 4.3)" .\" commit e1d7ba8735551ed79c7a0463a042353574b96da3 diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index a6f9e627f4eb..12e0cee84b85 100644 --- a/man2/nanosleep.2 +++ b/man2/nanosleep.2 @@ -66,7 +66,7 @@ The structure is used to specify intervals of time with nanosecond precision. .PP -The value of the nanoseconds field must be in the range 0 to 999999999. +The value of the nanoseconds field must be in the range [0, 999999999]. .PP Compared to .BR sleep (3) @@ -106,7 +106,7 @@ again and continue with the pause. .B EINVAL The value in the .I tv_nsec -field was not in the range 0 to 999999999 or +field was not in the range [0, 999999999] or .I tv_sec was negative. .SH STANDARDS diff --git a/man2/utimensat.2 b/man2/utimensat.2 index 7f43aab7bdcf..1d9206ed0ced 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -272,7 +272,7 @@ Invalid value in .B EINVAL Invalid value in one of the .I tv_nsec -fields (value outside range 0 to 999,999,999, and not +fields (value outside range [0, 999999999], and not .B UTIME_NOW or .BR UTIME_OMIT ); ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 04/11] man2/open.2: punctuate octal perms with digit separators 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (2 preceding siblings ...) 2023-02-07 20:32 ` [PATCH 03/11] man2/: use consistent interval notation for value ranges Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal Brian Inglis ` (7 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 107 bytes --] --- man2/open.2 | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0004-man2-open.2-punctuate-octal-perms-with-digit-separat.patch --] [-- Type: text/x-patch; name="0004-man2-open.2-punctuate-octal-perms-with-digit-separat.patch", Size: 2287 bytes --] diff --git a/man2/open.2 b/man2/open.2 index fc796e25537d..82e3e2102e7c 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -308,40 +308,40 @@ The following symbolic constants are provided for .RS .TP 9 .B S_IRWXU -00700 user (file owner) has read, write, and execute permission +00\[aq]700 user (file owner) has read, write, and execute permission .TP .B S_IRUSR -00400 user has read permission +00\[aq]400 user has read permission .TP .B S_IWUSR -00200 user has write permission +00\[aq]200 user has write permission .TP .B S_IXUSR -00100 user has execute permission +00\[aq]100 user has execute permission .TP .B S_IRWXG -00070 group has read, write, and execute permission +00\[aq]070 group has read, write, and execute permission .TP .B S_IRGRP -00040 group has read permission +00\[aq]040 group has read permission .TP .B S_IWGRP -00020 group has write permission +00\[aq]020 group has write permission .TP .B S_IXGRP -00010 group has execute permission +00\[aq]010 group has execute permission .TP .B S_IRWXO -00007 others have read, write, and execute permission +00\[aq]007 others have read, write, and execute permission .TP .B S_IROTH -00004 others have read permission +00\[aq]004 others have read permission .TP .B S_IWOTH -00002 others have write permission +00\[aq]002 others have write permission .TP .B S_IXOTH -00001 others have execute permission +00\[aq]001 others have execute permission .RE .IP According to POSIX, the effect when other bits are set in @@ -352,14 +352,14 @@ On Linux, the following bits are also honored in .RS .TP 9 .B S_ISUID -0004000 set-user-ID bit +0\[aq]004\[aq]000 set-user-ID bit .TP .B S_ISGID -0002000 set-group-ID bit (see +0\[aq]002\[aq]000 set-group-ID bit (see .BR inode (7)). .TP .B S_ISVTX -0001000 sticky bit (see +0\[aq]001\[aq]000 sticky bit (see .BR inode (7)). .RE .TP @@ -1319,7 +1319,7 @@ flags are not specified in POSIX.1-2001, but are specified in POSIX.1-2008. Since glibc 2.12, one can obtain their definitions by defining either .B _POSIX_C_SOURCE -with a value greater than or equal to 200809L or +with a value greater than or equal to 2008\[aq]09L or .B _XOPEN_SOURCE with a value greater than or equal to 700. In glibc 2.11 and earlier, one obtains the definitions by defining ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (3 preceding siblings ...) 2023-02-07 20:32 ` [PATCH 04/11] man2/open.2: punctuate octal perms with digit separators Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit separators Brian Inglis ` (6 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 82 bytes --] --- man2/reboot.2 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0005-man2-reboot.2-show-BCD-dates-in-hex-not-decimal.patch --] [-- Type: text/x-patch; name="0005-man2-reboot.2-show-BCD-dates-in-hex-not-decimal.patch", Size: 645 bytes --] diff --git a/man2/reboot.2 b/man2/reboot.2 index fcdc56a93e38..d20fdf31a451 100644 --- a/man2/reboot.2 +++ b/man2/reboot.2 @@ -51,16 +51,16 @@ equals .I magic2 equals .B LINUX_REBOOT_MAGIC2 -(that is, 672274793). +(that is, 0x28121969). However, since Linux 2.1.17 also .B LINUX_REBOOT_MAGIC2A -(that is, 85072278) +(that is, 0x05121996) and since Linux 2.1.97 also .B LINUX_REBOOT_MAGIC2B -(that is, 369367448) +(that is, 0x16041998) and since Linux 2.5.71 also .B LINUX_REBOOT_MAGIC2C -(that is, 537993216) +(that is, 0x20112000) are permitted as values for .IR magic2 . (The hexadecimal values of these constants are meaningful.) ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit separators 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (4 preceding siblings ...) 2023-02-07 20:32 ` [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 07/11] man2/statfs.2: " Brian Inglis ` (5 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 101 bytes --] --- man2/reboot.2 | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0006-man2-reboot.2-punctuate-hex-in-docs-with-digit-separ.patch --] [-- Type: text/x-patch; name="0006-man2-reboot.2-punctuate-hex-in-docs-with-digit-separ.patch", Size: 2859 bytes --] diff --git a/man2/reboot.2 b/man2/reboot.2 index d20fdf31a451..1d65bf18691d 100644 --- a/man2/reboot.2 +++ b/man2/reboot.2 @@ -47,20 +47,20 @@ unless .I magic equals .B LINUX_REBOOT_MAGIC1 -(that is, 0xfee1dead) and +(that is, 0xfee1\[aq]dead) and .I magic2 equals .B LINUX_REBOOT_MAGIC2 -(that is, 0x28121969). +(that is 0x2812\[aq]1969). However, since Linux 2.1.17 also .B LINUX_REBOOT_MAGIC2A -(that is, 0x05121996) +(that is 0x0512\[aq]1996) and since Linux 2.1.97 also .B LINUX_REBOOT_MAGIC2B -(that is, 0x16041998) +(that is 0x1604\[aq]1998) and since Linux 2.5.71 also .B LINUX_REBOOT_MAGIC2C -(that is, 0x20112000) +(that is 0x2011\[aq]2000) are permitted as values for .IR magic2 . (The hexadecimal values of these constants are meaningful.) @@ -81,7 +81,7 @@ proper action (maybe: kill all processes, sync, reboot). .TP .B LINUX_REBOOT_CMD_CAD_ON .RB ( RB_ENABLE_CAD , -0x89abcdef). +0x89ab\[aq]cdef). CAD is enabled. This means that the CAD keystroke will immediately cause the action associated with @@ -89,7 +89,7 @@ the action associated with .TP .B LINUX_REBOOT_CMD_HALT .RB ( RB_HALT_SYSTEM , -0xcdef0123; since Linux 1.1.76). +0xcdef\[aq]0123; since Linux 1.1.76). The message "System halted." is printed, and the system is halted. Control is given to the ROM monitor, if there is one. If not preceded by a @@ -98,7 +98,7 @@ data will be lost. .TP .B LINUX_REBOOT_CMD_KEXEC .RB ( RB_KEXEC , -0x45584543, since Linux 2.6.13). +0x4558\[aq]4543; since Linux 2.6.13). Execute a kernel that has been loaded earlier with .BR kexec_load (2). This option is available only if the kernel was configured with @@ -106,7 +106,7 @@ This option is available only if the kernel was configured with .TP .B LINUX_REBOOT_CMD_POWER_OFF .RB ( RB_POWER_OFF , -0x4321fedc; since Linux 2.1.30). +0x4321\[aq]fedc; since Linux 2.1.30). The message "Power down." is printed, the system is stopped, and all power is removed from the system, if possible. If not preceded by a @@ -115,7 +115,7 @@ data will be lost. .TP .B LINUX_REBOOT_CMD_RESTART .RB ( RB_AUTOBOOT , -0x1234567). +0x0123\[aq]4567). The message "Restarting system." is printed, and a default restart is performed immediately. If not preceded by a @@ -123,7 +123,7 @@ If not preceded by a data will be lost. .TP .B LINUX_REBOOT_CMD_RESTART2 -(0xa1b2c3d4; since Linux 2.1.30). +(0xa1b2\[aq]c3d4; since Linux 2.1.30). The message "Restarting system with command \(aq%s\(aq" is printed, and a restart (using the command string given in .IR arg ) @@ -134,7 +134,7 @@ data will be lost. .TP .B LINUX_REBOOT_CMD_SW_SUSPEND .RB ( RB_SW_SUSPEND , -0xd000fce1; since Linux 2.5.18). +0xd000\[aq]fce1; since Linux 2.5.18). The system is suspended (hibernated) to disk. This option is available only if the kernel was configured with .BR CONFIG_HIBERNATION . ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 07/11] man2/statfs.2: punctuate hex in docs with digit separators 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (5 preceding siblings ...) 2023-02-07 20:32 ` [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit separators Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs Brian Inglis ` (4 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 128 bytes --] --- man2/statfs.2 | 110 +++++++++++++++++++++++++------------------------- 1 file changed, 55 insertions(+), 55 deletions(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0007-man2-statfs.2-punctuate-hex-in-docs-with-digit-separ.patch --] [-- Type: text/x-patch; name="0007-man2-statfs.2-punctuate-hex-in-docs-with-digit-separ.patch", Size: 5758 bytes --] diff --git a/man2/statfs.2 b/man2/statfs.2 index 8c4d6236f258..b2831b3a85b3 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -58,90 +58,90 @@ The following filesystem types may appear in .EX ADFS_SUPER_MAGIC 0xadf5 AFFS_SUPER_MAGIC 0xadff -AFS_SUPER_MAGIC 0x5346414f -ANON_INODE_FS_MAGIC 0x09041934 /* Anonymous inode FS (for +AFS_SUPER_MAGIC 0x5346\[aq]414f +ANON_INODE_FS_MAGIC 0x0904\[aq]1934 /* Anonymous inode FS (for pseudofiles that have no name; e.g., epoll, signalfd, bpf) */ AUTOFS_SUPER_MAGIC 0x0187 -BDEVFS_MAGIC 0x62646576 -BEFS_SUPER_MAGIC 0x42465331 -BFS_MAGIC 0x1badface -BINFMTFS_MAGIC 0x42494e4d -BPF_FS_MAGIC 0xcafe4a11 -BTRFS_SUPER_MAGIC 0x9123683e -BTRFS_TEST_MAGIC 0x73727279 -CGROUP_SUPER_MAGIC 0x27e0eb /* Cgroup pseudo FS */ -CGROUP2_SUPER_MAGIC 0x63677270 /* Cgroup v2 pseudo FS */ -CIFS_MAGIC_NUMBER 0xff534d42 -CODA_SUPER_MAGIC 0x73757245 -COH_SUPER_MAGIC 0x012ff7b7 -CRAMFS_MAGIC 0x28cd3d45 -DEBUGFS_MAGIC 0x64626720 +BDEVFS_MAGIC 0x6264\[aq]6576 +BEFS_SUPER_MAGIC 0x4246\[aq]5331 +BFS_MAGIC 0x1bad\[aq]face +BINFMTFS_MAGIC 0x4249\[aq]4e4d +BPF_FS_MAGIC 0xcafe\[aq]4a11 +BTRFS_SUPER_MAGIC 0x9123\[aq]683e +BTRFS_TEST_MAGIC 0x7372\[aq]7279 +CGROUP_SUPER_MAGIC 0x27\[aq]e0eb /* Cgroup pseudo FS */ +CGROUP2_SUPER_MAGIC 0x6367\[aq]7270 /* Cgroup v2 pseudo FS */ +CIFS_MAGIC_NUMBER 0xff53\[aq]4d42 +CODA_SUPER_MAGIC 0x7375\[aq]7245 +COH_SUPER_MAGIC 0x012f\[aq]f7b7 +CRAMFS_MAGIC 0x28cd\[aq]3d45 +DEBUGFS_MAGIC 0x6462\[aq]6720 DEVFS_SUPER_MAGIC 0x1373 /* Linux 2.6.17 and earlier */ DEVPTS_SUPER_MAGIC 0x1cd1 ECRYPTFS_SUPER_MAGIC 0xf15f -EFIVARFS_MAGIC 0xde5e81e4 -EFS_SUPER_MAGIC 0x00414a53 +EFIVARFS_MAGIC 0xde5e\[aq]81e4 +EFS_SUPER_MAGIC 0x0041\[aq]4a53 EXT_SUPER_MAGIC 0x137d /* Linux 2.0 and earlier */ EXT2_OLD_SUPER_MAGIC 0xef51 EXT2_SUPER_MAGIC 0xef53 EXT3_SUPER_MAGIC 0xef53 EXT4_SUPER_MAGIC 0xef53 -F2FS_SUPER_MAGIC 0xf2f52010 -FUSE_SUPER_MAGIC 0x65735546 -FUTEXFS_SUPER_MAGIC 0xbad1dea /* Unused */ +F2FS_SUPER_MAGIC 0xf2f5\[aq]2010 +FUSE_SUPER_MAGIC 0x6573\[aq]5546 +FUTEXFS_SUPER_MAGIC 0xbad\[aq]1dea /* Unused */ HFS_SUPER_MAGIC 0x4244 -HOSTFS_SUPER_MAGIC 0x00c0ffee -HPFS_SUPER_MAGIC 0xf995e849 -HUGETLBFS_MAGIC 0x958458f6 +HOSTFS_SUPER_MAGIC 0x00c0\[aq]ffee +HPFS_SUPER_MAGIC 0xf995\[aq]e849 +HUGETLBFS_MAGIC 0x9584\[aq]58f6 ISOFS_SUPER_MAGIC 0x9660 JFFS2_SUPER_MAGIC 0x72b6 -JFS_SUPER_MAGIC 0x3153464a +JFS_SUPER_MAGIC 0x3153\[aq]464a MINIX_SUPER_MAGIC 0x137f /* original minix FS */ MINIX_SUPER_MAGIC2 0x138f /* 30 char minix FS */ MINIX2_SUPER_MAGIC 0x2468 /* minix V2 FS */ MINIX2_SUPER_MAGIC2 0x2478 /* minix V2 FS, 30 char names */ MINIX3_SUPER_MAGIC 0x4d5a /* minix V3 FS, 60 char names */ -MQUEUE_MAGIC 0x19800202 /* POSIX message queue FS */ +MQUEUE_MAGIC 0x1980\[aq]0202 /* POSIX message queue FS */ MSDOS_SUPER_MAGIC 0x4d44 -MTD_INODE_FS_MAGIC 0x11307854 +MTD_INODE_FS_MAGIC 0x1130\[aq]7854 NCP_SUPER_MAGIC 0x564c NFS_SUPER_MAGIC 0x6969 NILFS_SUPER_MAGIC 0x3434 -NSFS_MAGIC 0x6e736673 -NTFS_SB_MAGIC 0x5346544e -OCFS2_SUPER_MAGIC 0x7461636f +NSFS_MAGIC 0x6e73\[aq]6673 +NTFS_SB_MAGIC 0x5346\[aq]544e +OCFS2_SUPER_MAGIC 0x7461\[aq]636f OPENPROM_SUPER_MAGIC 0x9fa1 -OVERLAYFS_SUPER_MAGIC 0x794c7630 -PIPEFS_MAGIC 0x50495045 +OVERLAYFS_SUPER_MAGIC 0x794c\[aq]7630 +PIPEFS_MAGIC 0x5049\[aq]5045 PROC_SUPER_MAGIC 0x9fa0 /* /proc FS */ -PSTOREFS_MAGIC 0x6165676c +PSTOREFS_MAGIC 0x6165\[aq]676c QNX4_SUPER_MAGIC 0x002f -QNX6_SUPER_MAGIC 0x68191122 -RAMFS_MAGIC 0x858458f6 -REISERFS_SUPER_MAGIC 0x52654973 +QNX6_SUPER_MAGIC 0x6819\[aq]1122 +RAMFS_MAGIC 0x8584\[aq]58f6 +REISERFS_SUPER_MAGIC 0x5265\[aq]4973 ROMFS_MAGIC 0x7275 -SECURITYFS_MAGIC 0x73636673 -SELINUX_MAGIC 0xf97cff8c -SMACK_MAGIC 0x43415d53 +SECURITYFS_MAGIC 0x7363\[aq]6673 +SELINUX_MAGIC 0xf97c\[aq]ff8c +SMACK_MAGIC 0x4341\[aq]5d53 SMB_SUPER_MAGIC 0x517b -SMB2_MAGIC_NUMBER 0xfe534d42 -SOCKFS_MAGIC 0x534f434b -SQUASHFS_MAGIC 0x73717368 -SYSFS_MAGIC 0x62656572 -SYSV2_SUPER_MAGIC 0x012ff7b6 -SYSV4_SUPER_MAGIC 0x012ff7b5 -TMPFS_MAGIC 0x01021994 -TRACEFS_MAGIC 0x74726163 -UDF_SUPER_MAGIC 0x15013346 -UFS_MAGIC 0x00011954 +SMB2_MAGIC_NUMBER 0xfe53\[aq]4d42 +SOCKFS_MAGIC 0x534f\[aq]434b +SQUASHFS_MAGIC 0x7371\[aq]7368 +SYSFS_MAGIC 0x6265\[aq]6572 +SYSV2_SUPER_MAGIC 0x012f\[aq]f7b6 +SYSV4_SUPER_MAGIC 0x012f\[aq]f7b5 +TMPFS_MAGIC 0x0102\[aq]1994 +TRACEFS_MAGIC 0x7472\[aq]6163 +UDF_SUPER_MAGIC 0x1501\[aq]3346 +UFS_MAGIC 0x0001\[aq]1954 USBDEVICE_SUPER_MAGIC 0x9fa2 -V9FS_MAGIC 0x01021997 -VXFS_SUPER_MAGIC 0xa501fcf5 -XENFS_SUPER_MAGIC 0xabba1974 -XENIX_SUPER_MAGIC 0x012ff7b4 -XFS_SUPER_MAGIC 0x58465342 -_XIAFS_SUPER_MAGIC 0x012fd16d /* Linux 2.0 and earlier */ +V9FS_MAGIC 0x0102\[aq]1997 +VXFS_SUPER_MAGIC 0xa501\[aq]fcf5 +XENFS_SUPER_MAGIC 0xabba\[aq]1974 +XENIX_SUPER_MAGIC 0x012f\[aq]f7b4 +XFS_SUPER_MAGIC 0x5846\[aq]5342 +_XIAFS_SUPER_MAGIC 0x012f\[aq]d16d /* Linux 2.0 and earlier */ .EE .in .PP ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (6 preceding siblings ...) 2023-02-07 20:32 ` [PATCH 07/11] man2/statfs.2: " Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix Brian Inglis ` (3 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 89 bytes --] --- man2/adjtimex.2 | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0008-man2-adjtimex.2-use-ISO-IEC-suffixes-and-digit-separ.patch --] [-- Type: text/x-patch; name="0008-man2-adjtimex.2-use-ISO-IEC-suffixes-and-digit-separ.patch", Size: 1570 bytes --] diff --git a/man2/adjtimex.2 b/man2/adjtimex.2 index df7d27cd4e5e..fe613672cd93 100644 --- a/man2/adjtimex.2 +++ b/man2/adjtimex.2 @@ -108,7 +108,7 @@ Set frequency offset from .IR buf.freq . Since Linux 2.6.26, .\" commit 074b3b87941c99bc0ce35385b5817924b1ed0c23 -the supplied value is clamped to the range (\-32768000, +32768000). +the supplied value is clamped to the range (\-32\[aq]000Ki, +32\[aq]000Ki). In older kernels, an .B EINVAL error occurs if the supplied value is out of range. @@ -471,7 +471,7 @@ does not point to writable memory. .BR EINVAL " (before Linux 2.6.26)" An attempt was made to set .I buf.freq -to a value outside the range (\-33554432, +33554432). +to a value outside the range (\-32Mi, +32Mi). .\" From a quick glance, it appears there was no clamping or range check .\" for buf.freq before Linux 2.0 .TP @@ -479,8 +479,8 @@ to a value outside the range (\-33554432, +33554432). An attempt was made to set .I buf.offset to a value outside the permitted range. -Before Linux 2.0, the permitted range was (\-131072, +131072). -From Linux 2.0 onwards, the permitted range was (\-512000, +512000). +Before Linux 2.0, the permitted range was (\-128Ki, +128Ki). +From Linux 2.0 onwards, the permitted range was (\-512k, +512k). .TP .B EINVAL An attempt was made to set @@ -505,9 +505,9 @@ for a discussion of dynamic clocks. An attempt was made to set .I buf.tick to a value outside the range -.RB 900000/ HZ +.RB 900k/ HZ to -.RB 1100000/ HZ , +.RB 1\[aq]100k/ HZ , where .B HZ is the system timer interrupt frequency. ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (7 preceding siblings ...) 2023-02-07 20:32 ` [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:32 ` [PATCH 10/11] man2/futex.2: change limit to use ISO suffix Brian Inglis ` (2 subsequent siblings) 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 77 bytes --] --- man2/getrandom.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0009-man2-getrandom.2-change-limit-to-use-IEC-suffix.patch --] [-- Type: text/x-patch; name="0009-man2-getrandom.2-change-limit-to-use-IEC-suffix.patch", Size: 427 bytes --] diff --git a/man2/getrandom.2 b/man2/getrandom.2 index e66815450b9c..24c0c0b80a6e 100644 --- a/man2/getrandom.2 +++ b/man2/getrandom.2 @@ -188,7 +188,7 @@ As of Linux 3.19 the following limits apply: .IP \(bu 3 When reading from the .I urandom -source, a maximum of 33554431 bytes is returned by a single call to +source, a maximum of 32Mi-1 bytes is returned by a single call to .BR getrandom () on systems where .I int ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 10/11] man2/futex.2: change limit to use ISO suffix 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (8 preceding siblings ...) 2023-02-07 20:32 ` [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix Brian Inglis @ 2023-02-07 20:32 ` Brian Inglis 2023-02-07 20:33 ` [PATCH 11/11] man2/: punctuate long numeric strings with digit separators Brian Inglis 2023-02-07 23:49 ` [PATCH 00/11] " Alejandro Colomar 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:32 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 73 bytes --] --- man2/futex.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0010-man2-futex.2-change-limit-to-use-ISO-suffix.patch --] [-- Type: text/x-patch; name="0010-man2-futex.2-change-limit-to-use-ISO-suffix.patch", Size: 315 bytes --] diff --git a/man2/futex.2 b/man2/futex.2 index b815056d231c..b9331ead985f 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -1536,7 +1536,7 @@ argument was invalid .RI ( tv_sec was less than zero, or .I tv_nsec -was not less than 1,000,000,000). +was not less than 1G). .TP .B EINVAL The operation specified in ^ permalink raw reply related [flat|nested] 16+ messages in thread
* [PATCH 11/11] man2/: punctuate long numeric strings with digit separators 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (9 preceding siblings ...) 2023-02-07 20:32 ` [PATCH 10/11] man2/futex.2: change limit to use ISO suffix Brian Inglis @ 2023-02-07 20:33 ` Brian Inglis 2023-02-07 23:49 ` [PATCH 00/11] " Alejandro Colomar 11 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-07 20:33 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar [-- Attachment #1: Type: text/plain, Size: 1121 bytes --] --- man2/add_key.2 | 2 +- man2/clock_getres.2 | 2 +- man2/clock_nanosleep.2 | 2 +- man2/eventfd.2 | 6 +++--- man2/execve.2 | 2 +- man2/fcntl.2 | 4 ++-- man2/getitimer.2 | 4 ++-- man2/gettimeofday.2 | 2 +- man2/ioctl.2 | 4 ++-- man2/ioctl_console.2 | 2 +- man2/ioctl_getfsmap.2 | 4 ++-- man2/ioperm.2 | 2 +- man2/kexec_load.2 | 2 +- man2/link.2 | 4 ++-- man2/msgget.2 | 2 +- man2/nanosleep.2 | 4 ++-- man2/pciconfig_read.2 | 2 +- man2/perf_event_open.2 | 2 +- man2/personality.2 | 8 ++++---- man2/prctl.2 | 2 +- man2/read.2 | 2 +- man2/semget.2 | 4 ++-- man2/sendfile.2 | 2 +- man2/shmget.2 | 2 +- man2/sigaction.2 | 4 ++-- man2/spu_run.2 | 8 ++++---- man2/statx.2 | 2 +- man2/syscall.2 | 2 +- man2/timer_settime.2 | 4 ++-- man2/timerfd_create.2 | 2 +- man2/truncate.2 | 4 ++-- man2/utimensat.2 | 6 +++--- man2/write.2 | 2 +- 33 files changed, 53 insertions(+), 53 deletions(-) [-- Warning: decoded text below may be mangled, UTF-8 assumed --] [-- Attachment #2: 0011-man2-punctuate-long-numeric-strings-with-digit-separ.patch --] [-- Type: text/x-patch; name="0011-man2-punctuate-long-numeric-strings-with-digit-separ.patch", Size: 19562 bytes --] diff --git a/man2/add_key.2 b/man2/add_key.2 index f6101cfd65e0..4e2aba755865 100644 --- a/man2/add_key.2 +++ b/man2/add_key.2 @@ -110,7 +110,7 @@ This is a general purpose key type whose payload may be read and updated by user-space applications. The key is kept entirely within kernel memory. The payload for keys of this type is a blob of arbitrary data -of up to 32,767 bytes. +of up to 32\[aq]767 bytes. .TP .IR """logon""" " (since Linux 3.3)" .\" commit 9f6ed2ca257fa8650b876377833e6f14e272848b diff --git a/man2/clock_getres.2 b/man2/clock_getres.2 index ee0fa6735865..c36081988a74 100644 --- a/man2/clock_getres.2 +++ b/man2/clock_getres.2 @@ -272,7 +272,7 @@ does not refer to a valid instance of a clock object. .I tp.tv_sec is negative or .I tp.tv_nsec -is outside the range [0, 999,999,999]. +is outside the range [0, 999\[aq]999\[aq]999]. .TP .B EINVAL The diff --git a/man2/clock_nanosleep.2 b/man2/clock_nanosleep.2 index 5da8d15699c2..13b31f53e654 100644 --- a/man2/clock_nanosleep.2 +++ b/man2/clock_nanosleep.2 @@ -158,7 +158,7 @@ The sleep was interrupted by a signal handler; see .B EINVAL The value in the .I tv_nsec -field was not in the range [0, 999999999] or +field was not in the range [0, 999\[aq]999\[aq]999] or .I tv_sec was negative. .TP diff --git a/man2/eventfd.2 b/man2/eventfd.2 index 0a7729868dc6..a7994c99f66d 100644 --- a/man2/eventfd.2 +++ b/man2/eventfd.2 @@ -124,7 +124,7 @@ A call adds the 8-byte integer value supplied in its buffer to the counter. The maximum value that may be stored in the counter is the largest -unsigned 64-bit value minus 1 (i.e., 0xfffffffffffffffe). +unsigned 64-bit value minus 1 (i.e., 0xffff\[aq]ffff\[aq]ffff\[aq]fffe). If the addition would cause the counter's value to exceed the maximum, then the .BR write (2) @@ -140,7 +140,7 @@ A fails with the error .B EINVAL if the size of the supplied buffer is less than 8 bytes, -or if an attempt is made to write the value 0xffffffffffffffff. +or if an attempt is made to write the value 0xffff\[aq]ffff\[aq]ffff\[aq]ffff. .TP .BR poll "(2), " select "(2) (and similar)" The returned file descriptor supports @@ -190,7 +190,7 @@ If an overflow has occurred, then .BR read (2) will return that maximum .I uint64_t -value (i.e., 0xffffffffffffffff). +value (i.e., 0xffff\[aq]ffff\[aq]ffff\[aq]ffff). .RE .IP The eventfd file descriptor also supports the other file-descriptor diff --git a/man2/execve.2 b/man2/execve.2 index fd8ebea88658..54a1229f0520 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -429,7 +429,7 @@ environment space as was provided by Linux 2.6.22 and earlier. (This guarantee was not provided in Linux 2.6.23 and 2.6.24.) Additionally, the limit per string is 32 pages (the kernel constant .BR MAX_ARG_STRLEN ), -and the maximum number of strings is 0x7FFFFFFF. +and the maximum number of strings is 0x7fff\[aq]ffff. .SH RETURN VALUE On success, .BR execve () diff --git a/man2/fcntl.2 b/man2/fcntl.2 index 228bba5ec71c..6290794c9292 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -1833,13 +1833,13 @@ are specified in POSIX.1-2001. .B _XOPEN_SOURCE with the value 500 or greater, or .B _POSIX_C_SOURCE -with the value 200809L or greater.) +with the value 2008\[aq]09L or greater.) .PP .B F_DUPFD_CLOEXEC is specified in POSIX.1-2008. (To get this definition, define .B _POSIX_C_SOURCE -with the value 200809L or greater, or +with the value 2008\[aq]09L or greater, or .B _XOPEN_SOURCE with the value 700 or greater.) .PP diff --git a/man2/getitimer.2 b/man2/getitimer.2 index 80745dd78c99..8b57e2b118e0 100644 --- a/man2/getitimer.2 +++ b/man2/getitimer.2 @@ -158,7 +158,7 @@ or (since Linux 2.6.22) one of the .I tv_usec fields in the structure pointed to by .I new_value -contains a value outside the range [0, 999999]. +contains a value outside the range [0, 999\[aq]999]. .SH STANDARDS POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD). POSIX.1-2008 marks @@ -253,7 +253,7 @@ POSIX.1-2001 says that .BR setitimer () should fail if a .I tv_usec -value is specified that is outside of the range [0, 999999]. +value is specified that is outside of the range [0, 999\[aq]999]. However, up to and including Linux 2.6.21, Linux does not give an error, but instead silently adjusts the corresponding seconds value for the timer. diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index d7219f9d42a4..10b6220a90c1 100644 --- a/man2/gettimeofday.2 +++ b/man2/gettimeofday.2 @@ -152,7 +152,7 @@ is invalid. .I tv.tv_sec is negative or .I tv.tv_usec -is outside the range [0, 999999]. +is outside the range [0, 999\[aq]999]. .TP .BR EINVAL " (since Linux 4.3)" .\" commit e1d7ba8735551ed79c7a0463a042353574b96da3 diff --git a/man2/ioctl.2 b/man2/ioctl.2 index ed3ec1480278..a497b8669329 100644 --- a/man2/ioctl.2 +++ b/man2/ioctl.2 @@ -134,9 +134,9 @@ one or more ASCII letters were used. For example, .B TCGETS has value -0x00005401, with 0x54 = \(aqT\(aq indicating the terminal driver, and +0x00\[aq]00\[aq]54\[aq]01, with 0x54 = \(aqT\(aq indicating the terminal driver, and .B CYGETTIMEOUT -has value 0x00435906, with 0x43 0x59 = \(aqC\(aq \(aqY\(aq +has value 0x00\[aq]43\[aq]59\[aq]06, with 0x43 0x59 = \(aqC\(aq \(aqY\(aq indicating the cyclades driver. .PP Later (0.98p5) some more information was built into the number. diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2 index 89f794c1956c..ddf3fa424235 100644 --- a/man2/ioctl_console.2 +++ b/man2/ioctl_console.2 @@ -143,7 +143,7 @@ The lower 16 bits of specify the period in clock cycles (that is, .I argp -= 1193180/frequency). += 1\[aq]193\[aq]180/frequency). .I argp = 0 turns sound off. In either case, control returns immediately. diff --git a/man2/ioctl_getfsmap.2 b/man2/ioctl_getfsmap.2 index 36d284d452a4..4a2d00979d04 100644 --- a/man2/ioctl_getfsmap.2 +++ b/man2/ioctl_getfsmap.2 @@ -112,9 +112,9 @@ A filesystem that can share blocks between files likely requires the tuple to uniquely index any filesystem mapping record. Classic non-sharing filesystems might be able to identify any record with only .RI "(" "device" ", " "physical" ", " "flags" ")." -For example, if the low key is set to (8:0, 36864, 0, 0, 0), the filesystem will +For example, if the low key is set to (8:0, 36\[aq]864, 0, 0, 0), the filesystem will only return records for extents starting at or above 36\ KiB on disk. -If the high key is set to (8:0, 1048576, 0, 0, 0), +If the high key is set to (8:0, 1\[aq]048\[aq]576, 0, 0, 0), only records below 1\ MiB will be returned. The format of .I fmr_device diff --git a/man2/ioperm.2 b/man2/ioperm.2 index 1b07ab1c059e..7b3a55af65d7 100644 --- a/man2/ioperm.2 +++ b/man2/ioperm.2 @@ -46,7 +46,7 @@ For more ports, the system call had to be used (with a .I level argument of 3). -Since Linux 2.6.8, 65,536 I/O ports can be specified. +Since Linux 2.6.8, 65\[aq]536 I/O ports can be specified. .PP Permissions are inherited by the child created by .BR fork (2) diff --git a/man2/kexec_load.2 b/man2/kexec_load.2 index b0cfb936543e..097254f9b43b 100644 --- a/man2/kexec_load.2 +++ b/man2/kexec_load.2 @@ -67,7 +67,7 @@ and is effective only if .I nr_segments is greater than 0. .PP -The high-order bits (corresponding to the mask 0xffff0000) of +The high-order bits (corresponding to the mask 0xffff\[aq]0000) of .I flags contain the architecture of the to-be-executed kernel. Specify (OR) the constant diff --git a/man2/link.2 b/man2/link.2 index e00c8e307904..719cc77a9e75 100644 --- a/man2/link.2 +++ b/man2/link.2 @@ -204,9 +204,9 @@ For example, on an .BR ext4 (5) filesystem that does not employ the .I dir_index -feature, the limit on the number of hard links to a file is 65,000; on +feature, the limit on the number of hard links to a file is 65\[aq]000; on .BR btrfs (5), -the limit is 65,535 links. +the limit is 65\[aq]535 links. .TP .B ENAMETOOLONG .IR oldpath " or " newpath " was too long." diff --git a/man2/msgget.2 b/man2/msgget.2 index 4a03f665f4fe..8ae42da079de 100644 --- a/man2/msgget.2 +++ b/man2/msgget.2 @@ -190,7 +190,7 @@ Before Linux 3.19, .\" commit 0050ee059f7fc86b1df2527aaa14ed5dc72f9973 the default value for this limit was calculated using a formula based on available system memory. -Since Linux 3.19, the default value is 32,000. +Since Linux 3.19, the default value is 32\[aq]000. On Linux, this limit can be read and modified via .IR /proc/sys/kernel/msgmni . .SS Linux notes diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index 12e0cee84b85..574b2bdd04aa 100644 --- a/man2/nanosleep.2 +++ b/man2/nanosleep.2 @@ -66,7 +66,7 @@ The structure is used to specify intervals of time with nanosecond precision. .PP -The value of the nanoseconds field must be in the range [0, 999999999]. +The value of the nanoseconds field must be in the range [0, 999\[aq]999\[aq]999]. .PP Compared to .BR sleep (3) @@ -106,7 +106,7 @@ again and continue with the pause. .B EINVAL The value in the .I tv_nsec -field was not in the range [0, 999999999] or +field was not in the range [0, 999\[aq]999\[aq]999] or .I tv_sec was negative. .SH STANDARDS diff --git a/man2/pciconfig_read.2 b/man2/pciconfig_read.2 index 64de37f53b67..e89606b9a8f1 100644 --- a/man2/pciconfig_read.2 +++ b/man2/pciconfig_read.2 @@ -50,7 +50,7 @@ value. .TP .BR pciconfig_iobase () You pass it a bus/devfn pair and get a physical address for either the -memory offset (for things like prep, this is 0xc0000000), +memory offset (for things like prep, this is 0xc000\[aq]0000), the IO base for PIO cycles, or the ISA holes if any. .SH RETURN VALUE .TP diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index 8e94fb4ac61b..f0474e993c01 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -3364,7 +3364,7 @@ Setting this too high can allow users to sample at a rate that impacts overall machine performance and potentially lock up the machine. The default value is -100000 (samples per second). +100\[aq]000 (samples per second). .TP .I /proc/sys/kernel/perf_event_max_stack .\" Introduced in c5dfd78eb79851e278b7973031b9ca363da87a7e diff --git a/man2/personality.2 b/man2/personality.2 index 4be1b97f5da6..fb9659d7fe54 100644 --- a/man2/personality.2 +++ b/man2/personality.2 @@ -34,13 +34,13 @@ UNIX-like operating systems. If .I persona is not -0xffffffff, then +0xffff\[aq]ffff, then .BR personality () sets the caller's execution domain to the value specified by .IR persona . Specifying .I persona -as 0xffffffff provides a way of retrieving +as 0xffff\[aq]ffff provides a way of retrieving the current persona without changing it. .PP A list of the available execution domains can be found in @@ -63,10 +63,10 @@ With this flag set, disable address-space-layout randomization. Limit the address space to 32 bits. .TP .BR ADDR_LIMIT_3GB " (since Linux 2.4.0)" -With this flag set, use 0xc0000000 as the offset at which to search +With this flag set, use 0xc000\[aq]0000 as the offset at which to search a virtual memory chunk on .BR mmap (2); -otherwise use 0xffffe000. +otherwise use 0xffff\[aq]e000. .TP .BR FDPIC_FUNCPTRS " (since Linux 2.6.11)" User-space function pointers to signal handlers point diff --git a/man2/prctl.2 b/man2/prctl.2 index 368436bad4cd..6220cb5d4c68 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -1932,7 +1932,7 @@ The "default" value can't be changed. The timer slack values of .I init (PID 1), the ancestor of all processes, -are 50,000 nanoseconds (50 microseconds). +are 50\[aq]000 nanoseconds (50 microseconds). The timer slack value is inherited by a child created via .BR fork (2), and is preserved across diff --git a/man2/read.2 b/man2/read.2 index 13f999e7ba1b..903db69afaa5 100644 --- a/man2/read.2 +++ b/man2/read.2 @@ -176,7 +176,7 @@ unsigned and signed integer data types specified by POSIX.1. On Linux, .BR read () (and similar system calls) will transfer at most -0x7ffff000 (2,147,479,552) bytes, +0x7fff\[aq]f000 (2\[aq]147\[aq]479\[aq]552) bytes, returning the number of bytes actually transferred. .\" commit e28cc71572da38a5a12c1cfe4d7032017adccf69 (This is true on both 32-bit and 64-bit systems.) diff --git a/man2/semget.2 b/man2/semget.2 index a15b472a99f5..d3c994ad7cc2 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -249,7 +249,7 @@ Before Linux 3.19, the default value for this limit was 128. Since Linux 3.19, .\" commit e843e7d2c88b7db107a86bd2c7145dc715c058f4 -the default value is 32,000. +the default value is 32\[aq]000. On Linux, this limit can be read and modified via the fourth field of .IR /proc/sys/kernel/sem . .\" This /proc file is not available in Linux 2.2 and earlier -- MTK @@ -260,7 +260,7 @@ Before Linux 3.19, the default value for this limit was 250. Since Linux 3.19, .\" commit e843e7d2c88b7db107a86bd2c7145dc715c058f4 -the default value is 32,000. +the default value is 32\[aq]000. On Linux, this limit can be read and modified via the first field of .IR /proc/sys/kernel/sem . .TP diff --git a/man2/sendfile.2 b/man2/sendfile.2 index 07a2c5b35dd0..302e1905f3c7 100644 --- a/man2/sendfile.2 +++ b/man2/sendfile.2 @@ -179,7 +179,7 @@ with different semantics and prototypes. It should not be used in portable programs. .SH NOTES .BR sendfile () -will transfer at most 0x7ffff000 (2,147,479,552) bytes, +will transfer at most 0x7fff\[aq]f000 (2\[aq]147\[aq]479\[aq]552) bytes, returning the number of bytes actually transferred. .\" commit e28cc71572da38a5a12c1cfe4d7032017adccf69 (This is true on both 32-bit and 64-bit systems.) diff --git a/man2/shmget.2 b/man2/shmget.2 index 4bc18bedf3a9..bdc96433c35d 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -354,7 +354,7 @@ for a discussion of why this default value (rather than is used. .IP From Linux 2.2 up to Linux 3.15, the default value of -this limit was 0x2000000 (32\ MiB). +this limit was 0x200\[aq]0000 (32\ MiB). .IP Because it is not possible to map just part of a shared memory segment, the amount of virtual memory places another limit on the maximum size of a diff --git a/man2/sigaction.2 b/man2/sigaction.2 index dfb94fe4fb3f..e4592a883be2 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -52,7 +52,7 @@ Feature Test Macro Requirements for glibc (see .PP .IR siginfo_t : .nf - _POSIX_C_SOURCE >= 199309L + _POSIX_C_SOURCE >= 1993\[aq]09L .fi .SH DESCRIPTION The @@ -623,7 +623,7 @@ and or .IP \(bu .B _POSIX_C_SOURCE -with the value 200809L or greater. +with the value 2008\[aq]09L or greater. .PP For the .B TRAP_* diff --git a/man2/spu_run.2 b/man2/spu_run.2 index 139f10a97a80..f8c23e43eccd 100644 --- a/man2/spu_run.2 +++ b/man2/spu_run.2 @@ -136,7 +136,7 @@ SPU has tried to execute an invalid instruction. .B 0x40 SPU has tried to access an invalid channel. .TP -.B 0x3fff0000 +.B 0x3fff\[aq]0000 The bits masked with this value contain the code returned from a .B stop-and-signal instruction. @@ -245,9 +245,9 @@ int main(void) err(EXIT_FAILURE, "open"); /* - * We should see a status code of 0x12340002: - * 0x00000002 (spu was stopped due to stop\-and\-signal) - * | 0x12340000 (the stop\-and\-signal code) + * We should see a status code of 0x1234\[aq]0002: + * 0x0000\[aq]0002 (spu was stopped due to stop\-and\-signal) + * | 0x1234\[aq]0000 (the stop\-and\-signal code) */ printf("SPU Status: %#08x\en", spu_status); diff --git a/man2/statx.2 b/man2/statx.2 index 1942672ae004..f621e7371145 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -559,7 +559,7 @@ Reserved flag specified in .IR mask . (Currently, there is one such flag, designated by the constant .BR STATX__RESERVED , -with the value 0x80000000U.) +with the value 0x8000\[aq]0000U.) .TP .B ELOOP Too many symbolic links encountered while traversing the pathname. diff --git a/man2/syscall.2 b/man2/syscall.2 index a66338d59af2..81d830b1a918 100644 --- a/man2/syscall.2 +++ b/man2/syscall.2 @@ -176,7 +176,7 @@ arm/EABI swi 0x0 r7 r0 r1 - arm64 svc #0 w8 x0 x1 - blackfin excpt 0x0 P0 R0 - - i386 int $0x80 eax eax edx - -ia64 break 0x100000 r15 r8 r9 r10 1, 6 +ia64 break 0x10\[aq]0000 r15 r8 r9 r10 1, 6 loongarch syscall 0 a7 a0 - - m68k trap #0 d0 d0 - - microblaze brki r14,8 r12 r3 - - diff --git a/man2/timer_settime.2 b/man2/timer_settime.2 index 29d9ed4d27be..c1d1ff469231 100644 --- a/man2/timer_settime.2 +++ b/man2/timer_settime.2 @@ -28,7 +28,7 @@ Feature Test Macro Requirements for glibc (see .BR timer_settime (), .BR timer_gettime (): .nf - _POSIX_C_SOURCE >= 199309L + _POSIX_C_SOURCE >= 1993\[aq]09L .fi .SH DESCRIPTION .BR timer_settime () @@ -171,7 +171,7 @@ may fail with the following errors: .I new_value.it_value is negative; or .I new_value.it_value.tv_nsec -is negative or greater than 999,999,999. +is negative or greater than 999\[aq]999\[aq]999. .SH VERSIONS These system calls are available since Linux 2.6. .SH STANDARDS diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2 index 5ccc165a3673..e72a10e7c685 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -461,7 +461,7 @@ See NOTES. .I new_value is not properly initialized (one of the .I tv_nsec -falls outside the range zero to 999,999,999). +falls outside the range zero to 999\[aq]999\[aq]999). .TP .B EINVAL .\" This case only checked since Linux 2.6.29, and Linux 2.2.2[78].some-stable-version. diff --git a/man2/truncate.2 b/man2/truncate.2 index bec1a575638a..6365f97eef98 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -125,7 +125,7 @@ Too many symbolic links were encountered in translating the pathname. .TP .B ENAMETOOLONG A component of a pathname exceeded 255 characters, -or an entire pathname exceeded 1023 characters. +or an entire pathname exceeded 1\[aq]023 characters. .TP .B ENOENT The named file does not exist. @@ -240,7 +240,7 @@ A header file bug in glibc 2.12 meant that the minimum value of .B _POSIX_C_SOURCE required to expose the declaration of .BR ftruncate () -was 200809L instead of 200112L. +was 2008\[aq]09L instead of 2001\[aq]12L. This has been fixed in later glibc versions. .SH SEE ALSO .BR truncate (1), diff --git a/man2/utimensat.2 b/man2/utimensat.2 index 1d9206ed0ced..179a09a9ec9d 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -28,7 +28,7 @@ Feature Test Macro Requirements for glibc (see .BR utimensat (): .nf Since glibc 2.10: - _POSIX_C_SOURCE >= 200809L + _POSIX_C_SOURCE >= 2008\[aq]09L Before glibc 2.10: _ATFILE_SOURCE .fi @@ -36,7 +36,7 @@ Feature Test Macro Requirements for glibc (see .BR futimens (): .nf Since glibc 2.10: - _POSIX_C_SOURCE >= 200809L + _POSIX_C_SOURCE >= 2008\[aq]09L Before glibc 2.10: _GNU_SOURCE .fi @@ -272,7 +272,7 @@ Invalid value in .B EINVAL Invalid value in one of the .I tv_nsec -fields (value outside range [0, 999999999], and not +fields (value outside range [0, 999\[aq]999\[aq]999], and not .B UTIME_NOW or .BR UTIME_OMIT ); diff --git a/man2/write.2 b/man2/write.2 index 9f4a814b6ad5..22018bdef278 100644 --- a/man2/write.2 +++ b/man2/write.2 @@ -268,7 +268,7 @@ the call succeeds, and returns the number of bytes written. On Linux, .BR write () (and similar system calls) will transfer at most -0x7ffff000 (2,147,479,552) bytes, +0x7fff\[aq]f000 (2\[aq]147\[aq]479\[aq]552) bytes, returning the number of bytes actually transferred. .\" commit e28cc71572da38a5a12c1cfe4d7032017adccf69 (This is true on both 32-bit and 64-bit systems.) ^ permalink raw reply related [flat|nested] 16+ messages in thread
* Re: [PATCH 00/11] man2/: punctuate long numeric strings with digit separators 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis ` (10 preceding siblings ...) 2023-02-07 20:33 ` [PATCH 11/11] man2/: punctuate long numeric strings with digit separators Brian Inglis @ 2023-02-07 23:49 ` Alejandro Colomar 2023-02-08 4:54 ` Brian Inglis 11 siblings, 1 reply; 16+ messages in thread From: Alejandro Colomar @ 2023-02-07 23:49 UTC (permalink / raw) To: Brian Inglis, Linux Man-Pages [-- Attachment #1.1: Type: text/plain, Size: 3663 bytes --] Hi Brian, On 2/7/23 21:32, Brian Inglis wrote: > man2/: use C digit separators with \\[aq] to show "'" or ISO/IEC > suffixes to clarify long binary, octal, hex, decimal numeric strings; > use consistent interval notation for value ranges; > fix minor discrepancies. > > [PATCH 01/11] man2/shmget.2: fix limit units suffix from SI to IEC > [PATCH 02/11] man2/spu_run.2: fix example comment status code or-ed > [PATCH 03/11] man2/: use consistent interval notation for value > [PATCH 04/11] man2/open.2: punctuate octal perms with digit > [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal > [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit > [PATCH 07/11] man2/statfs.2: punctuate hex in docs with digit > [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit > [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix > [PATCH 10/11] man2/futex.2: change limit to use ISO suffix > [PATCH 11/11] man2/: punctuate long numeric strings with digit I received patches [1, 4] in inline format, and then received again the entire patch set as emails with attachments. I'm a bit confused about which are the correct ones. Are they the same? Please resend all inline if possible, and put a patch version number (v3 already?). Cheers, Alex > > Brian Inglis (11): > man2/shmget.2: fix limit units suffix from SI to IEC > man2/spu_run.2: fix example comment status code or-ed value > man2/: use consistent interval notation for value ranges > man2/open.2: punctuate octal perms with digit separators > man2/reboot.2: show BCD dates in hex not decimal > man2/reboot.2: punctuate hex in docs with digit separators > man2/statfs.2: punctuate hex in docs with digit separators > man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges > and example docs > man2/getrandom.2: change limit to use IEC suffix > man2/futex.2: change limit to use ISO suffix > man2/: punctuate long numeric strings with digit separators > > man2/add_key.2 | 2 +- > man2/adjtimex.2 | 12 ++--- > man2/clock_getres.2 | 2 +- > man2/clock_nanosleep.2 | 2 +- > man2/eventfd.2 | 6 +-- > man2/execve.2 | 2 +- > man2/fcntl.2 | 4 +- > man2/futex.2 | 2 +- > man2/getitimer.2 | 4 +- > man2/getrandom.2 | 2 +- > man2/gettimeofday.2 | 2 +- > man2/ioctl.2 | 4 +- > man2/ioctl_console.2 | 2 +- > man2/ioctl_getfsmap.2 | 4 +- > man2/ioperm.2 | 2 +- > man2/kexec_load.2 | 2 +- > man2/link.2 | 4 +- > man2/msgget.2 | 2 +- > man2/nanosleep.2 | 4 +- > man2/open.2 | 32 ++++++------ > man2/pciconfig_read.2 | 2 +- > man2/perf_event_open.2 | 2 +- > man2/personality.2 | 8 +-- > man2/prctl.2 | 2 +- > man2/read.2 | 2 +- > man2/reboot.2 | 24 ++++----- > man2/semget.2 | 4 +- > man2/sendfile.2 | 2 +- > man2/shmget.2 | 2 +- > man2/sigaction.2 | 4 +- > man2/spu_run.2 | 8 +-- > man2/statfs.2 | 110 ++++++++++++++++++++--------------------- > man2/statx.2 | 2 +- > man2/syscall.2 | 2 +- > man2/timer_settime.2 | 4 +- > man2/timerfd_create.2 | 2 +- > man2/truncate.2 | 4 +- > man2/utimensat.2 | 6 +-- > man2/write.2 | 2 +- > 39 files changed, 144 insertions(+), 144 deletions(-) > -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 00/11] man2/: punctuate long numeric strings with digit separators 2023-02-07 23:49 ` [PATCH 00/11] " Alejandro Colomar @ 2023-02-08 4:54 ` Brian Inglis 2023-02-08 11:27 ` Alejandro Colomar 0 siblings, 1 reply; 16+ messages in thread From: Brian Inglis @ 2023-02-08 4:54 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar Hi Alex, The problem was /etc/gitconfig [format] attach which is not invertible or overridable, expect perhaps with command line --inline: probably requested by some other project. All patches 1-11 have identical content; MIME content-disposition is the issue; as is setting parameters to allow a single successful series of sends via my ISP milter provider that considers patch series as just more email spam. I will retry format-patch with -v2 --inline and send-email with longer delays. -- Take care. Thanks, Brian Inglis Calgary, Alberta, Canada La perfection est atteinte Perfection is achieved non pas lorsqu'il n'y a plus rien à ajouter not when there is no more to add mais lorsqu'il n'y a plus rien à retirer but when there is no more to cut -- Antoine de Saint-Exupéry On 2023-02-07 16:49, Alejandro Colomar wrote: > Hi Brian, > > On 2/7/23 21:32, Brian Inglis wrote: >> man2/: use C digit separators with \\[aq] to show "'" or ISO/IEC >> suffixes to clarify long binary, octal, hex, decimal numeric strings; >> use consistent interval notation for value ranges; >> fix minor discrepancies. >> >> [PATCH 01/11] man2/shmget.2: fix limit units suffix from SI to IEC >> [PATCH 02/11] man2/spu_run.2: fix example comment status code or-ed >> [PATCH 03/11] man2/: use consistent interval notation for value >> [PATCH 04/11] man2/open.2: punctuate octal perms with digit >> [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal >> [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit >> [PATCH 07/11] man2/statfs.2: punctuate hex in docs with digit >> [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit >> [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix >> [PATCH 10/11] man2/futex.2: change limit to use ISO suffix >> [PATCH 11/11] man2/: punctuate long numeric strings with digit > > I received patches [1, 4] in inline format, and then received again the entire patch set as emails with attachments. I'm a bit confused about which are the correct ones. Are they the same? Please resend all inline if possible, and put a patch version number (v3 already?). > > Cheers, > > Alex >> >> Brian Inglis (11): >> man2/shmget.2: fix limit units suffix from SI to IEC >> man2/spu_run.2: fix example comment status code or-ed value >> man2/: use consistent interval notation for value ranges >> man2/open.2: punctuate octal perms with digit separators >> man2/reboot.2: show BCD dates in hex not decimal >> man2/reboot.2: punctuate hex in docs with digit separators >> man2/statfs.2: punctuate hex in docs with digit separators >> man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges >> and example docs >> man2/getrandom.2: change limit to use IEC suffix >> man2/futex.2: change limit to use ISO suffix >> man2/: punctuate long numeric strings with digit separators >> >> man2/add_key.2 | 2 +- >> man2/adjtimex.2 | 12 ++--- >> man2/clock_getres.2 | 2 +- >> man2/clock_nanosleep.2 | 2 +- >> man2/eventfd.2 | 6 +-- >> man2/execve.2 | 2 +- >> man2/fcntl.2 | 4 +- >> man2/futex.2 | 2 +- >> man2/getitimer.2 | 4 +- >> man2/getrandom.2 | 2 +- >> man2/gettimeofday.2 | 2 +- >> man2/ioctl.2 | 4 +- >> man2/ioctl_console.2 | 2 +- >> man2/ioctl_getfsmap.2 | 4 +- >> man2/ioperm.2 | 2 +- >> man2/kexec_load.2 | 2 +- >> man2/link.2 | 4 +- >> man2/msgget.2 | 2 +- >> man2/nanosleep.2 | 4 +- >> man2/open.2 | 32 ++++++------ >> man2/pciconfig_read.2 | 2 +- >> man2/perf_event_open.2 | 2 +- >> man2/personality.2 | 8 +-- >> man2/prctl.2 | 2 +- >> man2/read.2 | 2 +- >> man2/reboot.2 | 24 ++++----- >> man2/semget.2 | 4 +- >> man2/sendfile.2 | 2 +- >> man2/shmget.2 | 2 +- >> man2/sigaction.2 | 4 +- >> man2/spu_run.2 | 8 +-- >> man2/statfs.2 | 110 ++++++++++++++++++++--------------------- >> man2/statx.2 | 2 +- >> man2/syscall.2 | 2 +- >> man2/timer_settime.2 | 4 +- >> man2/timerfd_create.2 | 2 +- >> man2/truncate.2 | 4 +- >> man2/utimensat.2 | 6 +-- >> man2/write.2 | 2 +- >> 39 files changed, 144 insertions(+), 144 deletions(-) ^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 00/11] man2/: punctuate long numeric strings with digit separators 2023-02-08 4:54 ` Brian Inglis @ 2023-02-08 11:27 ` Alejandro Colomar 0 siblings, 0 replies; 16+ messages in thread From: Alejandro Colomar @ 2023-02-08 11:27 UTC (permalink / raw) To: Brian.Inglis, Linux Man-Pages [-- Attachment #1.1: Type: text/plain, Size: 1530 bytes --] Hi Brian, On 2/8/23 05:54, Brian Inglis wrote: > Hi Alex, > > The problem was /etc/gitconfig [format] attach which is not invertible or > overridable, expect perhaps with command line --inline: probably requested by > some other project. I never tried, but documentation says it's overridable: --attach[=<boundary>] Create multipart/mixed attachment, the first part of which is the commit message and the patch itself in the second part, with Content-Disposition: attachment. --no-attach Disable the creation of an attachment, overriding the configuration setting. Then there's --inline[=<boundary>] Create multipart/mixed attachment, the first part of which is the commit message and the patch itself in the second part, with Content-Disposition: inline. but I'm not sure that's what I want. Never tried. Anyway, you can try any of both, and we'll see what arrives :) > > All patches 1-11 have identical content; MIME content-disposition is the issue; > as is setting parameters to allow a single successful series of sends via my ISP > milter provider that considers patch series as just more email spam. No worries; I understand ;) > > I will retry format-patch with -v2 --inline and send-email with longer delays. Okay, thanks. Cheers, Alex > -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 [-- Attachment #2: OpenPGP digital signature --] [-- Type: application/pgp-signature, Size: 833 bytes --] ^ permalink raw reply [flat|nested] 16+ messages in thread
* [PATCH 00/11] man2/: punctuate long numeric strings with digit separators @ 2023-02-05 22:59 Brian Inglis 0 siblings, 0 replies; 16+ messages in thread From: Brian Inglis @ 2023-02-05 22:59 UTC (permalink / raw) To: Linux Man-Pages; +Cc: Alejandro Colomar man2/: use C digit separators with \\[aq] to show "'" or ISO/IEC suffixes to clarify long binary, octal, hex, decimal numeric strings; use consistent interval notation for value ranges; fix minor discrepancies. Brian Inglis (11): man2/shmget.2: fix limit units suffix from SI to IEC man2/spu_run.2: fix example comment status code or-ed value man2/: use consistent interval notation for value ranges man2/open.2: punctuate octal perms with digit separators man2/reboot.2: show BCD dates in hex not decimal man2/reboot.2: punctuate hex in docs with digit separators man2/statfs.2: punctuate hex in docs with digit separators man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs man2/getrandom.2: change limit to use IEC suffix man2/futex.2: change limit to use ISO suffix man2/: punctuate long numeric strings with digit separators man2/add_key.2 | 2 +- man2/adjtimex.2 | 12 ++--- man2/clock_getres.2 | 2 +- man2/clock_nanosleep.2 | 2 +- man2/eventfd.2 | 6 +-- man2/execve.2 | 2 +- man2/fcntl.2 | 4 +- man2/futex.2 | 2 +- man2/getitimer.2 | 4 +- man2/getrandom.2 | 2 +- man2/gettimeofday.2 | 2 +- man2/ioctl.2 | 4 +- man2/ioctl_console.2 | 2 +- man2/ioctl_getfsmap.2 | 4 +- man2/ioperm.2 | 2 +- man2/kexec_load.2 | 2 +- man2/link.2 | 4 +- man2/msgget.2 | 2 +- man2/nanosleep.2 | 4 +- man2/open.2 | 32 ++++++------ man2/pciconfig_read.2 | 2 +- man2/perf_event_open.2 | 2 +- man2/personality.2 | 8 +-- man2/prctl.2 | 2 +- man2/read.2 | 2 +- man2/reboot.2 | 24 ++++----- man2/semget.2 | 4 +- man2/sendfile.2 | 2 +- man2/shmget.2 | 2 +- man2/sigaction.2 | 4 +- man2/spu_run.2 | 8 +-- man2/statfs.2 | 110 ++++++++++++++++++++--------------------- man2/statx.2 | 2 +- man2/syscall.2 | 2 +- man2/timer_settime.2 | 4 +- man2/timerfd_create.2 | 2 +- man2/truncate.2 | 4 +- man2/utimensat.2 | 6 +-- man2/write.2 | 2 +- 39 files changed, 144 insertions(+), 144 deletions(-) -- 2.39.0 ^ permalink raw reply [flat|nested] 16+ messages in thread
end of thread, other threads:[~2023-02-08 11:27 UTC | newest] Thread overview: 16+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2023-02-07 20:32 [PATCH 00/11] man2/: punctuate long numeric strings with digit separators Brian Inglis 2023-02-07 20:32 ` [PATCH 01/11] man2/shmget.2: fix limit units suffix from SI to IEC Brian Inglis 2023-02-07 20:32 ` [PATCH 02/11] man2/spu_run.2: fix example comment status code or-ed value Brian Inglis 2023-02-07 20:32 ` [PATCH 03/11] man2/: use consistent interval notation for value ranges Brian Inglis 2023-02-07 20:32 ` [PATCH 04/11] man2/open.2: punctuate octal perms with digit separators Brian Inglis 2023-02-07 20:32 ` [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal Brian Inglis 2023-02-07 20:32 ` [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit separators Brian Inglis 2023-02-07 20:32 ` [PATCH 07/11] man2/statfs.2: " Brian Inglis 2023-02-07 20:32 ` [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs Brian Inglis 2023-02-07 20:32 ` [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix Brian Inglis 2023-02-07 20:32 ` [PATCH 10/11] man2/futex.2: change limit to use ISO suffix Brian Inglis 2023-02-07 20:33 ` [PATCH 11/11] man2/: punctuate long numeric strings with digit separators Brian Inglis 2023-02-07 23:49 ` [PATCH 00/11] " Alejandro Colomar 2023-02-08 4:54 ` Brian Inglis 2023-02-08 11:27 ` Alejandro Colomar -- strict thread matches above, loose matches on Subject: below -- 2023-02-05 22:59 Brian Inglis
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.