From: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Date: Wed, 18 Dec 2024 14:35:28 +0000 (+0100)
Subject: man/man3/getopt.3: Remove _<PID>_GNU_nonoption_argv_flags_ description
X-Git-Tag: man-pages-6.10~49
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bc34639b160d8bd3d3daf748e8a54bc1df429901;p=thirdparty%2Fman-pages.git

man/man3/getopt.3: Remove _<PID>_GNU_nonoption_argv_flags_ description

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

diff --git a/man/man3/getopt.3 b/man/man3/getopt.3
index 67c3ec9b3..724f07f08 100644
--- a/man/man3/getopt.3
+++ b/man/man3/getopt.3
@@ -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,