New upstream version 5.8.1.2-test

1 files changed, 8 insertions, 7 deletions

diff --git a/Doc/help/getopts b/Doc/help/getopts
index ef73c55c1..bb89d2f2a 100644
--- a/Doc/help/getopts
+++ b/Doc/help/getopts
@@ -16,15 +16,16 @@ getopts optstring name [ arg ... ]
        The first option to be examined may be changed by explicitly as-
        signing  to  OPTIND.   OPTIND  has an initial value of 1, and is
        normally set to 1 upon entry to a shell  function  and  restored
-       upon  exit (this is disabled by the POSIX_BUILTINS option).  OP-
-       TARG is not reset and retains its value  from  the  most  recent
-       call  to  getopts.   If either of OPTIND or OPTARG is explicitly
+       upon  exit.   (The POSIX_BUILTINS option disables this, and also
+       changes the way the value is calculated to match other  shells.)
+       OPTARG  is  not reset and retains its value from the most recent
+       call to getopts.  If either of OPTIND or  OPTARG  is  explicitly
        unset, it remains unset, and the index or option argument is not
        stored.  The option itself is still stored in name in this case.
 
        A leading `:' in optstring causes getopts to store the letter of
-       any invalid option in OPTARG, and to set name to `?' for an  un-
-       known  option  and  to  `:' when a required argument is missing.
-       Otherwise, getopts sets name to `?' and prints an error  message
-       when  an  option  is  invalid.   The exit status is nonzero when
+       any  invalid option in OPTARG, and to set name to `?' for an un-
+       known option and to `:' when a  required  argument  is  missing.
+       Otherwise,  getopts sets name to `?' and prints an error message
+       when an option is invalid.  The  exit  status  is  nonzero  when
        there are no more options.