[PATCH 01/12] Manual pages: blockdev.8: Minor wording and formatting fixes

[PATCH 01/12] Manual pages: blockdev.8: Minor wording and formatting fixes

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 disk-utils/blockdev.8 | 28 ++++++++++++++++++++--------
 1 file changed, 20 insertions(+), 8 deletions(-)

diff --git a/disk-utils/blockdev.8 b/disk-utils/blockdev.8
index 361e6aad7..44ed9e1e9 100644
--- a/disk-utils/blockdev.8
+++ b/disk-utils/blockdev.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
-- 
2.26.2

[PATCH 02/12] Manual pages: fsck.cramfs.8: Wording fix

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 disk-utils/fsck.cramfs.8 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/disk-utils/fsck.cramfs.8 b/disk-utils/fsck.cramfs.8
index 1beabd81b..90d794205 100644
--- a/disk-utils/fsck.cramfs.8
+++ b/disk-utils/fsck.cramfs.8
@@ -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 .
-- 
2.26.2

[PATCH 03/12] Manual pages: raw.8: Minor formatting and wording fixes

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 disk-utils/raw.8 | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/disk-utils/raw.8 b/disk-utils/raw.8
index ba9fd256a..d569507b8 100644
--- a/disk-utils/raw.8
+++ b/disk-utils/raw.8
@@ -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 (sct@redhat.com)
 .SH AVAILABILITY
-- 
2.26.2

[PATCH 04/12] Manual pages: sfdisk.8: Minor wording and formatting fixes

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 disk-utils/sfdisk.8 | 38 +++++++++++++++++++++++++++-----------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/disk-utils/sfdisk.8 b/disk-utils/sfdisk.8
index 6c3f62edd..6c54a1699 100644
--- a/disk-utils/sfdisk.8
+++ b/disk-utils/sfdisk.8
@@ -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
-- 
2.26.2

Re: [PATCH 04/12] Manual pages: sfdisk.8: Minor wording and formatting fixes

[Nuno Silva]

On 2020-07-24, Michael Kerrisk (man-pages) wrote:

> Signed-off-by: Michael Kerrisk (man-pages)
> <mtk.manpages@gmail.com>
> ---
>  disk-utils/sfdisk.8 | 38 +++++++++++++++++++++++++++-----------
>  1 file changed, 27 insertions(+), 11 deletions(-)
>
> diff --git a/disk-utils/sfdisk.8 b/disk-utils/sfdisk.8
> index 6c3f62edd..6c54a1699 100644
> --- a/disk-utils/sfdisk.8
> +++ b/disk-utils/sfdisk.8
[...]
> @@ -601,7 +615,9 @@ The welcome message.
>  
>  .SH ENVIRONMENT
>  .IP SFDISK_DEBUG=all
> -enables sfdisk debug output.
> +enablescw

And here "enables", not "enablescw"?

-- 
Nuno Silva

Re: [PATCH 04/12] Manual pages: sfdisk.8: Minor wording and formatting fixes

[Michael Kerrisk]

Hi Nuno,

On Fri, Jul 24, 2020 at 6:33 PM Nuno Silva <nunojsilva@ist.utl.pt> wrote:
>
> On 2020-07-24, Michael Kerrisk (man-pages) wrote:
>
> > Signed-off-by: Michael Kerrisk (man-pages)
> > <mtk.manpages@gmail.com>
> > ---
> >  disk-utils/sfdisk.8 | 38 +++++++++++++++++++++++++++-----------
> >  1 file changed, 27 insertions(+), 11 deletions(-)
> >
> > diff --git a/disk-utils/sfdisk.8 b/disk-utils/sfdisk.8
> > index 6c3f62edd..6c54a1699 100644
> > --- a/disk-utils/sfdisk.8
> > +++ b/disk-utils/sfdisk.8
> [...]
> > @@ -601,7 +615,9 @@ The welcome message.
> >
> >  .SH ENVIRONMENT
> >  .IP SFDISK_DEBUG=all
> > -enables sfdisk debug output.
> > +enablescw
>
> And 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

[Nuno Silva]

On 2020-08-27, Michael Kerrisk wrote:

> Hi Nuno,
[...]
>
> 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.

-- 
Nuno Silva

[PATCH 05/12] Manual pages: sfdisk.8: Use less aggressive indenting

[Michael Kerrisk (man-pages)]

The page currently uses rather aggressive indenting, which doesn't
really improve readability, but does have cause ugly line filling.

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 disk-utils/sfdisk.8 | 25 +++++--------------------
 1 file changed, 5 insertions(+), 20 deletions(-)

diff --git a/disk-utils/sfdisk.8 b/disk-utils/sfdisk.8
index 6c54a1699..6415b0f1b 100644
--- a/disk-utils/sfdisk.8
+++ b/disk-utils/sfdisk.8
@@ -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
-- 
2.26.2

[PATCH 06/12] Manual pages: lslogins.1: Minor wording and formatting fixres

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 login-utils/lslogins.1 | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/login-utils/lslogins.1 b/login-utils/lslogins.1
index 6824001d4..0c9ea6dce 100644
--- a/login-utils/lslogins.1
+++ b/login-utils/lslogins.1
@@ -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.
-- 
2.26.2

[PATCH 07/12] Manual pages: nologin.8: formatting fixes

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 login-utils/nologin.8 | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/login-utils/nologin.8 b/login-utils/nologin.8
index a95ff2ba1..1f06544b5 100644
--- a/login-utils/nologin.8
+++ b/login-utils/nologin.8
@@ -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
-- 
2.26.2

[PATCH 08/12] Manual pages: logger.1: minor formatting and typo fixes

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 misc-utils/logger.1 | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/misc-utils/logger.1 b/misc-utils/logger.1
index 448311d03..f9c2b6b9e 100644
--- a/misc-utils/logger.1
+++ b/misc-utils/logger.1
@@ -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
-- 
2.26.2

[PATCH 09/12] Manual pages: lsblk.8: Minor formatting and typo fixes

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 misc-utils/lsblk.8 | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/misc-utils/lsblk.8 b/misc-utils/lsblk.8
index 3da4e2e19..891b3f088 100644
--- a/misc-utils/lsblk.8
+++ b/misc-utils/lsblk.8
@@ -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
-- 
2.26.2

[PATCH 10/12] Manual pages: wdctl.8: typo fix

[Michael Kerrisk (man-pages)]

---
 sys-utils/wdctl.8 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sys-utils/wdctl.8 b/sys-utils/wdctl.8
index efd8b5917..c2c1ef163 100644
--- a/sys-utils/wdctl.8
+++ b/sys-utils/wdctl.8
@@ -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
-- 
2.26.2

[PATCH 11/12] Manual pages: agetty.8: Minor formatting and wording fixes

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 term-utils/agetty.8 | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/term-utils/agetty.8 b/term-utils/agetty.8
index 902914197..6c748a365 100644
--- a/term-utils/agetty.8
+++ b/term-utils/agetty.8
@@ -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.
-- 
2.26.2

[PATCH 12/12] Manual pages: wipefs.8: Formatting fixes

[Michael Kerrisk (man-pages)]

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
---
 misc-utils/wipefs.8 | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/misc-utils/wipefs.8 b/misc-utils/wipefs.8
index cdc6b2811..0ffe1f183 100644
--- a/misc-utils/wipefs.8
+++ b/misc-utils/wipefs.8
@@ -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.
-- 
2.26.2

Re: [PATCH 01/12] Manual pages: blockdev.8: Minor wording and formatting fixes

[Karel Zak]

On Fri, Jul 24, 2020 at 12:06:07PM +0200, Michael Kerrisk (man-pages) wrote:
>  disk-utils/blockdev.8 | 28 ++++++++++++++++++++--------
>  1 file changed, 20 insertions(+), 8 deletions(-)

 All patches merged. Thanks!

    Karel

-- 
 Karel Zak  <kzak@redhat.com>
 http://karelzak.blogspot.com

Re: [PATCH 01/12] Manual pages: blockdev.8: Minor wording and formatting fixes

[Nuno Silva]

On 2020-07-24, Michael Kerrisk (man-pages) wrote:

> Signed-off-by: Michael Kerrisk (man-pages)
> <mtk.manpages@gmail.com>
> ---
>  disk-utils/blockdev.8 | 28 ++++++++++++++++++++--------
>  1 file changed, 20 insertions(+), 8 deletions(-)
>
> diff --git a/disk-utils/blockdev.8 b/disk-utils/blockdev.8
> index 361e6aad7..44ed9e1e9 100644
> --- a/disk-utils/blockdev.8
> +++ b/disk-utils/blockdev.8
[...]
> @@ -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"?

-- 
Nuno Silva