linux-man.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
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/

      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).