]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
man/man3/getopt.3: Remove _<PID>_GNU_nonoption_argv_flags_ description
authorAhelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Wed, 18 Dec 2024 14:35:28 +0000 (15:35 +0100)
committerAlejandro Colomar <alx@kernel.org>
Thu, 19 Dec 2024 11:07:35 +0000 (12:07 +0100)
Per <https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=bf079e19f50d64aa5e05b5e17ec29afab9aabb20>:
-  this was set by bash 2.0 (1996-12)
   (implemented in glibc b07c5668f672125074dd5b0b658145e1544120be)
-  it's no longer set by bash 2.01 (1997-06) because it was bad
-  glibc disabled this with no way to enable it in 2001-08
   (518a0dd201c48a5c15d73c1919c304a9f8f5e3c1)
-  glibc removed it in 2017 bf079e19f50d64aa5e05b5e17ec29afab9aabb20

So this was experienced by people for 5 months at best,
and could remotely be experienced for 3 years
(if you somehow wanted this bad behaviour and added it into your shell),
over 20 years ago.
No modern reader (or, frankly, non-modern reader)
has ever used this, or could use it, really.

Link to the removal note for completeness only.

Link: <https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=bf079e19f50d64aa5e05b5e17ec29afab9aabb20>
Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-Id: <dwfybzlb5ydbsc4puo6igj7nm7iregquv6hxhhqb53bwrvqswb@tarta.nabijaczleweli.xyz>
[alx: Add break points in URI; minor tweaks to commit message too]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
man/man3/getopt.3

index 67c3ec9b389781821fb91e7253d49e0377dd2145..724f07f080b12dacce3a5b106300cb3fbe2c29ae 100644 (file)
@@ -318,15 +318,6 @@ ambiguous match or an extraneous parameter.
 .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 @@ POSIX.1-1996 marked the use of
 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=bf079e19f50d64aa5e05
+.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,