From: Alejandro Colomar <alx@kernel.org>
To: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: linux-man@vger.kernel.org
Subject: Re: [PATCH v2] man/man3/getopt.3: ffix
Date: Wed, 24 Dec 2025 11:03:21 +0100 [thread overview]
Message-ID: <aUu6CrfBstpApFeR@devuan> (raw)
In-Reply-To: <20251219171602.6255ekvsx24ocub3@illithid>
[-- Attachment #1: Type: text/plain, Size: 2578 bytes --]
Hi Branden,
On Fri, Dec 19, 2025 at 11:16:02AM -0600, G. Branden Robinson wrote:
> Protect literals from hyphenation.
>
> Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
> ---
> man/man3/getopt.3 | 14 +++++++-------
> 1 file changed, 7 insertions(+), 7 deletions(-)
>
> diff --git a/man/man3/getopt.3 b/man/man3/getopt.3
> index e7518192d..da390a1dc 100644
> --- a/man/man3/getopt.3
> +++ b/man/man3/getopt.3
> @@ -137,14 +137,14 @@ .SH DESCRIPTION
> If the first character of
> .I optstring
> is \[aq]+\[aq] or the environment variable
> -.B POSIXLY_CORRECT
> +.B \%POSIXLY_CORRECT
I was wondering if we could write a script based on yours for finding
all places that need such a change.
Have a lovely day!
Alex
> is set, then option processing stops as soon as a nonoption argument is
> encountered.
> If \[aq]+\[aq] is not the first character of
> .IR optstring ,
> it is treated as a normal option.
> If
> -.B POSIXLY_CORRECT
> +.B \%POSIXLY_CORRECT
> behaviour is required in this case
> .I optstring
> will contain two \[aq]+\[aq] symbols.
> @@ -221,7 +221,7 @@ .SH RETURN VALUE
> otherwise \[aq]?\[aq] is returned.
> .SH ENVIRONMENT
> .TP
> -.B POSIXLY_CORRECT
> +.B \%POSIXLY_CORRECT
> If this is set, then option processing stops as soon as a nonoption
> argument is encountered.
> .SH ATTRIBUTES
> @@ -249,7 +249,7 @@ .SH VERSIONS
> .IR const ,
> but these functions permute its elements
> unless the environment variable
> -.B POSIXLY_CORRECT
> +.B \%POSIXLY_CORRECT
> is set.
> .I const
> is used in the actual prototype to be compatible with other systems;
> @@ -284,7 +284,7 @@ .SH HISTORY
> .P
> Very old versions of glibc were affected by a
> .UR https://\:sourceware.org/\:git/\:?p=glibc.git;a=commitdiff;h=bf079e19f50d64aa5e05
> -.BI _ PID _GNU_nonoption_argv_flags_
> +.BI \%_ PID _GNU_nonoption_argv_flags_
> environment variable
> .UE .
> .SH NOTES
> @@ -294,7 +294,7 @@ .SH NOTES
> and \[aq]\-\[aq] at the start of
> .IR optstring ,
> or changes the value of
> -.B POSIXLY_CORRECT
> +.B \%POSIXLY_CORRECT
> between scans,
> must reinitialize
> .BR getopt ()
> @@ -303,7 +303,7 @@ .SH NOTES
> to 0, rather than the traditional value of 1.
> (Resetting to 0 forces the invocation of an internal initialization
> routine that rechecks
> -.B POSIXLY_CORRECT
> +.B \%POSIXLY_CORRECT
> and checks for GNU extensions in
> .IR optstring .)
> .P
> --
> 2.30.2
--
<https://www.alejandro-colomar.es>
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
prev parent reply other threads:[~2025-12-24 10:03 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-12-19 17:16 [PATCH v2] man/man3/getopt.3: ffix G. Branden Robinson
2025-12-23 21:36 ` Alejandro Colomar
2025-12-24 10:03 ` Alejandro Colomar [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=aUu6CrfBstpApFeR@devuan \
--to=alx@kernel.org \
--cc=g.branden.robinson@gmail.com \
--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).