Is the description of set -- missing in man bash or at least difficult to find?

[Peng Yu]

Hi,

As I mentioned previously, there are shortcomings in man bash. Here, I
just point another example. And I hope my suggestion will be
addressed.

As a reasonable search strategy to search for how to set $@ is to
search for '$@' in man bash. The literal word '$@' appears at the
following locations.

...performed,  with the exception of "$@" as explained below under Special...
...expands to a separate word.  That is, "$@" is equivalent to "$1"...
...When there are no positional parameters, "$@" and $@  expand  to...
...of "$@" and "${name[@]}" as explained above (see PARAMETERS)...

Search for 'set --' returns nothing. And search for '--' is prohibited
as there are too many of them. If the manual discusses how to 'set
$@', then it is at least hard to find. My suggestion is to add a new
paragraph to the existing discussion of $@, so that by searching $@,
readers can easily see how set $@.

       @      Expands  to  the positional parameters, starting from one.  When
              the  expansion  occurs  within  double  quotes,  each  parameter
              expands to a separate word.  That is, "$@" is equivalent to "$1"
              "$2" ...  If the double-quoted expansion occurs within  a  word,
              the  expansion  of the first parameter is joined with the begin-
              ning part of the original word, and the expansion  of  the  last
              parameter  is  joined  with  the last part of the original word.
              When there are no positional parameters, "$@" and $@  expand  to
              nothing (i.e., they are removed).

As others pointed out LDP/abs is a more readable document, the
following link is a much better document on helping me to find how to
set "$@".

http://tldp.org/LDP/abs/html/internalvariables.html

-- 
Regards,
Peng