Go to the previous, next section.
þ
The following options may be set upon invocation of the shell, or with
the set
or setopt
builtins. The names are
case-insensitive and underscores are ignored, that is, `allexport'
is equivalent to `A_lleXP_ort'.
þ
þ
ALL_EXPORT (-a)
- All parameters subsequently defined are automatically exported.
þ
þ
ALWAYS_LAST_PROMPT
- If unset, key functions that list completions try to return to the last
prompt if given a numeric argument. If set, these functions try to
return to the last prompt if given no numeric argument.þ
ALWAYS_TO_END
- If a completion with the cursor in the word was started and it results
in only one match, the cursor is placed at the end of the word.
þ
APPEND_HISTORY
- If this is set, zsh sessions will append their history list to the
history file, rather than overwrite it. Thus, multiple parallel zsh
sessions will all have their history lists added to the history file, in
the order they are killed. See section Shell Builtin Commands, for the
fc
command.þ
þ
AUTO_CD (-J)
- If a command is not in the hash table, and there exists an executable
directory by that name, perform the
cd
command to that directory.
þ
þ
AUTO_LIST (-9)
- Automatically list choices on an ambiguous completion.
þ
þ
AUTO_MENU
- Automatically use menu completion after the second consecutive request
for completion, for example by pressing the TAB key repeatedly.
This option is overriden by
MENU_COMPLETE
.þ
þ
AUTO_NAME_DIRS
- Any parameter that is set to the absolute name of a directory
immediately becomes a name for that directory in the usual form
~param
. If this option is not set, the parameter must be used in
that form for it to become a name (a command-line completion is
sufficient for this).þ
AUTO_PARAM_KEYS
- If a parameter name was completed and the next character typed is one of
those that have to come directly after the name (like
}
,
:
, etc.), they are placed there automatically.þ
þ
þ
AUTO_PUSHD (-N)
- Make
cd
act like pushd
.
þ
þ
AUTO_REMOVE_SLASH
- When the last character resulting from a completion is a slash and the next
character typed is a word delimiter, remove the slash.þ
þ
þ
AUTO_RESUME (-W)
- Treat single word simple commands without redirection as candidates for
resumption of an existing job.
þ
þ
þ
BGNICE (-6)
- Run all background jobs at a lower priority. This option is set by
default.
þ
þ
þ
BRACE_CCL
- Allow brace expansions of the form
{a-zA-Z}
, etc.
þ
þ
CDABLE_VARS (-T)
- If the argument to a
cd
command (or an implied cd with the
AUTO_CD
option set) is not a directory, and does not begin with a
slash, try to expand the expression as if it were preceded by a
~
(see section Filename Expansion).þ
þ
þ
CHASE_LINKS (-w)
- Resolve symbolic links to their true values.
þ
þ
COMPLETE_ALIASES
- If set, aliases on the command line are not internally substituted
before completion is attempted.
þ
COMPLETE_IN_WORD
- If unset, the cursor is moved to the end of the word if completion is
started. Otherwise it stays where it is and completion is done from
both ends.
þ
þ
þ
CORRECT (-0)
- Try to correct the spelling of commands.
þ
CORRECT_ALL (-O)
- Try to correct the spelling of all arguments in a line.
þ
þ
CSH_JUNKIE_HISTORY
- A history reference without an event specifier will always refer to the
previous command.
þ
þ
þ
CSH_JUNKIE_LOOPS
- Allow loop bodies to take the form `list; end' instead of
`do list; done'.þ
CSH_JUNKIE_PAREN
- Allow
for
, if
and while
loops where the argument
list is given in parentheses. Otherwise, the parentheses will be
treated as specifying a subshell.þ
þ
þ
CSH_JUNKIE_QUOTES
- Complain if a quoted expression runs off the end of a line; prevent
quoted expressions from containing unescaped newlines.
þ
GLOB_SUBST
- Treat any characters resulting from parameter substitution as being
eligible for file expansion and filename generation, and any characters
resulting from command substitution as being eligible for filename
generation.þ
þ
þ
þ
CSH_NULL_GLOB
- If a pattern for filename generation has no matches, delete the pattern
from the argument list; do not report an error unless all the patterns
in a command have no matches. Overrides
NULL_GLOB
.þ
þ
ERR_EXIT (-e)
- If a command has a non-zero exit status, execute the
ZERR
trap, if
set, and exit.þ
þ
EXTENDED_GLOB
- Treat the
#
and ^
characters as part of patterns for
filename generation, etc. An initial unquoted ~
always produces
named directory expansion (see section Filename Expansion).þ
þ
EXTENDED_HISTORY
- Save beginning and ending timestamps to the history file. The format of
these timestamps is
:<beginning time>:<ending
time>
:<command>.þ
GLOB_COMPLETE
- When the current word has a glob pattern, do not insert all the words
resulting from the expansion but cycle through them like
MENU_COMPLETE
. If no matches are found, a *
is added to
the end of the word, or inserted at the cursor if
COMPLETE_IN_WORD
is set, and completion is attempted again.
Using patterns works not only for files but for all completions, such as
options, user names, etc.þ
þ
GLOB_DOTS (-4)
- Do not require a leading
.
in a filename to be matched
explicitly.þ
þ
þ
HASH_CMDS
- Place the location of each command in the hash table the first time it
is executed. If this option is unset, no path hashing will be done at
all.þ
þ
þ
HASH_DIRS
- Whenever a command is executed, hash the directory containing it, as
well as all directories that occur earlier in the path. Has no effect
if
HASH_CMDS
is unset.þ
HASH_LIST_ALL
- Whenever a command completion is attempted, make sure the entire command
path is hashed first. This makes the first completion slower.
þ
þ
HIST_IGNORE_DUPS (-h)
- Do not enter command lines into the history list if they are duplicates
of the previous event.
þ
þ
HIST_IGNORE_SPACE (-g)
- Do not enter command lines into the history list if they begin with a
blank.
þ
þ
HIST_LIT (-j)
- Use literal (unparsed) versions of the history lines in the editor.
þ
HIST_NO_STORE
- Remove the
history
(fc -l
) command from the history
when invoked.þ
þ
HIST_VERIFY
- Whenever the user enters a line with history substitution, don't execute
the line directly; instead, perform history substitution and reload the
line into the editing buffer.
þ
þ
þ
þ
IGNORE_BRACES (-I)
- Do not perform brace expansion.
þ
þ
IGNORE_EOF (-7)
- Do not exit on end-of-file. Require the use of
exit
or
logout
instead.þ
INTERACTIVE (-i)
- This is an interactive shell.
þ
þ
INTERACTIVE_COMMENTS (-k)
- Allow comments even in interactive shells.
þ
þ
þ
KSH_OPTION_PRINT
- Alters the way options settings are printed.
þ
þ
þ
LIST_AMBIGUOUS
- If this option is set completions are shown only if the completions
don't have an unambiguous prefix or suffix that could be inserted in the
command line.
þ
þ
þ
LIST_TYPES (-X)
- When listing files that are possible completions, show the type of each
file with a trailing identifying mark.
þ
LOGIN (-l)
- This is a login shell.
þ
þ
þ
LONG_LIST_JOBS (-R)
- List jobs in the long format by default.
þ
MAGIC_EQUAL_SUBST
- All unquoted arguments of the form
identifier=expression
have file expansion performed
on expression as if it were a parameter assignment, although the
argument is not otherwise treated specially.þ
þ
MAIL_WARNING (-U)
- Print a warning message if a mail file has been accessed since the shell
last checked.
þ
þ
þ
MARK_DIRS (-8)
- Append a trailing
/
to all directory names resulting from filename
generation (globbing).þ
þ
MENU_COMPLETE (-Y)
- On an ambiguous completion, instead of listing possibilities or beeping,
insert the first match immediately. Then when completion is requested
again, remove the first match and insert the second match, etc. When
there are no more matches, go back to the first one again.
reverse-menu-complete
may be used to loop through the list in the
other direction. This option overrides AUTO_MENU
.þ
þ
MONITOR (-m)
- Allow job control. Set by default in interactive shells.
þ
þ
NO_BAD_PATTERN (-2)
- If a pattern for filename generation is badly formed, leave it unchanged
in the argument list instead of printing an error.
þ
þ
þ
NO_BANG_HIST (-K)
- Do not perform textual history substitution. Do not treat the
!
character specially.þ
þ
þ
NO_BEEP (-B)
- Do not beep.
þ
þ
þ
NO_CLOBBER (-1)
- Prevents
>
redirection from truncating existing files. >!
may be used to truncate a file instead. Also prevents >>
from
creating files. >>!
may be used instead.þ
þ
NO_EQUALS
- Don't perform
=
filename substitution.
þ
þ
NO_EXEC (-n)
- Read commands and check them for syntax errors, but do not execute them.
þ
þ
NO_FLOW_CONTROL
- Disable output flow control via start/stop characters (usually assigned
to ^S/^Q) in the shell's editor.þ
þ
þ
NO_GLOB (-F)
- Disable filename generation.
þ
þ
þ
NO_HIST_BEEP
- Don't beep when an attempt is made to access a history entry which isn't
there.
þ
þ
NO_HUP
- Don't send the
HUP
signal to running jobs when the shell exits.
þ
þ
þ
NO_LIST_BEEP
- Don't beep on an ambiguous completion.
þ
þ
NO_NOMATCH (-3)
- If a pattern for filename generation has no matches, leave it unchanged
in the argument list instead of printing an error. This also applies
to file expansion of an initial
~
or =
.þ
þ
NO_PROMPT_CR (-V)
- Don't print a carriage return just before printing a prompt in the line
editor.
þ
þ
NO_RCS (-f)
- Source only the `/etc/zshenv' file.
Do not source the `.zshenv', `/etc/zprofile', `.zprofile',
`/etc/zshrc', `.zshrc', `/etc/zlogin', `.zlogin', or
`.zlogout' files.þ
NO_SHORT_LOOPS
- Disallow the short forms of
for
, select
, if
, and
function
constructs.þ
þ
þ
NOTIFY (-5)
- Report the status of background jobs immediately, rather than waiting
until just before printing a prompt.
þ
þ
þ
NO_UNSET (-u)
- Treat unset parameters as an error when substituting.
þ
þ
NULL_GLOB (-G)
- If a pattern for filename generation has no matches, delete the pattern
from the argument list instead of reporting an error. Overrides
NO_NOMATCH
.þ
þ
NUMERIC_GLOBSORT
- If numeric filenames are matched by a filename generation pattern, sort
the filenames numerically rather than lexicographically.
þ
þ
þ
OVERSTRIKE
- Start up the line editor in overstrike mode.
þ
þ
PATH_DIRS (-Q)
- Perform a path search even on command names with slashes in them. Thus
if
`/usr/local/bin' is in the user's path, and he types
`X11/xinit', the command `/usr/local/bin/X11/xinit' will be
executed (assuming it exists). This applies to the .
builtin as
well as to command execution. Commands explicitly beginning with
`./' or `../' are not subject to path search.þ
þ
PRINT_EXIT_VALUE (-C)
- Print the exit value of programs with non-zero exit status.
þ
PROMPT_SUBST
- Expressions like
${...}
, $(...)
, and $[...]
in prompts will be expanded.þ
þ
PUSHD_IGNORE_DUPS
- Don't push multiple copies of the same directory onto the directory
stack.
þ
þ
PUSHD_MINUS
- See section Shell Builtin Commands, for the
popd
command.
þ
þ
PUSHD_SILENT (-E)
- Do not print the directory stack after
pushd
or popd
.
þ
þ
PUSHD_TO_HOME (-D)
- Have
pushd
with no arguments act like pushd $HOME
.
þ
RC_EXPAND_PARAM (-P)
- See section Parameter Expansion.
þ
þ
þ
RC_QUOTES
- Allow the character sequence
"
to signify a single quote within
singly quoted strings.þ
þ
REC_EXACT (-S)
- In completion, recognize exact matches even if they are ambiguous.
þ
þ
þ
RM_STAR_SILENT (-H)
- Do not query the user before executing
rm *
or rm path/*
.
þ
SHIN_STDIN (-s)
- Read commands from the standard input.
þ
þ
þ
SH_WORD_SPLIT (-y)
- See section Parameter Expansion.
þ
þ
SINGLE_LINE_ZLE (-M)
- Use single-line command line editing instead of multi-line.
þ
þ
þ
SUN_KEYBOARD_HACK (-L)
- If a line ends with a backquote, and there are an odd number of
backquotes on the line, ignore the trailing backquote. This is useful
on some keyboards where the return key is too small, and the backquote
key lies annoyingly close to it.
þ
þ
VERBOSE (-v)
- Print shell input lines as they are read.
þ
þ
XTRACE (-x)
- Print commands and their arguments as they are executed.
þ
þ
þ
ZLE (-Z)
- Use the zsh line editor.
Go to the previous, next section.