Thread (7 messages) 7 messages, 3 authors, 2024-12-19

Re: [PATCH v2] getopt.3: remove _<PID>_GNU_nonoption_argv_flags_ description

From: Alejandro Colomar <alx@kernel.org>
Date: 2024-12-19 11:08:39
Subsystem: the rest · Maintainer: Linus Torvalds

Hi,

On Wed, Dec 18, 2024 at 07:45:42PM +0100, Alejandro Colomar wrote:
quoted
Signed-off-by: Ahelenia Ziemiańska <redacted>
Thanks!  I've applied the patch, plus minor tweaks for the issues above.
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=fed899f4cd6149daa8c9a0f4c352728eadfd9d77>
I've had to amend the patch again.  I didn't notice that it caused many
warnings in -Tutf8, -Thtml, -Tps, and -Tpdf output.  I've applied the
following diff.
diff --git a/man/man3/getopt.3 b/man/man3/getopt.3
index 3b0025528..cb946355a 100644
--- a/man/man3/getopt.3
+++ b/man/man3/getopt.3
@@ -384,7 +384,7 @@ .SH HISTORY
 .IR <stdio.h> .
 .P
 Very old versions of glibc were affected by a
-.UR https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=bf079e19f50d64aa5e05b5e17ec29afab9aabb20
+.UR https://\:sourceware.org/\:git/\:?p=glibc.git;a=commitdiff;h=bf079e19f50d64aa5e05
 .BI _ PID _GNU_nonoption_argv_flags_
 environment variable
 .UE .

That adds break points, and also reduces the hash by half (which should
hold without clashes forever, hopefully).  I've kept the full URI in the
commit message, just in case (and BTW, it's good to have the URI in the
commit message anyway).  After this diff, the warning disappears.

<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=bc34639b160d8bd3d3daf748e8a54bc1df429901>


Have a lovely day!
Alex

quoted
---
 man/man3/getopt.3 | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)
diff --git a/man/man3/getopt.3 b/man/man3/getopt.3
index 67c3ec9b3..9a84e2f44 100644
--- a/man/man3/getopt.3
+++ b/man/man3/getopt.3
@@ -318,15 +318,6 @@ .SH ENVIRONMENT
 .B POSIXLY_CORRECT
 If this is set, then option processing stops as soon as a nonoption
 argument is encountered.
-.TP
-.B _<PID>_GNU_nonoption_argv_flags_
-This variable was used by
-.BR bash (1)
-2.0 to communicate to glibc which arguments are the results of
-wildcard expansion and so should not be considered as options.
-This behavior was removed in
-.BR bash (1)
-2.01, but the support remains in glibc.
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
@@ -391,6 +382,12 @@ .SH HISTORY
 for this purpose as LEGACY.
 POSIX.1-2001 does not require the declaration to appear in
 .IR <stdio.h> .
+.P
+Very old versions of glibc were affected by a
+.UR https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=bf079e19f50d64aa5e05b5e17ec29afab9aabb20
+.BI _ PID _GNU_nonoption_argv_flags_
+environment variable
+.UE .
 .SH NOTES
 A program that scans multiple argument vectors,
 or rescans the same vector more than once,
-- 
2.39.5


-- 
<https://www.alejandro-colomar.es/>


-- 
<https://www.alejandro-colomar.es/>

Attachments

Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help