* [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit separators
2023-02-05 23:58 [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal Brian Inglis
@ 2023-02-05 23:58 ` Brian Inglis
2023-02-05 23:58 ` [PATCH 07/11] man2/statfs.2: " Brian Inglis
` (2 subsequent siblings)
3 siblings, 0 replies; 6+ messages in thread
From: Brian Inglis @ 2023-02-05 23:58 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] 6+ messages in thread* [PATCH 07/11] man2/statfs.2: punctuate hex in docs with digit separators
2023-02-05 23:58 [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal Brian Inglis
2023-02-05 23:58 ` [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit separators Brian Inglis
@ 2023-02-05 23:58 ` Brian Inglis
2023-02-05 23:58 ` [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs Brian Inglis
2023-02-05 23:58 ` [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix Brian Inglis
3 siblings, 0 replies; 6+ messages in thread
From: Brian Inglis @ 2023-02-05 23:58 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] 6+ messages in thread* [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs
2023-02-05 23:58 [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal Brian Inglis
2023-02-05 23:58 ` [PATCH 06/11] man2/reboot.2: punctuate hex in docs with digit separators Brian Inglis
2023-02-05 23:58 ` [PATCH 07/11] man2/statfs.2: " Brian Inglis
@ 2023-02-05 23:58 ` Brian Inglis
2023-02-05 23:58 ` [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix Brian Inglis
3 siblings, 0 replies; 6+ messages in thread
From: Brian Inglis @ 2023-02-05 23:58 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] 6+ messages in thread
* [PATCH 09/11] man2/getrandom.2: change limit to use IEC suffix
2023-02-05 23:58 [PATCH 05/11] man2/reboot.2: show BCD dates in hex not decimal Brian Inglis
` (2 preceding siblings ...)
2023-02-05 23:58 ` [PATCH 08/11] man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs Brian Inglis
@ 2023-02-05 23:58 ` Brian Inglis
3 siblings, 0 replies; 6+ messages in thread
From: Brian Inglis @ 2023-02-05 23:58 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] 6+ messages in thread