From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 20411C001DF for ; Sun, 30 Jul 2023 19:00:30 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229476AbjG3TA3 (ORCPT ); Sun, 30 Jul 2023 15:00:29 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37778 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229452AbjG3TA2 (ORCPT ); Sun, 30 Jul 2023 15:00:28 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 91DB8C3 for ; Sun, 30 Jul 2023 12:00:27 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 21DD060C8C for ; Sun, 30 Jul 2023 19:00:27 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id E8EB8C433C8; Sun, 30 Jul 2023 19:00:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1690743626; bh=jIVogHJNa+PpfqwKHaRNVipzIOS/joo8Tzsgu7rQL/Y=; h=Date:Subject:To:Cc:References:From:In-Reply-To:From; b=dNpZ6h+kaguuMtyykf4V0HiQTvUXyHPCeBr+UDqMlX+wjWQhDcB1VeE9cU+le/P80 nO84zrIiUDYk1/TG+fQ4dGs44zjXibY8rCvUko77Bg4QmgyTh6Ahn8L0cVc0R4fhGg BBTK8scc1xAuu/RI1KN5y0IQupNFKAhxUcL7+DlIlpuvfqHDEpg73AkVdjD42RoZfI Qmv3wYuJR5B0NtsSX1mADAfswWsfILF9JRK2WeCFfkfMIWeh4TsBrufb2Gf3E9I7Yy Ue9rRBW1w1ggW62n9pWSAsJrijnLJ9XPWAxJgfePOVfuKJKkKcVDdAlUEbyIqrtywj qXoMnFBZSFdmQ== Message-ID: <780b9abd-7422-2d3c-27b2-beb13191bb32@kernel.org> Date: Sun, 30 Jul 2023 21:00:23 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.13.1 Subject: Re: [PATCH] man*/: srcfix To: "G. Branden Robinson" Cc: linux-man@vger.kernel.org References: <20230730175256.63fzulvoqvzay3ff@illithid> Content-Language: en-US From: Alejandro Colomar Organization: Linux In-Reply-To: <20230730175256.63fzulvoqvzay3ff@illithid> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="------------rxcxsL00m1TReuNDC20x7oT3" Precedence: bulk List-ID: X-Mailing-List: linux-man@vger.kernel.org This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --------------rxcxsL00m1TReuNDC20x7oT3 Content-Type: multipart/mixed; boundary="------------nCoE2fh7cE4wAZXQwEC9bDAj"; protected-headers="v1" From: Alejandro Colomar To: "G. Branden Robinson" Cc: linux-man@vger.kernel.org Message-ID: <780b9abd-7422-2d3c-27b2-beb13191bb32@kernel.org> Subject: Re: [PATCH] man*/: srcfix References: <20230730175256.63fzulvoqvzay3ff@illithid> In-Reply-To: <20230730175256.63fzulvoqvzay3ff@illithid> --------------nCoE2fh7cE4wAZXQwEC9bDAj Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On 2023-07-30 19:52, G. Branden Robinson wrote: > Clean up in preparation for "MR sed". >=20 > Format only one man page cross reference per input line. >=20 > Also, since groff 1.23.0 (and Plan 9 from User Space's) `MR` is not a > font style alternation macro, there is no "reversed" form as with `BR` > and `RB`. So when a man page cross reference must be immediately > preceded by punctuation, put that punctuation on the previous text line= > and use the `\c` escape sequence to connect them. >=20 > Signed-off-by: "G. Branden Robinson" > --- > man2/eventfd.2 | 4 +++- > man2/open.2 | 9 +++++++-- > man2/perf_event_open.2 | 7 ++++++- > man2/signalfd.2 | 4 +++- > man2/timerfd_create.2 | 4 +++- > man5/proc.5 | 4 +++- > man7/credentials.7 | 15 ++++++++++----- > man7/pty.7 | 5 ++++- > man7/spufs.7 | 6 +++++- > 9 files changed, 44 insertions(+), 14 deletions(-) >=20 > diff --git a/man2/eventfd.2 b/man2/eventfd.2 > index 2bd781bdf..003a64eb6 100644 > --- a/man2/eventfd.2 > +++ b/man2/eventfd.2 > @@ -142,7 +142,9 @@ .SH DESCRIPTION > if the size of the supplied buffer is less than 8 bytes, > or if an attempt is made to write the value 0xffffffffffffffff. > .TP > -.BR poll "(2), " select "(2) (and similar)" > +.BR poll (2),\~\c > +.BR select (2)\~\c > +(and similar) > The returned file descriptor supports > .BR poll (2) > (and analogously > diff --git a/man2/open.2 b/man2/open.2 > index 4c921723c..6603dfdff 100644 > --- a/man2/open.2 > +++ b/man2/open.2 > @@ -82,8 +82,13 @@ .SH DESCRIPTION > to an entry in the process's table of open file descriptors. > The file descriptor is used > in subsequent system calls > -.RB ( read "(2), " write "(2), " lseek "(2), " fcntl (2), > -etc.) to refer to the open file. > +(\c > +.BR read (2), > +.BR write (2), > +.BR lseek (2), > +.BR fcntl (2), > +etc.) > +to refer to the open file. > The file descriptor returned by a successful call will be > the lowest-numbered file descriptor not currently open for the process= =2E > .PP > diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 > index aa23a4977..40686917b 100644 > --- a/man2/perf_event_open.2 > +++ b/man2/perf_event_open.2 > @@ -32,7 +32,12 @@ .SH DESCRIPTION > Given a list of parameters, > .BR perf_event_open () > returns a file descriptor, for use in subsequent system calls > -.RB ( read "(2), " mmap "(2), " prctl "(2), " fcntl "(2), etc.)." > +(\c > +.BR read (2), > +.BR mmap (2), > +.BR prctl (2), > +.BR fcntl (2), > +etc.). > .PP > A call to > .BR perf_event_open () > diff --git a/man2/signalfd.2 b/man2/signalfd.2 > index 2b97c4640..9d0708799 100644 > --- a/man2/signalfd.2 > +++ b/man2/signalfd.2 > @@ -131,7 +131,9 @@ .SH DESCRIPTION > .B EAGAIN > if the file descriptor has been made nonblocking. > .TP > -.BR poll "(2), " select "(2) (and similar)" > +.BR poll (2),\~\c > +.BR select (2)\~\c > +(and similar) > The file descriptor is readable > (the > .BR select (2) > diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2 > index d68206b05..9ba0dd315 100644 > --- a/man2/timerfd_create.2 > +++ b/man2/timerfd_create.2 > @@ -317,7 +317,9 @@ .SS Operating on a timer file descriptor > .BR read (2) > on the file descriptor. > .TP > -.BR poll "(2), " select "(2) (and similar)" > +.BR poll (2),\~\c > +.BR select (2)\~\c > +(and similar) > The file descriptor is readable > (the > .BR select (2) > diff --git a/man5/proc.5 b/man5/proc.5 > index 04b45ccb7..fd51dcec0 100644 > --- a/man5/proc.5 > +++ b/man5/proc.5 > @@ -3459,7 +3459,9 @@ .SS Files and directories > .TP > .I /proc/locks > This file shows current file locks > -.RB ( flock "(2) and " fcntl (2)) > +.RB ( flock (2) > +and > +.BR fcntl (2)) > and leases > .RB ( fcntl (2)). > .IP > diff --git a/man7/credentials.7 b/man7/credentials.7 > index 77cb5e0ef..4bf908a8e 100644 > --- a/man7/credentials.7 > +++ b/man7/credentials.7 > @@ -267,21 +267,26 @@ .SS Modifying process user and group IDs > Subject to rules described in the relevant manual pages, > a process can use the following APIs to modify its user and group IDs:= > .TP > -.BR setuid "(2) (" setgid (2)) > +.BR setuid (2) \~(\c The opening parenthesis is incorrectly boldfaced. > +.BR setgid (2)) > Modify the process's real (and possibly effective and saved-set) > user (group) IDs. > .TP > -.BR seteuid "(2) (" setegid (2)) > +.BR seteuid (2) \~(\c > +.BR setegid (2)) > Modify the process's effective user (group) ID. > .TP > -.BR setfsuid "(2) (" setfsgid (2)) > +.BR setfsuid (2) \~(\c > +.BR setfsgid (2)) > Modify the process's filesystem user (group) ID. > .TP > -.BR setreuid "(2) (" setregid (2)) > +.BR setreuid (2) \~(\c > +.BR setregid (2)) > Modify the process's real and effective (and possibly saved-set) > user (group) IDs. > .TP > -.BR setresuid "(2) (" setresgid (2)) > +.BR setresuid (2) \~(\c > +.BR setresgid (2)) > Modify the process's real, effective, and saved-set user (group) IDs. > .TP > .BR setgroups (2) > diff --git a/man7/pty.7 b/man7/pty.7 > index bef60e931..3f23be44d 100644 > --- a/man7/pty.7 > +++ b/man7/pty.7 > @@ -122,7 +122,10 @@ .SH FILES > BSD slave devices > .SH NOTES > Pseudoterminals are used by applications such as network login service= s > -.RB ( ssh "(1), " rlogin "(1), " telnet (1)), > +(\c > +.BR ssh (1), > +.BR rlogin (1), > +.BR telnet (1)), > terminal emulators such as > .BR xterm (1), > .BR script (1), > diff --git a/man7/spufs.7 b/man7/spufs.7 > index 39fdf583a..96b100b8c 100644 > --- a/man7/spufs.7 > +++ b/man7/spufs.7 > @@ -119,7 +119,11 @@ .SS Files > file are: > .RS > .TP > -.BR read "(2), " pread "(2), " write "(2), " pwrite "(2), " lseek (2) > +.BR read (2),\~\c > +.BR pread (2),\~\c > +.BR write (2),\~\c > +.BR pwrite (2),\~\c > +.BR lseek (2) > These operate as usual, with the exception that > .BR lseek (2), > .BR write (2), --=20 GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 --------------nCoE2fh7cE4wAZXQwEC9bDAj-- --------------rxcxsL00m1TReuNDC20x7oT3 Content-Type: application/pgp-signature; name="OpenPGP_signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="OpenPGP_signature" -----BEGIN PGP SIGNATURE----- iQIzBAEBCgAdFiEE6jqH8KTroDDkXfJAnowa+77/2zIFAmTGs0cACgkQnowa+77/ 2zLj1A/8C9yJI+zcHWvNTAUERp4EgF6Jity3Rox+/nBNw174VtTIMW4QCAtBkAQN DZ2ys6FgyZZKVvqJJ9teaf/hsxE5/H897IEOQGdXnAOy+xRQCwfda6RrdwyS3wjO BPt+v0XOs5kn16xVCevTyqHuGcaZgA7zwudOFaJWmmRU0ts4bVz/1tWHmlCaIfEN R7mmsI+PrJl3KBgcqNS1pGSWa7xSTOD0iryEtPISFv4L12CC8oaEMsrKdEyHVj5+ AGVQdBd02ngjj/e21QqPbFzYKdZilN2QQHlmzsexWOpo1o1NPSW4b15QFn3QM3Te Bc0LwSzLjj1jjojpxq1fV20s34QPSk18oPc5ZkCCVz0IbP4vCTqVdlawpUI4sHLp pG6J0DnA7yBdThHuUgwh18QQGVAs6R2Ki3eKHm/HEaRPLincl4jjw6CFa8pGhuiX MPPJB0eRpcMH8CIDtAFIPCQL/mmfr6uWtKM9jupZN3tBiixMu4jw3QKHfMAFjXqr CBR27Q3txmPq0af/NQUu07UQ3/WbLdzRR+M7FFgCD9JROLmN/vUt7xoRdhI3ue8W 7immLAPX6cvHgAW6BApE1vkPzfXHMLPqz3dRVQSSB/C8yiYClikZEa+k1+Y24ryG JNM3lt0b4oQb2kFEq7ZoLkglp1csQdIBuchgwwwleRNyTb+64hI= =Ec7f -----END PGP SIGNATURE----- --------------rxcxsL00m1TReuNDC20x7oT3--