summaryrefslogtreecommitdiff
path: root/Doc/help/set
blob: cb5637e1ae939ea558db95e82bb832cdf7d8b0e6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
set [ {+|-}options | {+|-}o [ option_name ] ] ... [ {+|-}A [ name ] ]
    [ arg ... ]
       Set  the options for the shell and/or set the positional parame-
       ters, or declare and set an array.  If the -s option  is  given,
       it  causes the specified arguments to be sorted before assigning
       them to the positional parameters (or to the array name if -A is
       used).   With  +s  sort  arguments in descending order.  For the
       meaning of the other flags, see  zshoptions(1).   Flags  may  be
       specified by name using the -o option. If no option name is sup-
       plied with -o, the current option states are printed:   see  the
       description  of setopt below for more information on the format.
       With +o they are printed in a form that can be used as input  to
       the shell.

       If  the -A flag is specified, name is set to an array containing
       the given args; if no name is specified, all arrays are  printed
       together with their values.

       If +A is used and name is an array, the given arguments will re-
       place the initial elements of that array; if no name  is  speci-
       fied, all arrays are printed without their values.

       The  behaviour  of arguments after -A name or +A name depends on
       whether the option KSH_ARRAYS is set.  If it is not set, all ar-
       guments  following name are treated as values for the array, re-
       gardless of their form.  If the option  is  set,  normal  option
       processing  continues  at that point; only regular arguments are
       treated as values for the array.  This means that

              set -A array -x -- foo

       sets array to `-x -- foo' if KSH_ARRAYS is not set, but sets the
       array to foo and turns on the option `-x' if it is set.

       If  the  -A  flag is not present, but there are arguments beyond
       the options, the positional parameters are set.  If  the  option
       list  (if  any)  is terminated by `--', and there are no further
       arguments, the positional parameters will be unset.

       If no arguments and no `--' are given, then the names and values
       of  all  parameters  are printed on the standard output.  If the
       only argument is `+', the names of all parameters are printed.

       For historical reasons, `set -' is treated as `set +xv' and `set
       -  args'  as  `set +xv -- args' when in any other emulation mode
       than zsh's native mode.