Manual pages: blockdev.8: Minor wording and formatting fixes
PATCH 1/12 Manual pages: blockdev.8: Minor wording and formatting fixes
--- disk-utils/blockdev.8 | 28 ++++++++++++++++++++-------- 1 file changed, 20 insertions(+), 8 deletions(-)
disk-utils/blockdev.8 +20 -8
@@ -31,7 +31,9 @@ Be quiet. Be verbose. .IP "\fB\-\-report\fP" Print a report for the specified device. It is possible to give multiple -devices. If none is given, all devices which appear in /proc/partitions are +devices. If none is given, all devices which appear in +.I /proc/partitions +are shown. Note that the partition StartSec is in 512-byte sectors. .IP "\fB\-h\fR, \fB\-\-help\fR" Display help text and exit.
@@ -44,8 +46,9 @@ Flush buffers. .IP "\fB\-\-getalignoff\fP" Get alignment offset. .IP "\fB\-\-getbsz\fP" -Print blocksize in bytes. This size does not describe device topology. It's -size used internally by kernel and it maybe modified (for example) by +Print the blocksize in bytes. +This size does not describe device topology. It's +the size used internally by ithe kernel and it may be modified (for example) by filesystem driver on mount. .IP "\fB\-\-getdiscardzeroes\fP" Get discard zeroes support status.
@@ -66,7 +69,9 @@ Get read-only. Print 1 if the device is read-only, 0 otherwise. .IP "\fB\-\-getsize64\fP" Print device size in bytes. .IP "\fB\-\-getsize\fP" -Print device size (32-bit!) in sectors. Deprecated in favor of the \-\-getsz option. +Print device size (32-bit!) in sectors. Deprecated in favor of the +.B \-\-getsz +option. .IP "\fB\-\-getss\fP" Print logical sector size in bytes \(en usually 512. .IP "\fB\-\-getsz\fP"
@@ -76,14 +81,21 @@ Reread partition table .IP "\fB\-\-setbsz\fP \fIbytes\fP" Set blocksize. Note that the block size is specific to the current file descriptor opening the block device, so the change of block size only persists -for as long as blockdev has the device open, and is lost once blockdev exits. +for as long as +.B blockdev +has the device open, and is lost once +.B blockdev +exits. .IP "\fB\-\-setfra\fP \fIsectors\fP" -Set filesystem readahead (same like \-\-setra on 2.6 kernels). +Set filesystem readahead (same as +.B \-\-setra +on 2.6 kernels). .IP "\fB\-\-setra\fP \fIsectors\fP" Set readahead (in 512-byte sectors). .IP "\fB\-\-setro\fP" -Set read-only. The currently active access to the device may not be affected by the change. For example -filesystem already mounted in read-write mode will not be affected. The change applies after remount. +Set read-only. The currently active access to the device may not be affected by the change. For example, +a filesystem already mounted in read-write mode will not be affected. +The change applies after remount. .IP "\fB\-\-setrw\fP" Set read-write. .SH AUTHORS
Signature · 1 line
2.26.2
PATCH 2/12 Manual pages: fsck.cramfs.8: Wording fix
--- disk-utils/fsck.cramfs.8 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
disk-utils/fsck.cramfs.8 +1 -1
@@ -55,7 +55,7 @@ usage information was printed .BR mount (8), .BR mkfs.cramfs (8) .SH AVAILABILITY -The example command is part of the util-linux package and is available from +The fsck.cramfs command is part of the util-linux package and is available from .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ Linux Kernel Archive .UE .
Signature · 1 line
2.26.2
PATCH 3/12 Manual pages: raw.8: Minor formatting and wording fixes
In reply to Michael Kerrisk (man-pages)--- disk-utils/raw.8 | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-)
disk-utils/raw.8 +10 -7
@@ -34,10 +34,10 @@ device numbers, or as a path name to an existing block device file. .PP The bindings already in existence can be queried with the -.I \-q +.B \-q option, which is used either with a raw device filename to query that one device, or with the -.I \-a +.B \-a option to query all bound raw devices. .PP Unbinding can be done by specifying major and minor 0.
@@ -66,8 +66,8 @@ will query an existing binding instead of setting a new one. .TP \fB\-a\fR, \fB\-\-all\fR With -.B \-q -, specify that all bound raw devices should be queried. +.BR \-q , +specify that all bound raw devices should be queried. .TP \fB\-h\fR, \fB\-\-help\fR Display help text and exit.
@@ -78,20 +78,23 @@ Display version information and exit. .SH NOTES Rather than using raw devices applications should prefer .BR open (2) -devices, such as /dev/sda1, with the O_DIRECT flag. +devices, such as +.IR /dev/sda1 , +with the +.B O_DIRECT +flag. .SH BUGS The Linux .BR dd (1) command should be used without the \fBbs=\fR option, or the blocksize needs to be a multiple of the sector size of the device (512 bytes usually), otherwise it will fail with "Invalid Argument" messages (EINVAL). - .PP Raw I/O devices do not maintain cache coherency with the Linux block device buffer cache. If you use raw I/O to overwrite data already in the buffer cache, the buffer cache will no longer correspond to the contents of the actual storage device underneath. This is deliberate, -but is regarded either a bug or a feature depending on who you ask! +but is regarded as either a bug or a feature, depending on who you ask! .SH AUTHORS Stephen Tweedie ([email protected]) .SH AVAILABILITY
Signature · 1 line
2.26.2
PATCH 4/12 Manual pages: sfdisk.8: Minor wording and formatting fixes
In reply to Michael Kerrisk (man-pages)--- disk-utils/sfdisk.8 | 38 +++++++++++++++++++++++++++----------- 1 file changed, 27 insertions(+), 11 deletions(-)
disk-utils/sfdisk.8 +27 -11
@@ -26,7 +26,7 @@ sfdisk \- display or manipulate a disk partition table .SH DESCRIPTION .B sfdisk is a script-oriented tool for partitioning any block device. It -runs in interactive mode if executed on terminal (stdin refers to a terminal). +runs in interactive mode if executed on a terminal (stdin refers to a terminal). Since version 2.26 .B sfdisk
@@ -45,11 +45,15 @@ to alignment if the start offset is specified exactly in sectors and partition size relative or by multiplicative suffixes. The recommended way is not to specify start offsets at all and specify -partition size in MiB, GiB (or so). In this case sfdisk align all partitions +partition size in MiB, GiB (or so). In this case +.B sfdisk +aligns all partitions to block-device I/O limits (or when I/O limits are too small then to megabyte boundary to keep disk layout portable). If this default behaviour is unwanted (usually for very small partitions) then specify offsets and sizes in -sectors. In this case sfdisk entirely follows specified numbers without any +sectors. In this case +.B sfdisk +entirely follows specified numbers without any optimization. .sp .B sfdisk
@@ -62,11 +66,15 @@ partitions. .B sfdisk uses BLKRRPART (reread partition table) ioctl to make sure that the device is not used by system or other tools (see also \-\-no-reread). It's possible that -this feature or another sfdisk activity races with \fBudevd\fR. The recommended way +this feature or another +.B sfdisk +activity races with \fBudevd\fR. The recommended way how to avoid possible collisions is to use \fB\-\-lock\fR option. The exclusive lock will cause udevd to skip the event handling on the device. .PP -The sfdisk prompt is only a hint for users and a displayed partition number does +The +.B sfdisk +prompt is only a hint for users and a displayed partition number does not mean that the same partition table entry will be created (if -N not specified), especially for tables with gaps.
@@ -96,8 +104,10 @@ bootable flag on all unspecified partitions. The special placeholder '\-' may be used instead of the partition numbers to switch off the bootable flag on all partitions. -The activation command is supported for MBR and PMBR only. If GPT label is detected -than sfdisk prints warning and automatically enter PMBR. +The activation command is supported for MBR and PMBR only. +If a GPT label is detected, then +.B sfdisk +prints warning and automatically enters PMBR. If no \fIpartition-number\fR is specified, then list the partitions with an enabled flag.
@@ -267,7 +277,9 @@ and the last command reorders partitions to match disk order .TP .B \-\-move\-use\-fsync -Use fsync system call after each write when move data to a new location by +Use the +.BR fsync (2) +system call after each write when moving data to a new location by \fB\-\-move\-data\fR. .TP .BR \-o , " \-\-output " \fIlist
@@ -305,7 +317,7 @@ to avoid possible collisions. The argument \fIwhen\fR can be \fBauto\fR, except the old partition-table signatures which are always wiped before create a new partition-table if the argument \fIwhen\fR is not \fBnever\fR. In all cases detected signatures are reported by warning messages before a new -partition table is created. See also +partition table is created. See also the .BR wipefs (8) command.
@@ -418,7 +430,9 @@ The partition is given in hex for MBR (DOS) where 0x prefix is optional; a GUID string for GPT; a shortcut or an alias. It's recommended to use two letters for MBR hex codes to avoid collision between deprecated shortcut 'E' and '0E' MBR hex code. For backward -compatibility sfdisk tries to interpret +compatibility +.B sfdisk +tries to interpret .I type as a shortcut as a first possibility in partitioning scripts although on other places (e.g. \fB\-\-part-type command)\fR it tries shortcuts as the last possibility.
@@ -601,7 +615,9 @@ The welcome message. .SH ENVIRONMENT .IP SFDISK_DEBUG=all -enables sfdisk debug output. +enablescw +.B sfdisk +debug output. .IP LIBFDISK_DEBUG=all enables libfdisk debug output. .IP LIBBLKID_DEBUG=all
Signature · 1 line
2.26.2
Re: [PATCH 04/12] Manual pages: sfdisk.8: Minor wording and formatting fixes
Quoted 10 lines · Michael Kerrisk (man-pages)
Signed-off-by: Michael Kerrisk (man-pages)
<[email protected]>--- disk-utils/sfdisk.8 | 38 +++++++++++++++++++++++++++----------- 1 file changed, 27 insertions(+), 11 deletions(-)disk-utils/sfdisk.8 +0
-0
[...]
disk-utils/sfdisk.8 The welcome message. · line 618
Quoted 6 lines
disk-utils/sfdisk.8 +1
-1@@ -601,7 +615,9 @@ The welcome message. .SH ENVIRONMENT .IP SFDISK_DEBUG=all -enables sfdisk debug output. +enablescw
And here "enables", not "enablescw"?
Signature · 1 line
Nuno Silva
Re: [PATCH 04/12] Manual pages: sfdisk.8: Minor wording and formatting fixes
Hi Nuno,
Quoted 14 lines · Nuno Silva
Quoted 10 lines · Michael Kerrisk (man-pages)
Signed-off-by: Michael Kerrisk (man-pages)
<[email protected]>--- disk-utils/sfdisk.8 | 38 +++++++++++++++++++++++++++----------- 1 file changed, 27 insertions(+), 11 deletions(-)disk-utils/sfdisk.8 +0
-0[...]
Quoted 8 lines
disk-utils/sfdisk.8 The welcome message. · line 618
Quoted 6 lines
disk-utils/sfdisk.8 +1
-1@@ -601,7 +615,9 @@ The welcome message. .SH ENVIRONMENT .IP SFDISK_DEBUG=all -enables sfdisk debug output. +enablescwAnd here "enables", not "enablescw"?
Yes; thanks. I've sent a patch to fix the two typos that you noticed.
Just a note though: when you strip the CC from a message, it's very likely (because of things like individual mail filtering rules) that relevant people will *not* notice your mail. It's best to always preserve the CC list, unless there's some good reason not to.
Cheers,
Michael
Re: [PATCH 04/12] Manual pages: sfdisk.8: Minor wording and formatting fixes
Quoted 1 line · Michael Kerrisk
Hi Nuno,
[...]
Quoted 7 lines
Yes; thanks. I've sent a patch to fix the two typos that you noticed.
Just a note though: when you strip the CC from a message, it's very likely (because of things like individual mail filtering rules) that relevant people will *not* notice your mail. It's best to always preserve the CC list, unless there's some good reason not to.
Sorry, my bad. I'm reading this list via Gmane and I used the command I usually use to "reply" to the group, which does not keep the Cc list.
Hopefully this time it will work better.
Signature · 1 line
Nuno Silva
PATCH 5/12 Manual pages: sfdisk.8: Use less aggressive indenting
In reply to Michael Kerrisk (man-pages)The page currently uses rather aggressive indenting, which doesn't really improve readability, but does have cause ugly line filling.
--- disk-utils/sfdisk.8 | 25 +++++-------------------- 1 file changed, 5 insertions(+), 20 deletions(-)
disk-utils/sfdisk.8 +5 -20
@@ -344,17 +344,14 @@ Display help text and exit. .B sfdisk supports two input formats and generic header lines. -.B Header lines -.RS +.SS Header lines The optional header lines specify generic information that apply to the partition table. The header-line format is: -.RS .sp .B "<name>: <value>" .sp .RE The currently recognized headers are: -.RS .TP .B unit Specify the partitioning unit. The only supported unit is \fBsectors\fR.
@@ -384,14 +381,11 @@ modify this variable if you're not sure. Specify sector size. This header is informative only and it is not used when sfdisk creates a new partition table, in this case the real device specific value is always used and sector size from the dump is ignored. -.RE -.sp +.PP Note that it is only possible to use header lines before the first partition is specified in the input. -.RE - -.B Unnamed-fields format -.RS +.SS Unnamed-fields format +\& .RS .sp .I start size type bootable
@@ -441,7 +435,6 @@ Since v2.36 libfdisk supports partition type aliases as extension to shortcuts. simple human readable word (e.g. "linux"). Supported shortcuts and aliases: -.RS .TP .B L - alias 'linux' Linux; means 83 for MBR and 0FC63DAF-8483-4772-8E79-3D69D8477DE4 for GPT.
@@ -464,7 +457,6 @@ Linux RAID; means FD for MBR and A19D880F-05FC-4D3B-A006-743F0F84911E for GPT .TP .B V - alias 'lvm' LVM; means 8E for MBR and E6D6D379-F507-44C2-A23C-238F2A3DF928 for GPT -.RE .PP The default .I type
@@ -478,10 +470,7 @@ is specified as [\fB*\fR|\fB-\fR], with as default not-bootable. The value of this field is irrelevant for Linux - when Linux runs it has been booted already - but it might play a role for certain boot loaders and for other operating systems. -.RE - -.B Named-fields format -.RS +.SS Named-fields format This format is more readable, robust, extensible and allows specifying additional information (e.g., a UUID). It is recommended to use this format to keep your scripts more readable.
@@ -501,7 +490,6 @@ The .I value can be between quotation marks (e.g., name="This is partition name"). The currently supported fields are: -.RS .TP .BI start= number The first non-assigned sector aligned according to device I/O limits. The default
@@ -531,9 +519,6 @@ GPT partition name. A hexadecimal number (without 0x) for an MBR partition, a GUID for a GPT partition, or a shortcut as for unnamed-fields format. For backward compatibility the \fBId=\fR field has the same meaning. -.RE -.RE - .SH EMPTY DISK LABEL .B sfdisk does not create partition table without partitions by default. The lines with
Signature · 1 line
2.26.2
PATCH 6/12 Manual pages: lslogins.1: Minor wording and formatting fixres
In reply to Michael Kerrisk (man-pages)--- login-utils/lslogins.1 | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-)
login-utils/lslogins.1 +15 -7
@@ -11,7 +11,10 @@ lslogins \- display information about known users in the system .RB [ \-l " \fIlogins\fR]" .RI [ username ] .SH DESCRIPTION -Examine the wtmp and btmp logs, /etc/shadow (if necessary) and /etc/passwd +Examine the wtmp and btmp logs, +.I /etc/shadow +(if necessary) and +.I /passwd and output the desired data. The optional argument \fIusername\fR forces
@@ -46,12 +49,14 @@ Show information about supplementary groups. .TP \fB\-g\fR, \fB\-\-groups\fR=\fIgroups\fR Only show data of users belonging to \fIgroups\fR. More than one group -may be specified; the list has to be comma-separated. The unknown group +may be specified; the list has to be comma-separated. Unknown group names are ignored. Note that relation between user and group may be invisible for primary group if the user is not explicitly specify as group member (e.g., in /etc/group). If the -command lslogins scans for groups than it uses groups database only, and user +command +.B lslogins +scans for groups than it uses groups database only, and user database with primary GID is not used at all. .TP \fB\-h\fR, \fB\-\-help\fR
@@ -63,7 +68,7 @@ Display data containing information about the users' last login sessions. \fB\-l\fR, \fB\-\-logins\fR=\fIlogins\fR Only show data of users with a login specified in \fIlogins\fR (user names or user IDS). More than one login may be specified; the list has to be comma-separated. -The unknown login names are ignored. +Unknown login names are ignored. .TP \fB\-n\fR, \fB\-\-newline\fR Display each piece of information on a separate line.
@@ -94,7 +99,8 @@ Raw output (no columnation). Show system accounts. These are by default all accounts with a UID between 101 and 999 (inclusive), with the exception of either nobody or nfsnobody (UID 65534). This hardcoded default may be overwritten by parameters SYS_UID_MIN and SYS_UID_MAX in -the file /etc/login.defs. +the file +.IR /etc/login.defs . .TP \fB\-\-time\-format\fR \fItype\fP Display dates in short, full or iso format. The default is short, this time
@@ -104,7 +110,8 @@ format is designed to be space efficient and human readable. Show user accounts. These are by default all accounts with UID above 1000 (inclusive), with the exception of either nobody or nfsnobody (UID 65534). This hardcoded default maybe overwritten by parameters UID_MIN and UID_MAX in -the file /etc/login.defs. +the file +.IR /etc/login.defs . .TP \fB\-V\fR, \fB\-\-version\fR Display version information and exit.
@@ -132,7 +139,8 @@ if incorrect arguments specified, 2 if a serious error occurs (e.g., a corrupt log). .SH NOTES -The default UID thresholds are read from /etc/login.defs. +The default UID thresholds are read from +.IR /etc/login.defs . .SH HISTORY The \fBlslogins\fP utility is inspired by the \fBlogins\fP utility, which first appeared in FreeBSD 4.10.
Signature · 1 line
2.26.2
PATCH 7/12 Manual pages: nologin.8: formatting fixes
In reply to Michael Kerrisk (man-pages)--- login-utils/nologin.8 | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-)
login-utils/nologin.8 +12 -3
@@ -10,7 +10,10 @@ nologin \- politely refuse a login displays a message that an account is not available and exits non-zero. It is intended as a replacement shell field to deny login access to an account. .PP -If the file /etc/nologin.txt exists, nologin displays its contents to the +If the file +.IR /etc/nologin.txt exists , +.B nologin +displays its contents to the user instead of the default message. .PP The exit status returned by
@@ -48,13 +51,19 @@ Display version information and exit. .B nologin is a per-account way to disable login (usually used for system accounts like http or ftp). .BR nologin (8) -uses /etc/nologin.txt as an optional source for a non-default message, the login +uses +.I /etc/nologin.txt +as an optional source for a non-default message, the login access is always refused independently of the file. .PP .BR pam_nologin (8) PAM module usually prevents all non-root users from logging into the system. .BR pam_nologin (8) -functionality is controlled by /var/run/nologin or the /etc/nologin file. +functionality is controlled by +.I /var/run/nologin +or the +.I /etc/nologin +file. .SH HISTORY The .B nologin
Signature · 1 line
2.26.2
PATCH 8/12 Manual pages: logger.1: minor formatting and typo fixes
In reply to Michael Kerrisk (man-pages)--- misc-utils/logger.1 | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-)
misc-utils/logger.1 +7 -3
@@ -49,8 +49,10 @@ given either, then standard input is logged. .TP .BR \-d , " \-\-udp" Use datagrams (UDP) only. By default the connection is tried to the -syslog port defined in /etc/services, which is often 514 . -.sp +syslog port defined in +.IR /etc/services , +which is often 514. +.IP See also \fB\-\-server\fR and \fB\-\-socket\fR to specify where to connect. .TP .BR \-e , " \-\-skip-empty"
@@ -75,7 +77,9 @@ command's PID. The use of \fB\-\-id=$$\fR (PPID) is recommended in scripts that send several messages. Note that the system logging infrastructure (for example \fBsystemd\fR when -listening on /dev/log) may follow local socket credentials to overwrite the +listening on +.IR /dev/log ) +may follow local socket credentials to overwrite the PID specified in the message. .BR logger (1) is able to set those socket credentials to the given \fIid\fR, but only if you
Signature · 1 line
2.26.2
PATCH 9/12 Manual pages: lsblk.8: Minor formatting and typo fixes
In reply to Michael Kerrisk (man-pages)--- misc-utils/lsblk.8 | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-)
misc-utils/lsblk.8 +11 -4
@@ -13,7 +13,9 @@ command reads the .B sysfs filesystem and .B udev db -to gather information. If the udev db is not available or lsblk is compiled without udev support than it +to gather information. If the udev db is not available or +.B lsblk +is compiled without udev support, then it tries to read LABELs, UUIDs and filesystem types from the block device. In this case root permissions are necessary. .PP
@@ -41,7 +43,9 @@ might be executed in time when does not have all information about recently added or modified devices yet. In this case it is recommended to use .B "udevadm settle" -before lsblk to synchronize with udev. +before +.B lsblk +to synchronize with udev. .SH OPTIONS .TP .BR \-a , " \-\-all"
@@ -162,7 +166,8 @@ than the tree branches are sorted by the \fIcolumn\fP. Print the zone model for each device. .TP .BR " \-\-sysroot " \fIdirectory\fP -Gather data for a Linux instance other than the instance from which the lsblk +Gather data for a Linux instance other than the instance from which the +.B lsblk command is issued. The specified directory is the system root of the Linux instance to be inspected. The real device nodes in the target directory can be replaced by text files with udev attributes.
@@ -179,7 +184,9 @@ some specified devices found, some not found .SH ENVIRONMENT .IP LSBLK_DEBUG=all -enables lsblk debug output. +enables +.B lsblk +debug output. .IP LIBBLKID_DEBUG=all enables libblkid debug output. .IP LIBMOUNT_DEBUG=all
Signature · 1 line
2.26.2
PATCH 10/12 Manual pages: wdctl.8: typo fix
In reply to Michael Kerrisk (man-pages)--- sys-utils/wdctl.8 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
sys-utils/wdctl.8 +1 -1
@@ -14,7 +14,7 @@ Show hardware watchdog status. The default device is If more than one device is specified then the output is separated by one blank line. .PP -If the device is already used or user has no permissions to read from the device than +If the device is already used or user has no permissions to read from the device, then .B wdctl reads data from sysfs. In this case information about supported features (flags) might be missing. .PP
Signature · 1 line
2.26.2
PATCH 11/12 Manual pages: agetty.8: Minor formatting and wording fixes
In reply to Michael Kerrisk (man-pages)--- term-utils/agetty.8 | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-)
term-utils/agetty.8 +17 -7
@@ -74,7 +74,9 @@ The default for \fBserial terminals\fP is keep the current baud rate .TP .I term The value to be used for the TERM environment variable. This overrides -whatever init(8) may have set, and is inherited by login and the shell. +whatever +.BR init (1) +may have set, and is inherited by login and the shell. .sp The default is 'vt100', or 'linux' for Linux on a virtual terminal, or 'hurd' for GNU Hurd on a virtual terminal.
@@ -93,8 +95,12 @@ Using this option causes an \fB\-f \fIusername\fR option and argument to be added to the \fB/bin/login\fP command line. See \fB\-\-login\-options\fR, which can be used to modify this option's behavior. -Note that \fB\-\-autologin\fP may affect the way how agetty initializes the -serial line, because on auto-login agetty does not read from the line and it +Note that \fB\-\-autologin\fP may affect the way in which +.B getty +initializes the +serial line, because on auto-login +.B agetty +does not read from the line and it has no opportunity optimize the line setting. .TP \-c, \-\-noreset
@@ -353,16 +359,20 @@ not be interpreted as options. Use this feature if available by passing "\-\-" before the username gets passed by \\u. .SH ISSUE FILES -The default issue file is \fI/etc/issue\fP. If the file exists then agetty also +The default issue file is \fI/etc/issue\fP. If the file exists, then +.B agetty +also checks for \fI/etc/issue.d\fP directory. The directory is optional extension to the default issue file and content of the directory is printed after -\fI/etc/issue\fP content. If the \fI/etc/issue\fP does not exist than the +\fI/etc/issue\fP content. If the \fI/etc/issue\fP does not exist, then the directory is ignored. All files \fBwith .issue extension\fP from the directory are printed in version-sort order. The directory can be used to maintain 3rd-party messages independently on the primary system \fI/etc/issue\fP file. Since version 2.35 additional locations for issue file and directory are -supported. If the default \fI/etc/issue\fP does not exist than agetty checks +supported. If the default \fI/etc/issue\fP does not exist, then +.B agetty +checks for \fI/run/issue\fP and \fI/run/issue.d\fP, thereafter for \fI/usr/lib/issue\fP and \fI/usr/lib/issue.d\fP. The directory /etc is expected for host specific configuration, /run is expected for generated stuff
@@ -372,7 +382,7 @@ The default path maybe overridden by \fB\-\-issue\-file\fP option. In this case specified path has to be file or directory and all the default issue file and directory locations are ignored. -The issue file feature is possible to completely disable by \fB\-\-noissue\fP option. +The issue file feature can be completely disabled by \fB\-\-noissue\fP option. It is possible to review the current issue file by \fBagetty \-\-show\-issue\fP on the current terminal.
Signature · 1 line
2.26.2
PATCH 12/12 Manual pages: wipefs.8: Formatting fixes
In reply to Michael Kerrisk (man-pages)--- misc-utils/wipefs.8 | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-)
misc-utils/wipefs.8 +8 -4
@@ -28,7 +28,9 @@ to make the signatures invisible for libblkid. .B wipefs does not erase the filesystem itself nor any other data from the device. -When used without any options, wipefs lists all visible filesystems and the +When used without any options, +.B wipefs +lists all visible filesystems and the offsets of their basic signatures. The default output is subject to change. So whenever possible, you should avoid using default outputs in your scripts. Always explicitly define expected columns by using
@@ -89,8 +91,9 @@ tools. Do not print a header line. .TP .BR \-O , " \-\-output " \fIlist\fP -Specify which output columns to print. Use \-\-help to -get a list of all supported columns. +Specify which output columns to print. Use +.B \-\-help +to get a list of all supported columns. .TP .BR \-n , " \-\-no\-act" Causes everything to be done except for the write() call.
@@ -116,7 +119,8 @@ Suppress any messages after a successful signature wipe. Limit the set of printed or erased signatures. More than one type may be specified in a comma-separated list. The list or individual types can be prefixed with 'no' to specify the types on which no action should be -taken. For more details see mount(8). +taken. For more details see +.BR mount (8). .TP .BR \-V , " \-\-version" Display version information and exit.
Signature · 1 line
2.26.2
Karel Zak
maintainerQuoted 2 lines · Michael Kerrisk (man-pages)
disk-utils/blockdev.8 | 28 ++++++++++++++++++++-------- 1 file changed, 20 insertions(+), 8 deletions(-)
All patches merged. Thanks!
Karel
Signature · 2 lines
Karel Zak <[email protected]> http://karelzak.blogspot.com
Quoted 10 lines · Michael Kerrisk (man-pages)
Signed-off-by: Michael Kerrisk (man-pages)
<[email protected]>--- disk-utils/blockdev.8 | 28 ++++++++++++++++++++-------- 1 file changed, 20 insertions(+), 8 deletions(-)disk-utils/blockdev.8 +0
-0
[...]
disk-utils/blockdev.8 Flush buffers. · line 51
Quoted 9 lines
disk-utils/blockdev.8 +3
-2@@ -44,8 +46,9 @@ Flush buffers. .IP "\fB\-\-getalignoff\fP" Get alignment offset. .IP "\fB\-\-getbsz\fP" -Print blocksize in bytes. This size does not describe device topology. It's -size used internally by kernel and it maybe modified (for example) by +Print the blocksize in bytes. +This size does not describe device topology. It's +the size used internally by ithe kernel and it may be modified (for example) by
Should that be "the", not "ithe"?
Signature · 1 line
Nuno Silva