From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
To: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Cc: mtk.manpages@gmail.com, linux-man@vger.kernel.org
Subject: Re: [PATCH] man2/*: ffix, change '-' to '\-' for options
Date: Thu, 2 Jul 2020 12:26:05 +0200 [thread overview]
Message-ID: <af6422ad-41e3-c1bd-aec4-0f5e2f12103e@gmail.com> (raw)
In-Reply-To: <20200701220850.GA25056@rhi.hi.is>
On 7/2/20 12:08 AM, Bjarni Ingi Gislason wrote:
> Change '-' to '\-' for the prefix of names to indicate an option.
Thanks. Patch applied.
Cheers,
Michael
> Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
> ---
> man2/alloc_hugepages.2 | 2 +-
> man2/listxattr.2 | 6 +++---
> man2/mkdir.2 | 4 ++--
> man2/open.2 | 2 +-
> man2/ptrace.2 | 2 +-
> man2/sched_setaffinity.2 | 2 +-
> man2/seccomp.2 | 2 +-
> man2/stat.2 | 2 +-
> man2/unshare.2 | 2 +-
> 9 files changed, 12 insertions(+), 12 deletions(-)
>
> diff --git a/man2/alloc_hugepages.2 b/man2/alloc_hugepages.2
> index 14ed0516a..a5e6cb138 100644
> --- a/man2/alloc_hugepages.2
> +++ b/man2/alloc_hugepages.2
> @@ -146,5 +146,5 @@ boot parameter.
> .\".PP
> .\" requires CONFIG_HUGETLB_PAGE (under "Processor type and features")
> .\" and CONFIG_HUGETLBFS (under "Filesystems").
> -.\" mount -t hugetlbfs hugetlbfs /huge
> +.\" mount \-t hugetlbfs hugetlbfs /huge
> .\" SHM_HUGETLB
> diff --git a/man2/listxattr.2 b/man2/listxattr.2
> index 28b55c1e1..40fcf377c 100644
> --- a/man2/listxattr.2
> +++ b/man2/listxattr.2
> @@ -203,9 +203,9 @@ and then listing the attributes with the example program.
> .in +4n
> .EX
> $ \fBtouch /tmp/foo\fP
> -$ \fBsetfattr -n user.fred -v chocolate /tmp/foo\fP
> -$ \fBsetfattr -n user.frieda -v bar /tmp/foo\fP
> -$ \fBsetfattr -n user.empty /tmp/foo\fP
> +$ \fBsetfattr \-n user.fred \-v chocolate /tmp/foo\fP
> +$ \fBsetfattr \-n user.frieda \-v bar /tmp/foo\fP
> +$ \fBsetfattr \-n user.empty /tmp/foo\fP
> $ \fB./listxattr /tmp/foo\fP
> user.fred: chocolate
> user.frieda: bar
> diff --git a/man2/mkdir.2 b/man2/mkdir.2
> index 6411080fc..e01062869 100644
> --- a/man2/mkdir.2
> +++ b/man2/mkdir.2
> @@ -66,9 +66,9 @@ The newly created directory will be owned by the effective user ID of the
> process.
> If the directory containing the file has the set-group-ID
> bit set, or if the filesystem is mounted with BSD group semantics
> -.RI ( "mount -o bsdgroups"
> +.RI ( "mount \-o bsdgroups"
> or, synonymously
> -.IR "mount -o grpid" ),
> +.IR "mount \-o grpid" ),
> the new directory will inherit the group ownership from its parent;
> otherwise it will be owned by the effective group ID of the process.
> .PP
> diff --git a/man2/open.2 b/man2/open.2
> index eb75437ff..9ab75516c 100644
> --- a/man2/open.2
> +++ b/man2/open.2
> @@ -1192,7 +1192,7 @@ does not support
> refers to a regular file that is too large to be opened.
> The usual scenario here is that an application compiled
> on a 32-bit platform without
> -.I -D_FILE_OFFSET_BITS=64
> +.I \-D_FILE_OFFSET_BITS=64
> tried to open a file whose size exceeds
> .I (1<<31)-1
> bytes;
> diff --git a/man2/ptrace.2 b/man2/ptrace.2
> index 1233ee994..4d50d2f70 100644
> --- a/man2/ptrace.2
> +++ b/man2/ptrace.2
> @@ -2270,7 +2270,7 @@ to the tracee after
> returns.
> This is an ordinary signal (similar to one which can be
> generated by
> -.IR "kill -TRAP" ),
> +.IR "kill \-TRAP" ),
> not a special kind of ptrace-stop.
> Employing
> .B PTRACE_GETSIGINFO
> diff --git a/man2/sched_setaffinity.2 b/man2/sched_setaffinity.2
> index 6b54d202e..00a0ce65c 100644
> --- a/man2/sched_setaffinity.2
> +++ b/man2/sched_setaffinity.2
> @@ -324,7 +324,7 @@ system has two cores, each with two CPUs:
> .PP
> .in +4n
> .EX
> -$ \fBlscpu | egrep -i 'core.*:|socket'\fP
> +$ \fBlscpu | egrep \-i 'core.*:|socket'\fP
> Thread(s) per core: 2
> Core(s) per socket: 2
> Socket(s): 1
> diff --git a/man2/seccomp.2 b/man2/seccomp.2
> index 731e775f4..14b3b443c 100644
> --- a/man2/seccomp.2
> +++ b/man2/seccomp.2
> @@ -940,7 +940,7 @@ numbers on this architecture:
> .PP
> .in +4n
> .EX
> -$ \fBuname -m\fP
> +$ \fBuname \-m\fP
> x86_64
> $ \fBsyscall_nr() {
> cat /usr/src/linux/arch/x86/syscalls/syscall_64.tbl | \e
> diff --git a/man2/stat.2 b/man2/stat.2
> index a5f983b67..ad85e17d7 100644
> --- a/man2/stat.2
> +++ b/man2/stat.2
> @@ -432,7 +432,7 @@ or
> .IR blkcnt_t .
> This error can occur when, for example,
> an application compiled on a 32-bit platform without
> -.I -D_FILE_OFFSET_BITS=64
> +.I \-D_FILE_OFFSET_BITS=64
> calls
> .BR stat ()
> on a file whose size exceeds
> diff --git a/man2/unshare.2 b/man2/unshare.2
> index 720c43ca1..4b7dbb89a 100644
> --- a/man2/unshare.2
> +++ b/man2/unshare.2
> @@ -474,7 +474,7 @@ new shell are in separate mount namespaces:
> .EX
> $ \fBreadlink /proc/$$/ns/mnt\fP
> mnt:[4026531840]
> -$ \fBsudo ./unshare -m /bin/bash\fP
> +$ \fBsudo ./unshare \-m /bin/bash\fP
> # \fBreadlink /proc/$$/ns/mnt\fP
> mnt:[4026532325]
> .EE
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
prev parent reply other threads:[~2020-07-02 10:26 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-07-01 22:08 [PATCH] man2/*: ffix, change '-' to '\-' for options Bjarni Ingi Gislason
2020-07-02 10:26 ` Michael Kerrisk (man-pages) [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=af6422ad-41e3-c1bd-aec4-0f5e2f12103e@gmail.com \
--to=mtk.manpages@gmail.com \
--cc=bjarniig@rhi.hi.is \
--cc=linux-man@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).