Re: [PATCH] man7/*: ffix, change '-' to '\-' for options and to '\(en' for a range

["Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>]

On 7/2/20 1:31 AM, Bjarni Ingi Gislason wrote:
>   Change '-' to '\-' for the prefix of names to indicate an option.
> 
>   Change '-' to '\(en' for a range.

Thanks! Patch applied,

Cheers,

Michael

> Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
> ---
>  man7/bootparam.7           |  4 ++--
>  man7/cgroups.7             | 12 ++++++------
>  man7/feature_test_macros.7 |  4 ++--
>  man7/man.7                 |  2 +-
>  man7/math_error.7          |  6 +++---
>  man7/pid_namespaces.7      |  2 +-
>  man7/pthreads.7            |  2 +-
>  7 files changed, 16 insertions(+), 16 deletions(-)
> 
> diff --git a/man7/bootparam.7 b/man7/bootparam.7
> index 48a7d047c..888e47c8d 100644
> --- a/man7/bootparam.7
> +++ b/man7/bootparam.7
> @@ -138,7 +138,7 @@ A symbolic specification has the form
>  .IR /dev/XXYN ,
>  where XX designates
>  the device type (e.g., 'hd' for ST-506 compatible hard disk, with Y in
> -\&'a'-'d'; 'sd' for SCSI compatible disk, with Y in 'a'-'e'),
> +\&'a'\(en'd'; 'sd' for SCSI compatible disk, with Y in 'a'\(en'e'),
>  Y the driver letter or
>  number, and N the number (in decimal) of the partition on this device.
>  .IP
> @@ -485,7 +485,7 @@ for older kernels) in the Linux kernel source.
>  .B "IDE Disk/CD-ROM Driver Parameters"
>  The IDE driver accepts a number of parameters, which range from disk
>  geometry specifications, to support for broken controller chips.
> -Drive-specific options are specified by using 'hdX=' with X in 'a'-'h'.
> +Drive-specific options are specified by using 'hdX=' with X in 'a'\(en'h'.
>  .IP
>  Non-drive-specific options are specified with the prefix 'hd='.
>  Note that using a drive-specific prefix for a non-drive-specific option
> diff --git a/man7/cgroups.7 b/man7/cgroups.7
> index 2f4307bef..deed09d44 100644
> --- a/man7/cgroups.7
> +++ b/man7/cgroups.7
> @@ -522,7 +522,7 @@ cgroup filesystem is mounted:
>  .PP
>  .in +4n
>  .EX
> -mount -o release_agent=pathname ...
> +mount \-o release_agent=pathname ...
>  .EE
>  .in
>  .PP
> @@ -549,7 +549,7 @@ it is possible to mount a cgroup hierarchy that has no attached controllers:
>  .PP
>  .in +4n
>  .EX
> -mount -t cgroup -o none,name=somename none /some/mount/point
> +mount \-t cgroup \-o none,name=somename none /some/mount/point
>  .EE
>  .in
>  .PP
> @@ -633,7 +633,7 @@ when mounting the cgroup v2 filesystem using a command such as the following:
>  .PP
>  .in +4n
>  .EX
> -mount -t cgroup2 none /mnt/cgroup2
> +mount \-t cgroup2 none /mnt/cgroup2
>  .EE
>  .in
>  .PP
> @@ -670,7 +670,7 @@ during the boot process.
>  .\"
>  .SS Cgroups v2 mount options
>  The following options
> -.RI ( "mount -o" )
> +.RI ( "mount \-o" )
>  can be specified when mounting the group v2 filesystem:
>  .TP
>  .IR nsdelegate " (since Linux 4.15)"
> @@ -791,7 +791,7 @@ or '\-' (to disable a controller), as in the following example:
>  .IP
>  .in +4n
>  .EX
> -echo '+pids -memory' > x/y/cgroup.subtree_control
> +echo '+pids \-memory' > x/y/cgroup.subtree_control
>  .EE
>  .in
>  .IP
> @@ -1120,7 +1120,7 @@ option as follows:
>  .PP
>  .in +4n
>  .EX
> -mount -t cgroup2 -o remount,nsdelegate \e
> +mount \-t cgroup2 \-o remount,nsdelegate \e
>                   none /sys/fs/cgroup/unified
>  .EE
>  .in
> diff --git a/man7/feature_test_macros.7 b/man7/feature_test_macros.7
> index 186c8e27d..cba587bf1 100644
> --- a/man7/feature_test_macros.7
> +++ b/man7/feature_test_macros.7
> @@ -220,9 +220,9 @@ ISO Standard C.
>  This macro is implicitly defined by
>  .BR gcc (1)
>  when invoked with, for example, the
> -.I -std=c99
> +.I \-std=c99
>  or
> -.I -ansi
> +.I \-ansi
>  flag.
>  .TP
>  .B _POSIX_C_SOURCE
> diff --git a/man7/man.7 b/man7/man.7
> index 95033539f..7c6daac92 100644
> --- a/man7/man.7
> +++ b/man7/man.7
> @@ -277,7 +277,7 @@ macro, with the optional
>  (if present, usually a closing parenthesis and/or end-of-sentence
>  punctuation) immediately following.
>  For non-HTML output devices (e.g.,
> -.BR "man -Tutf8" ),
> +.BR "man \-Tutf8" ),
>  the link text is followed by the URL in angle brackets; if there is no
>  link text, the URL is printed as its own link text, surrounded by angle
>  brackets.
> diff --git a/man7/math_error.7 b/man7/math_error.7
> index 1a07a2318..187c0b1cc 100644
> --- a/man7/math_error.7
> +++ b/man7/math_error.7
> @@ -240,7 +240,7 @@ and POSIX.1.
>  .PP
>  The
>  .BR gcc (1)
> -.I "-fno-math-errno"
> +.I "\-fno-math-errno"
>  option causes the executable to employ implementations of some
>  mathematical functions that are faster than the standard
>  implementations, but do not set
> @@ -248,9 +248,9 @@ implementations, but do not set
>  on error.
>  (The
>  .BR gcc (1)
> -.I "-ffast-math"
> +.I "\-ffast-math"
>  option also enables
> -.IR "-fno-math-errno" .)
> +.IR "\-fno-math-errno" .)
>  An error can still be tested for using
>  .BR fetestexcept (3).
>  .SH SEE ALSO
> diff --git a/man7/pid_namespaces.7 b/man7/pid_namespaces.7
> index 05d821602..1e5a6065f 100644
> --- a/man7/pid_namespaces.7
> +++ b/man7/pid_namespaces.7
> @@ -343,7 +343,7 @@ is:
>  .PP
>  .in +4n
>  .EX
> -$ mount -t proc proc /proc
> +$ mount \-t proc proc /proc
>  .EE
>  .in
>  .PP
> diff --git a/man7/pthreads.7 b/man7/pthreads.7
> index 78f6df17f..c91106d8c 100644
> --- a/man7/pthreads.7
> +++ b/man7/pthreads.7
> @@ -856,7 +856,7 @@ is set to a value other than
>  then this value defines the default stack size for new threads.
>  To be effective, this limit must be set before the program
>  is executed, perhaps using the
> -.I ulimit -s
> +.I ulimit \-s
>  shell built-in command
>  .RI ( "limit stacksize"
>  in the C shell).
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/