1
0
Fork 0
mirror of git://git.code.sf.net/p/zsh/code synced 2024-05-19 22:46:03 +02:00

Allan Caffee <allan.caffee@gmail.com>: 26532:

index options under names without underscore, too
This commit is contained in:
Peter Stephenson 2009-02-07 22:30:34 +00:00
parent d0a52feee7
commit 4ed30bb21b
2 changed files with 147 additions and 2 deletions

View File

@ -1,3 +1,8 @@
2009-02-07 Peter Stephenson <p.w.stephenson@ntlworld.com>
* Allan Caffee <allan.caffee@gmail.com>: 26532: index option
names without underscore, too.
2009-02-04 Peter Stephenson <p.w.stephenson@ntlworld.com>
* unposted: Doc/Zsh/zle.yo: use of highlighting was out of
@ -11098,5 +11103,5 @@
*****************************************************
* This is used by the shell to define $ZSH_PATCHLEVEL
* $Revision: 1.4552 $
* $Revision: 1.4553 $
*****************************************************

View File

@ -55,6 +55,7 @@ are changed from the default.
subsect(Changing Directories)
startitem()
pindex(AUTO_CD)
pindex(AUTOCD)
cindex(cd, automatic)
item(tt(AUTO_CD) (tt(-J)))(
If a command is issued that can't be executed as a normal command,
@ -62,12 +63,14 @@ and the command is the name of a directory, perform the tt(cd)
command to that directory.
)
pindex(AUTO_PUSHD)
pindex(AUTOPUSHD)
cindex(cd, behaving like pushd)
cindex(pushd, making cd behave like)
item(tt(AUTO_PUSHD) (tt(-N)))(
Make tt(cd) push the old directory onto the directory stack.
)
pindex(CDABLE_VARS)
pindex(CDABLEVARS)
cindex(cd, to parameter)
item(tt(CDABLE_VARS) (tt(-T)))(
If the argument to a tt(cd) command (or an implied tt(cd) with the
@ -76,6 +79,7 @@ slash, try to expand the expression as if it were preceded by a `tt(~)' (see
noderef(Filename Expansion)).
)
pindex(CHASE_DOTS)
pindex(CHASEDOTS)
cindex(cd, with .. in argument)
item(tt(CHASE_DOTS))(
When changing to a directory containing a path segment `tt(..)' which would
@ -92,6 +96,7 @@ is tt(/foo/bar) and `tt(cd ..)' is used. Note that all other symbolic
links in the path will also be resolved.
)
pindex(CHASE_LINKS)
pindex(CHASELINKS)
cindex(links, symbolic)
cindex(symbolic links)
item(tt(CHASE_LINKS) (tt(-w)))(
@ -101,22 +106,26 @@ will be treated as referring to the physical parent, even if the preceding
path segment is a symbolic link.
)
pindex(PUSHD_IGNORE_DUPS)
pindex(PUSHDIGNOREDUPS)
cindex(directory stack, ignoring duplicates)
item(tt(PUSHD_IGNORE_DUPS))(
Don't push multiple copies of the same directory onto the directory stack.
)
pindex(PUSHD_MINUS)
pindex(PUSHDMINUS)
cindex(directory stack, controlling syntax)
item(tt(PUSHD_MINUS))(
Exchanges the meanings of `tt(PLUS())' and `tt(-)'
when used with a number to specify a directory in the stack.
)
pindex(PUSHD_SILENT)
pindex(PUSHDSILENT)
cindex(directory stack, silencing)
item(tt(PUSHD_SILENT) (tt(-E)))(
Do not print the directory stack after tt(pushd) or tt(popd).
)
pindex(PUSHD_TO_HOME)
pindex(PUSHDTOHOME)
cindex(pushd, to home)
item(tt(PUSHD_TO_HOME) (tt(-D)))(
Have tt(pushd) with no arguments act like `tt(pushd $HOME)'.
@ -126,12 +135,14 @@ enditem()
subsect(Completion)
startitem()
pindex(ALWAYS_LAST_PROMPT)
pindex(ALWAYSLASTPROMPT)
item(tt(ALWAYS_LAST_PROMPT) <D>)(
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 em(no) numeric argument.
)
pindex(ALWAYS_TO_END)
pindex(ALWAYSTOEND)
item(tt(ALWAYS_TO_END))(
If a completion is performed with the cursor within a word, and a
full completion is inserted, the cursor is moved to the end of the
@ -139,11 +150,13 @@ word. That is, the cursor is moved to the end of the word if either
a single match is inserted or menu completion is performed.
)
pindex(AUTO_LIST)
pindex(AUTOLIST)
cindex(completion, listing choices)
item(tt(AUTO_LIST) (tt(-9)) <D>)(
Automatically list choices on an ambiguous completion.
)
pindex(AUTO_MENU)
pindex(AUTOMENU)
cindex(completion, menu)
item(tt(AUTO_MENU) <D>)(
Automatically use menu completion after the second consecutive request for
@ -151,6 +164,7 @@ completion, for example by pressing the tab key repeatedly. This option
is overridden by tt(MENU_COMPLETE).
)
pindex(AUTO_NAME_DIRS)
pindex(AUTONAMEDIRS)
cindex(directories, named)
item(tt(AUTO_NAME_DIRS))(
Any parameter that is set to the absolute name of a directory
@ -161,6 +175,7 @@ is performed on a word starting with `tt(~)'.
(Otherwise, the parameter must be used in the form `tt(~)var(param)' first.)
)
pindex(AUTO_PARAM_KEYS)
pindex(AUTOPARAMKEYS)
item(tt(AUTO_PARAM_KEYS) <D>)(
If a parameter name was completed and a following character
(normally a space) automatically
@ -172,11 +187,13 @@ Completion in a brace expansion is affected similarly: the added character
is a `tt(,)', which will be removed if `tt(})' is typed next.
)
pindex(AUTO_PARAM_SLASH)
pindex(AUTOPARAMSLASH)
item(tt(AUTO_PARAM_SLASH) <D>)(
If a parameter is completed whose content is the name of a directory,
then add a trailing slash instead of a space.
)
pindex(AUTO_REMOVE_SLASH)
pindex(AUTOREMOVESLASH)
cindex(slash, removing trailing)
item(tt(AUTO_REMOVE_SLASH) <D>)(
When the last character resulting from a completion is a slash and the next
@ -184,6 +201,7 @@ character typed is a word delimiter, a slash, or a character that ends
a command (such as a semicolon or an ampersand), remove the slash.
)
pindex(BASH_AUTO_LIST)
pindex(BASHAUTOLIST)
cindex(completion, listing choices, bash style)
item(tt(BASH_AUTO_LIST))(
On an ambiguous completion, automatically list choices when the
@ -195,6 +213,7 @@ tt(MENU_COMPLETE), since repeated completion calls immediately cycle
through the list in that case.
)
pindex(COMPLETE_ALIASES)
pindex(COMPLETEALIASES)
cindex(aliases, completion of)
item(tt(COMPLETE_ALIASES))(
Prevents aliases on the command line from being internally substituted
@ -202,11 +221,13 @@ before completion is attempted. The effect is to make the alias a
distinct command for completion purposes.
)
pindex(COMPLETE_IN_WORD)
pindex(COMPLETEINWORD)
item(tt(COMPLETE_IN_WORD))(
If unset, the cursor is set to the end of the word if completion is
started. Otherwise it stays there and completion is done from both ends.
)
pindex(GLOB_COMPLETE)
pindex(GLOBCOMPLETE)
item(tt(GLOB_COMPLETE))(
When the current word has a glob pattern, do not insert all the words
resulting from the expansion but generate matches as for completion and
@ -222,11 +243,13 @@ only applies when the current word contains a pattern; simply turning
on the tt(GLOB_COMPLETE) option does not have this effect.
)
pindex(HASH_LIST_ALL)
pindex(HASHLISTALL)
item(tt(HASH_LIST_ALL) <D>)(
Whenever a command completion is attempted, make sure the entire
command path is hashed first. This makes the first completion slower.
)
pindex(LIST_AMBIGUOUS)
pindex(LISTAMBIGUOUS)
cindex(ambiguous completion)
cindex(completion, ambiguous)
item(tt(LIST_AMBIGUOUS) <D>)(
@ -238,6 +261,7 @@ inserted. In the case of tt(BASH_AUTO_LIST), this means that the list
will be delayed to the third call of the function.
)
pindex(LIST_BEEP)
pindex(LISTBEEP)
cindex(beep, ambiguous completion)
cindex(completion, beep on ambiguous)
item(tt(LIST_BEEP) <D>)(
@ -247,12 +271,14 @@ causes the shell to beep if the option tt(BEEP) is also set; this may
be modified if completion is called from a user-defined widget.
)
pindex(LIST_PACKED)
pindex(LISTPACKED)
cindex(completion, listing)
item(tt(LIST_PACKED))(
Try to make the completion list smaller (occupying less lines) by
printing the matches in columns with different widths.
)
pindex(LIST_ROWS_FIRST)
pindex(LISTROWSFIRST)
cindex(completion, listing order)
item(tt(LIST_ROWS_FIRST))(
Lay out the matches in completion lists sorted horizontally, that is,
@ -260,6 +286,7 @@ the second match is to the right of the first one, not under it as
usual.
)
pindex(LIST_TYPES)
pindex(LISTTYPES)
cindex(marking file types)
cindex(files, marking type of)
item(tt(LIST_TYPES) (tt(-X)) <D>)(
@ -267,6 +294,7 @@ When listing files that are possible completions, show the
type of each file with a trailing identifying mark.
)
pindex(MENU_COMPLETE)
pindex(MENUCOMPLETE)
cindex(completion, menu)
item(tt(MENU_COMPLETE) (tt(-Y)))(
On an ambiguous completion, instead of listing possibilities or beeping,
@ -277,6 +305,7 @@ tt(reverse-menu-complete) may be used to loop through the list
in the other direction. This option overrides tt(AUTO_MENU).
)
pindex(REC_EXACT)
pindex(RECEXACT)
cindex(completion, exact matches)
item(tt(REC_EXACT) (tt(-S)))(
In completion, recognize exact matches even
@ -287,6 +316,7 @@ enditem()
subsect(Expansion and Globbing)
startitem()
pindex(BAD_PATTERN)
pindex(BADPATTERN)
cindex(globbing, bad pattern)
cindex(filename generation, bad pattern)
item(tt(BAD_PATTERN) (tt(PLUS()2)) <C> <Z>)(
@ -294,6 +324,7 @@ If a pattern for filename generation is badly formed, print an error message.
(If this option is unset, the pattern will be left unchanged.)
)
pindex(BARE_GLOB_QUAL)
pindex(BAREGLOBQUAL)
cindex(globbing qualifiers, enable)
cindex(enable globbing qualifiers)
item(tt(BARE_GLOB_QUAL) <Z>)(
@ -302,6 +333,7 @@ list, if it contains no `tt(|)', `tt(LPAR())' or (if special) `tt(~)'
characters. See noderef(Filename Generation).
)
pindex(BRACE_CCL)
pindex(BRACECCL)
cindex(brace expansion, extending)
cindex(expansion, brace, extending)
item(tt(BRACE_CCL))(
@ -310,6 +342,7 @@ expansion to a lexically ordered list of all the characters. See
noderef(Brace Expansion).
)
pindex(CASE_GLOB)
pindex(CASEGLOB)
cindex(case-insensitive globbing, option)
item(tt(CASE_GLOB) <D>)(
Make globbing (filename generation) sensitive to case. Note that other
@ -320,6 +353,7 @@ can match the directory tt(CVS) owing to the presence of the globbing flag
(unless the option tt(BARE_GLOB_QUAL) is unset).
)
pindex(CASE_MATCH)
pindex(CASEMATCH)
cindex(case-insensitive regular expression matches, option)
cindex(regular expressions, case-insensitive matching, option)
item(tt(CASE_MATCH) <D>)(
@ -327,6 +361,7 @@ Make regular expressions using the tt(zsh/regex) module (including
matches with tt(=~)) sensitive to case.
)
pindex(CSH_NULL_GLOB)
pindex(CSHNULLGLOB)
cindex(csh, null globbing style)
cindex(null globbing style, csh)
cindex(globbing, null, style, csh)
@ -344,6 +379,7 @@ Perform tt(=) filename expansion.
(See noderef(Filename Expansion).)
)
pindex(EXTENDED_GLOB)
pindex(EXTENDEDGLOB)
cindex(globbing, extended)
item(tt(EXTENDED_GLOB))(
Treat the `tt(#)', `tt(~)' and `tt(^)' characters as part of patterns
@ -358,6 +394,7 @@ Perform filename generation (globbing).
(See noderef(Filename Generation).)
)
pindex(GLOB_ASSIGN)
pindex(GLOBASSIGN)
item(tt(GLOB_ASSIGN) <C>)(
If this option is set, filename generation (globbing) is
performed on the right hand side of scalar parameter assignments of
@ -371,11 +408,13 @@ with this option set, it is not possible to predict whether the result
will be an array or a scalar.
)
pindex(GLOB_DOTS)
pindex(GLOBDOTS)
cindex(globbing, of . files)
item(tt(GLOB_DOTS) (tt(-4)))(
Do not require a leading `tt(.)' in a filename to be matched explicitly.
)
pindex(GLOB_SUBST)
pindex(GLOBSUBST)
item(tt(GLOB_SUBST) <C> <K> <S>)(
Treat any characters resulting from parameter expansion as being
eligible for file expansion and filename generation, and any
@ -384,6 +423,7 @@ filename generation. Braces (and commas in between) do not become eligible
for expansion.
)
pindex(HIST_SUBST_PATTERN)
pindex(HISTSUBSTPATTERN)
item(tt(HIST_SUBST_PATTERN))(
Substitutions using the tt(:s) and tt(:&) history modifiers are performed
with pattern matching instead of string matching. This occurs wherever
@ -393,6 +433,7 @@ ifzman(the section Modifiers in zmanref(zshexp))\
ifnzman(noderef(Modifiers)).
)
pindex(IGNORE_BRACES)
pindex(IGNOREBRACES)
cindex(disabling brace expansion)
cindex(brace expansion, disabling)
cindex(expansion, brace, disabling)
@ -400,12 +441,14 @@ item(tt(IGNORE_BRACES) (tt(-I)) <S>)(
Do not perform brace expansion.
)
pindex(KSH_GLOB)
pindex(KSHGLOB)
item(tt(KSH_GLOB) <K>)(
In pattern matching, the interpretation of parentheses is affected by
a preceding `tt(@)', `tt(*)', `tt(+)', `tt(?)' or `tt(!)'.
See noderef(Filename Generation).
)
pindex(MAGIC_EQUAL_SUBST)
pindex(MAGICEQUALSUBST)
item(tt(MAGIC_EQUAL_SUBST))(
All unquoted arguments of the form `var(anything)tt(=)var(expression)'
appearing after the command name have filename expansion (that is,
@ -421,6 +464,7 @@ words, if both options are in effect, arguments looking like
assignments will not undergo word splitting.
)
pindex(MARK_DIRS)
pindex(MARKDIRS)
cindex(directories, marking)
cindex(marking directories)
item(tt(MARK_DIRS) (tt(-8), ksh: tt(-X)))(
@ -465,6 +509,7 @@ This also applies to file expansion
of an initial `tt(~)' or `tt(=)'.
)
pindex(NULL_GLOB)
pindex(NULLGLOB)
cindex(globbing, no matches)
item(tt(NULL_GLOB) (tt(-G)))(
If a pattern for filename generation has no matches,
@ -472,12 +517,14 @@ delete the pattern from the argument list instead
of reporting an error. Overrides tt(NOMATCH).
)
pindex(NUMERIC_GLOB_SORT)
pindex(NUMERICGLOBSORT)
cindex(globbing, sorting numerically)
item(tt(NUMERIC_GLOB_SORT))(
If numeric filenames are matched by a filename generation pattern,
sort the filenames numerically rather than lexicographically.
)
pindex(RC_EXPAND_PARAM)
pindex(RCEXPANDPARAM)
cindex(rc, parameter expansion style)
cindex(parameter expansion style, rc)
item(tt(RC_EXPAND_PARAM) (tt(-P)))(
@ -489,6 +536,7 @@ var(xx) is set to tt(LPAR())var(a b c)tt(RPAR()), are substituted with
all arguments to be removed.
)
pindex(REMATCH_PCRE)
pindex(REMATCHPCRE)
cindex(regexp, PCRE)
cindex(PCRE, regexp)
item(tt(REMATCH_PCRE) <Z>)(
@ -498,6 +546,7 @@ If not set, regular expressions will use the extended regexp syntax
provided by the system libraries.
)
pindex(SH_GLOB)
pindex(SHGLOB)
cindex(sh, globbing style)
cindex(globbing style, sh)
item(tt(SH_GLOB) <K> <S>)(
@ -515,6 +564,7 @@ Treat unset parameters as if they were empty when substituting.
Otherwise they are treated as an error.
)
pindex(WARN_CREATE_GLOBAL)
pindex(WARNCREATEGLOBAL)
cindex(parameters, warning when created globally)
item(tt(WARN_CREATE_GLOBAL))(
Print a warning message when a global parameter is created in a function
@ -529,6 +579,7 @@ enditem()
subsect(History)
startitem()
pindex(APPEND_HISTORY)
pindex(APPENDHISTORY)
cindex(history, appending to a file)
item(tt(APPEND_HISTORY) <D>)(
If this is set, zsh sessions will append their history list to
@ -540,6 +591,7 @@ number of lines grows 20% beyond the value specified by
tt($SAVEHIST) (see also the HIST_SAVE_BY_COPY option).
)
pindex(BANG_HIST)
pindex(BANGHIST)
cindex(history, enable substitution)
cindex(enable history substitution)
item(tt(BANG_HIST) (tt(PLUS()K)) <C> <Z>)(
@ -547,6 +599,7 @@ Perform textual history expansion, bf(csh)-style,
treating the character `tt(!)' specially.
)
pindex(EXTENDED_HISTORY)
pindex(EXTENDEDHISTORY)
cindex(history, timestamping)
item(tt(EXTENDED_HISTORY) <C>)(
Save each command's beginning timestamp (in seconds since the epoch)
@ -556,11 +609,13 @@ this prefixed data is:
`tt(:)var(<beginning time>)tt(:)var(<elapsed seconds>)tt(:)var(<command>)'.
)
pindex(HIST_ALLOW_CLOBBER)
pindex(HISTALLOWCLOBBER)
item(tt(HIST_ALLOW_CLOBBER))(
Add `tt(|)' to output redirections in the history. This allows history
references to clobber files even when tt(CLOBBER) is unset.
)
pindex(HIST_BEEP)
pindex(HISTBEEP)
cindex(history beeping)
cindex(beep, history)
item(tt(HIST_BEEP) <D>)(
@ -568,6 +623,7 @@ Beep when an attempt is made to access a history entry which
isn't there.
)
pindex(HIST_EXPIRE_DUPS_FIRST)
pindex(HISTEXPIREDUPSFIRST)
cindex(history, expiring duplicates)
item(tt(HIST_EXPIRE_DUPS_FIRST))(
If the internal history needs to be trimmed to add the current command line,
@ -579,6 +635,7 @@ events, otherwise this option will behave just like
tt(HIST_IGNORE_ALL_DUPS) once the history fills up with unique events.
)
pindex(HIST_FCNTL_LOCK)
pindex(HISTFCNTLLOCK)
item(tt(HIST_FCNTL_LOCK))(
When writing out the history file, by default zsh uses ad-hoc file locking
to avoid known problems with locking on some operating systems. With this
@ -588,6 +645,7 @@ provide better performance, in particular avoiding history corruption when
files are stored on NFS.
)
pindex(HIST_FIND_NO_DUPS)
pindex(HISTFINDNODUPS)
cindex(history, ignoring duplicates in search)
item(tt(HIST_FIND_NO_DUPS))(
When searching for history entries in the line editor, do not display
@ -595,6 +653,7 @@ duplicates of a line previously found, even if the duplicates are not
contiguous.
)
pindex(HIST_IGNORE_ALL_DUPS)
pindex(HISTIGNOREALLDUPS)
cindex(history, ignoring all duplicates)
item(tt(HIST_IGNORE_ALL_DUPS))(
If a new command line being added to the history list duplicates an
@ -602,12 +661,14 @@ older one, the older command is removed from the list (even if it is
not the previous event).
)
pindex(HIST_IGNORE_DUPS)
pindex(HISTIGNOREDUPS)
cindex(history, ignoring duplicates)
item(tt(HIST_IGNORE_DUPS) (tt(-h)))(
Do not enter command lines into the history list
if they are duplicates of the previous event.
)
pindex(HIST_IGNORE_SPACE)
pindex(HISTIGNORESPACE)
cindex(history, ignoring spaces)
item(tt(HIST_IGNORE_SPACE) (tt(-g)))(
Remove command lines from the history list when the first character on
@ -619,6 +680,7 @@ or edit the line. If you want to make it vanish right away without
entering another command, type a space and press return.
)
pindex(HIST_NO_FUNCTIONS)
pindex(HISTNOFUNCTIONS)
item(tt(HIST_NO_FUNCTIONS))(
Remove function definitions from the history list.
Note that the function lingers in the internal history until the next
@ -626,6 +688,7 @@ command is entered before it vanishes, allowing you to briefly reuse
or edit the definition.
)
pindex(HIST_NO_STORE)
pindex(HISTNOSTORE)
item(tt(HIST_NO_STORE))(
Remove the tt(history) (tt(fc -l)) command from the history list
when invoked.
@ -634,11 +697,13 @@ command is entered before it vanishes, allowing you to briefly reuse
or edit the line.
)
pindex(HIST_REDUCE_BLANKS)
pindex(HISTREDUCEBLANKS)
item(tt(HIST_REDUCE_BLANKS))(
Remove superfluous blanks from each command line
being added to the history list.
)
pindex(HIST_SAVE_BY_COPY)
pindex(HISTSAVEBYCOPY)
item(tt(HIST_SAVE_BY_COPY) <D>)(
When the history file is re-written, we normally write out a copy of
the file named $HISTFILE.new and then rename it over the old one.
@ -655,11 +720,13 @@ file's permissions and group information, but will refuse to write
out a new file if it would change the history file's owner.
)
pindex(HIST_SAVE_NO_DUPS)
pindex(HISTSAVENODUPS)
item(tt(HIST_SAVE_NO_DUPS))(
When writing out the history file, older commands that duplicate
newer ones are omitted.
)
pindex(HIST_VERIFY)
pindex(HISTVERIFY)
cindex(history, verifying substitution)
item(tt(HIST_VERIFY))(
Whenever the user enters a line with history expansion,
@ -667,6 +734,7 @@ don't execute the line directly; instead, perform
history expansion and reload the line into the editing buffer.
)
pindex(INC_APPEND_HISTORY)
pindex(INCAPPENDHISTORY)
cindex(history, incremental appending to a file)
item(tt(INC_APPEND_HISTORY))(
This options works like tt(APPEND_HISTORY) except that new history lines
@ -677,6 +745,7 @@ number of lines grows 20% beyond the value specified by
tt($SAVEHIST) (see also the HIST_SAVE_BY_COPY option).
)
pindex(SHARE_HISTORY)
pindex(SHAREHISTORY)
cindex(share history)
cindex(history, sharing)
item(tt(SHARE_HISTORY) <K>)(
@ -704,11 +773,13 @@ enditem()
subsect(Initialisation)
startitem()
pindex(ALL_EXPORT)
pindex(ALLEXPORT)
cindex(export, automatic)
item(tt(ALL_EXPORT) (tt(-a), ksh: tt(-a)))(
All parameters subsequently defined are automatically exported.
)
pindex(GLOBAL_EXPORT)
pindex(GLOBALEXPORT)
cindex(environment, and local parameters)
item(tt(GLOBAL_EXPORT) (tt(<Z>)))(
If this option is set, passing the tt(-x) flag to the builtins tt(declare),
@ -727,6 +798,7 @@ most portable way to achieve this behaviour.
)
cindex(exporting, and local parameters)
pindex(GLOBAL_RCS)
pindex(GLOBALRCS)
cindex(startup files, global, inhibiting)
cindex(files, global startup, inhibiting)
item(tt(GLOBAL_RCS) (tt(-d)) <D>)(
@ -775,6 +847,7 @@ directories in the path are not readable, this may falsely report spelling
errors the first time some commands are used.
)
pindex(CORRECT_ALL)
pindex(CORRECTALL)
item(tt(CORRECT_ALL) (tt(-O)))(
Try to correct the spelling of all arguments in a line.
)
@ -785,6 +858,7 @@ for examining spelling mistakes for the tt(CORRECT) and tt(CORRECT_ALL)
options and the tt(spell-word) editor command.
)
pindex(FLOW_CONTROL)
pindex(FLOWCONTROL)
cindex(flow control)
item(tt(FLOW_CONTROL) <D>)(
If this option is unset,
@ -792,6 +866,7 @@ output flow control via start/stop characters (usually assigned to
^S/^Q) is disabled in the shell's editor.
)
pindex(IGNORE_EOF)
pindex(IGNOREEOF)
cindex(EOF, ignoring)
item(tt(IGNORE_EOF) (tt(-7)))(
Do not exit on end-of-file. Require the use
@ -805,11 +880,13 @@ Control-D) without printing the normal warning message. This works
only for normal widgets, not for completion widgets.
)
pindex(INTERACTIVE_COMMENTS)
pindex(INTERACTIVECOMMENTS)
cindex(comments, in interactive shells)
item(tt(INTERACTIVE_COMMENTS) (tt(-k)) <K> <S>)(
Allow comments even in interactive shells.
)
pindex(HASH_CMDS)
pindex(HASHCMDS)
cindex(hashing, of commands)
cindex(command hashing)
item(tt(HASH_CMDS) <D>)(
@ -822,6 +899,7 @@ the functions or aliases hash tables are hashed in order to avoid
reporting them as spelling errors.
)
pindex(HASH_DIRS)
pindex(HASHDIRS)
cindex(hashing, of directories)
cindex(directories, hashing)
item(tt(HASH_DIRS) <D>)(
@ -830,12 +908,14 @@ as well as all directories that occur earlier in the path.
Has no effect if neither tt(HASH_CMDS) nor tt(CORRECT) is set.
)
pindex(MAIL_WARNING)
pindex(MAILWARNING)
cindex(mail, warning of reading)
item(tt(MAIL_WARNING) (tt(-U)))(
Print a warning message if a mail file has been
accessed since the shell last checked.
)
pindex(PATH_DIRS)
pindex(PATHDIRS)
cindex(path search, extended)
item(tt(PATH_DIRS) (tt(-Q)))(
Perform a path search even on command names with slashes in them.
@ -844,7 +924,7 @@ Thus if `tt(/usr/local/bin)' is in the user's path, and he or she types
(assuming it exists).
Commands explicitly beginning with `tt(/)', `tt(./)' or `tt(../)'
are not subject to the path search.
This also applies to the `tt(.)' builtin.
This also applies to the tt(.) builtin.
Note that subdirectories of the current directory are always searched for
executables specified in this form. This takes place before any search
@ -852,6 +932,7 @@ indicated by this option, and regardless of whether `tt(.)' or the current
directory appear in the command search path.
)
pindex(PRINT_EIGHT_BIT)
pindex(PRINTEIGHTBIT)
cindex(eight bit characters, printing)
item(tt(PRINT_EIGHT_BIT))(
Print eight bit characters literally in completion lists, etc.
@ -859,11 +940,13 @@ This option is not necessary if your system correctly returns the
printability of eight bit characters (see manref(ctype)(3)).
)
pindex(PRINT_EXIT_VALUE)
pindex(PRINTEXITVALUE)
cindex(exit status, printing)
item(tt(PRINT_EXIT_VALUE) (tt(-1)))(
Print the exit value of programs with non-zero exit status.
)
pindex(RC_QUOTES)
pindex(RCQUOTES)
cindex(rc, quoting style)
cindex(quoting style, rc)
item(tt(RC_QUOTES))(
@ -873,12 +956,14 @@ using the format tt($')var(...)tt('), where a backslashed single quote can
be used.
)
pindex(RM_STAR_SILENT)
pindex(RMSTARSILENT)
cindex(rm *, querying before)
cindex(querying before rm *)
item(tt(RM_STAR_SILENT) (tt(-H)) <K> <S>)(
Do not query the user before executing `tt(rm *)' or `tt(rm path/*)'.
)
pindex(RM_STAR_WAIT)
pindex(RMSTARWAIT)
cindex(rm *, waiting before)
cindex(waiting before rm *)
item(tt(RM_STAR_WAIT))(
@ -889,11 +974,13 @@ when one didn't really mean it. The wait and query can always be
avoided by expanding the `tt(*)' in ZLE (with tab).
)
pindex(SHORT_LOOPS)
pindex(SHORTLOOPS)
item(tt(SHORT_LOOPS) <C> <Z>)(
Allow the short forms of tt(for), tt(repeat), tt(select),
tt(if), and tt(function) constructs.
)
pindex(SUN_KEYBOARD_HACK)
pindex(SUNKEYBOARDHACK)
cindex(sun keyboard, annoying)
cindex(annoying keyboard, sun)
item(tt(SUN_KEYBOARD_HACK) (tt(-L)))(
@ -907,6 +994,7 @@ enditem()
subsect(Job Control)
startitem()
pindex(AUTO_CONTINUE)
pindex(AUTOCONTINUE)
cindex(jobs, continuing automatically)
cindex(continuing jobs automatically)
item(tt(AUTO_CONTINUE))(
@ -915,6 +1003,7 @@ with the tt(disown) builtin command are automatically sent a tt(CONT)
signal to make them running.
)
pindex(AUTO_RESUME)
pindex(AUTORESUME)
cindex(jobs, resuming automatically)
cindex(resuming jobs automatically)
item(tt(AUTO_RESUME) (tt(-W)))(
@ -922,6 +1011,7 @@ Treat single word simple commands without redirection
as candidates for resumption of an existing job.
)
pindex(BG_NICE)
pindex(BGNICE)
cindex(jobs, background priority)
cindex(background jobs, priority of)
cindex(priority of background jobs)
@ -930,6 +1020,7 @@ Run all background jobs at a lower priority. This option
is set by default.
)
pindex(CHECK_JOBS)
pindex(CHECKJOBS)
cindex(exiting, checking jobs when)
cindex(logging out, checking jobs when)
item(tt(CHECK_JOBS) <Z>)(
@ -953,6 +1044,7 @@ Send the tt(HUP) signal to running jobs when the
shell exits.
)
pindex(LONG_LIST_JOBS)
pindex(LONGLISTJOBS)
cindex(jobs, list format)
item(tt(LONG_LIST_JOBS) (tt(-R)))(
List jobs in the long format by default.
@ -974,6 +1066,7 @@ enditem()
subsect(Prompting)
startitem()
pindex(PROMPT_BANG)
pindex(PROMPTBANG)
cindex(prompt, ! expansion)
item(tt(PROMPT_BANG) <K>)(
If set, `tt(!)' is treated specially in prompt expansion.
@ -982,6 +1075,7 @@ ifzman(EXPANSION OF PROMPT SEQUENCES in zmanref(zshmisc))\
ifnzman(noderef(Prompt Expansion)).
)
pindex(PROMPT_CR)
pindex(PROMPTCR)
cindex(prompt, with CR)
item(tt(PROMPT_CR) (tt(PLUS()V)) <D>)(
Print a carriage return just before printing
@ -989,6 +1083,7 @@ a prompt in the line editor. This is on by default as multi-line editing
is only possible if the editor knows where the start of the line appears.
)
pindex(PROMPT_SP)
pindex(PROMPTSP)
cindex(prompt, save partial lines)
item(tt(PROMPT_SP) <D>)(
Attempt to preserve a partial line (i.e. a line that did not end with a
@ -1005,6 +1100,7 @@ NOTE: if the PROMPT_CR option is not set, enabling this option will have no
effect. This option is on by default.
)
pindex(PROMPT_PERCENT)
pindex(PROMPTPERCENT)
cindex(prompt, % expansion)
item(tt(PROMPT_PERCENT) <C> <Z>)(
If set, `tt(%)' is treated specially in prompt expansion.
@ -1013,6 +1109,7 @@ ifzman(EXPANSION OF PROMPT SEQUENCES in zmanref(zshmisc))\
ifnzman(noderef(Prompt Expansion)).
)
pindex(PROMPT_SUBST)
pindex(PROMPTSUBST)
cindex(prompt, parameter expansion)
item(tt(PROMPT_SUBST) <K> <S>)(
If set, em(parameter expansion), em(command substitution) and
@ -1020,6 +1117,7 @@ em(arithmetic expansion) are performed in prompts. Substitutions
within prompts do not affect the command status.
)
pindex(TRANSIENT_RPROMPT)
pindex(TRANSIENTRPROMPT)
item(tt(TRANSIENT_RPROMPT))(
Remove any right prompt from display when accepting a command
line. This may be useful with terminals with other cut/paste methods.
@ -1029,6 +1127,7 @@ enditem()
subsect(Scripts and Functions)
startitem()
pindex(C_BASES)
pindex(CBASES)
cindex(bases, output in C format)
cindex(hexadecimal, output in C format)
cindex(octal, output in C format)
@ -1042,6 +1141,7 @@ hexadecimal and octal. Note that these formats will be understood on input
irrespective of the setting of tt(C_BASES).
)
pindex(C_PRECEDENCES)
pindex(CPRECEDENCES)
cindex(precedence, operator)
cindex(operator precedence)
item(tt(C_PRECEDENCES))(
@ -1060,6 +1160,7 @@ each command. Setting this option mimics the behaviour of ksh 93; with
the option unset the behaviour is that of ksh 88.
)
pindex(ERR_EXIT)
pindex(ERREXIT)
cindex(exit status, trapping)
item(tt(ERR_EXIT) (tt(-e), ksh: tt(-e)))(
If a command has a non-zero exit status, execute the tt(ZERR)
@ -1074,6 +1175,7 @@ on exit, then the command for which the tt(DEBUG) trap is being executed is
skipped. The option is restored after the trap exits.
)
pindex(ERR_RETURN)
pindex(ERRRETURN)
cindex(function return, on error)
cindex(return from function, on error)
item(tt(ERR_RETURN))(
@ -1084,6 +1186,7 @@ tt(exit). This will trigger an exit at the outermost level of a
non-interactive script.
)
pindex(EVAL_LINENO)
pindex(EVALLINENO)
cindex(line number, in evaluated expression)
item(tt(EVAL_LINENO) <Z>)(
If set, line numbers of expressions evaluated using the builtin tt(eval)
@ -1105,12 +1208,14 @@ This option cannot be turned off in an interactive shell,
except when `tt(-n)' is supplied to the shell at startup.
)
pindex(FUNCTION_ARGZERO)
pindex(FUNCTIONARGZERO)
cindex($0, setting)
item(tt(FUNCTION_ARGZERO) <C> <Z>)(
When executing a shell function or sourcing a script, set tt($0)
temporarily to the name of the function/script.
)
pindex(LOCAL_OPTIONS)
pindex(LOCALOPTIONS)
item(tt(LOCAL_OPTIONS) <K>)(
If this option is set at the point of return from a shell function,
most options (including this one) which were in force upon entry to
@ -1124,6 +1229,7 @@ with a formulation like `tt(emulate -L zsh)'; the tt(-L) activates
tt(LOCAL_OPTIONS).
)
pindex(LOCAL_TRAPS)
pindex(LOCALTRAPS)
item(tt(LOCAL_TRAPS) <K>)(
If this option is set when a signal trap is set inside a function, then the
previous status of the trap for that signal will be restored when the
@ -1140,6 +1246,7 @@ fn+LPAR()RPAR() { setopt localtraps; trap '' INT; sleep 3; })
will restore normally handling of tt(SIGINT) after the function exits.
)
pindex(MULTI_FUNC_DEF)
pindex(MULTIFUNCDEF)
item(tt(MULTI_FUNC_DEF) <Z>)(
Allow definitions of multiple functions at once in the form `tt(fn1
fn2)var(...)tt(LPAR()RPAR())'; if the option is not set, this causes
@ -1153,6 +1260,7 @@ Perform implicit bf(tee)s or bf(cat)s when multiple
redirections are attempted (see noderef(Redirection)).
)
pindex(OCTAL_ZEROES)
pindex(OCTALZEROES)
cindex(octal, arithmetic expressions)
item(tt(OCTAL_ZEROES) <S>)(
Interpret any integer constant beginning with a 0 as octal, per IEEE Std
@ -1165,6 +1273,7 @@ component in `tt(08#77)' are always interpreted as decimal, regardless
of leading zeroes.
)
pindex(TYPESET_SILENT)
pindex(TYPESETSILENT)
item(tt(TYPESET_SILENT))(
If this is unset, executing any of the `tt(typeset)' family of
commands with no options and a list of parameters that have no values
@ -1190,6 +1299,7 @@ enditem()
subsect(Shell Emulation)
startitem()
pindex(BASH_REMATCH)
pindex(BASHREMATCH)
cindex(bash, BASH_REMATCH variable)
cindex(regexp, bash BASH_REMATCH variable)
item(tt(BASH_REMATCH))(
@ -1204,6 +1314,7 @@ contains the entire matched text and the tt(match) array variable contains
substrings.
)
pindex(BSD_ECHO)
pindex(BSDECHO)
cindex(echo, BSD compatible)
item(tt(BSD_ECHO) <S>)(
Make the tt(echo) builtin compatible with the BSD manref(echo)(1) command.
@ -1211,6 +1322,7 @@ This disables backslashed escape sequences in echo strings unless the
tt(-e) option is specified.
)
pindex(CSH_JUNKIE_HISTORY)
pindex(CSHJUNKIEHISTORY)
cindex(csh, history style)
cindex(history style, csh)
item(tt(CSH_JUNKIE_HISTORY) <C>)(
@ -1220,6 +1332,7 @@ to the same event as the previous history reference, defaulting to the
previous command.
)
pindex(CSH_JUNKIE_LOOPS)
pindex(CSHJUNKIELOOPS)
cindex(csh, loop style)
cindex(loop style, csh)
item(tt(CSH_JUNKIE_LOOPS) <C>)(
@ -1227,6 +1340,7 @@ Allow loop bodies to take the form `var(list); tt(end)' instead of
`tt(do) var(list); tt(done)'.
)
pindex(CSH_JUNKIE_QUOTES)
pindex(CSHJUNKIEQUOTES)
cindex(csh, quoting style)
cindex(quoting style, csh)
item(tt(CSH_JUNKIE_QUOTES) <C>)(
@ -1238,6 +1352,7 @@ or `tt(")' (and `tt(\)' itself no longer needs escaping).
Command substitutions are only expanded once, and cannot be nested.
)
pindex(CSH_NULLCMD)
pindex(CSHNULLCMD)
vindex(NULLCMD, ignoring)
vindex(READNULLCMD, ignoring)
cindex(redirections with no command, csh)
@ -1248,6 +1363,7 @@ when running redirections with no command. This make
such redirections fail (see noderef(Redirection)).
)
pindex(KSH_ARRAYS)
pindex(KSHARRAYS)
cindex(arrays, ksh style)
cindex(array style, ksh)
cindex(ksh, array style)
@ -1259,6 +1375,7 @@ and braces are required to delimit a subscript (`tt(${path[2]})' rather
than just `tt($path[2])').
)
pindex(KSH_AUTOLOAD)
pindex(KSHAUTOLOAD)
item(tt(KSH_AUTOLOAD) <K> <S>)(
Emulate bf(ksh) function autoloading. This means that when a function is
autoloaded, the corresponding file is merely executed, and must define
@ -1268,6 +1385,7 @@ containing only a simple definition of the function - is always handled
in the bf(ksh)-compatible manner.)
)
pindex(KSH_OPTION_PRINT)
pindex(KSHOPTIONPRINT)
cindex(option printing, ksh style)
cindex(option printing style, ksh)
cindex(ksh, option printing style)
@ -1277,6 +1395,7 @@ set and unset options, all options are shown, marked `on' if
they are in the non-default state, `off' otherwise.
)
pindex(KSH_TYPESET)
pindex(KSHTYPESET)
cindex(argument splitting, in typeset etc.)
cindex(ksh, argument splitting in typeset)
item(tt(KSH_TYPESET) <K>)(
@ -1287,6 +1406,7 @@ word splitting after command and parameter expansion in arguments of an
assignment; with it, word splitting does not take place in those cases.
)
pindex(KSH_ZERO_SUBSCRIPT)
pindex(KSHZEROSUBSCRIPT)
cindex(arrays, behaviour of index zero)
item(tt(KSH_ZERO_SUBSCRIPT))(
Treat use of a subscript of value zero in array or string expressions as a
@ -1312,6 +1432,7 @@ This option is for compatibility with older versions of the shell and
is not recommended in new code.
)
pindex(POSIX_BUILTINS)
pindex(POSIXBUILTINS)
item(tt(POSIX_BUILTINS) <K> <S>)(
When this option is set the tt(command) builtin can be used to execute
shell builtin commands. Parameter assignments specified before shell
@ -1338,6 +1459,7 @@ tt(trap) and
tt(unset).
)
pindex(POSIX_IDENTIFIERS)
pindex(POSIXIDENTIFIERS)
cindex(identifiers, non-portable characters in)
cindex(parameter names, non-portable characters in)
item(tt(POSIX_IDENTIFIERS) <K> <S>)(
@ -1359,6 +1481,7 @@ ignored; all octets with the top bit set may be used in identifiers.
This is non-standard but is the traditional zsh behaviour.
)
pindex(SH_FILE_EXPANSION)
pindex(SHFILEEXPANSION)
cindex(sh, expansion style)
cindex(expansion style, sh)
item(tt(SH_FILE_EXPANSION) <K> <S>)(
@ -1370,6 +1493,7 @@ brace expansion, so things like `tt(~$USERNAME)' and
`tt(~{pfalstad,rc})' will work.
)
pindex(SH_NULLCMD)
pindex(SHNULLCMD)
vindex(NULLCMD, ignoring)
vindex(READNULLCMD, ignoring)
cindex(sh, redirections with no command)
@ -1381,6 +1505,7 @@ Do not use the values of tt(NULLCMD) and tt(READNULLCMD)
when doing redirections, use `tt(:)' instead (see noderef(Redirection)).
)
pindex(SH_OPTION_LETTERS)
pindex(SHOPTIONLETTERS)
cindex(sh, single letter options style)
cindex(ksh, single letter options style)
cindex(single letter options, ksh style)
@ -1391,6 +1516,7 @@ If this option is set the shell tries to interpret single letter options
This also affects the value of the tt(-) special parameter.
)
pindex(SH_WORD_SPLIT)
pindex(SHWORDSPLIT)
cindex(field splitting, sh style)
cindex(sh, field splitting style)
item(tt(SH_WORD_SPLIT) (tt(-y)) <K> <S>)(
@ -1399,6 +1525,7 @@ Note that this option has nothing to do with word splitting.
(See noderef(Parameter Expansion).)
)
pindex(TRAPS_ASYNC)
pindex(TRAPSASYNC)
cindex(traps, asynchronous)
item(tt(TRAPS_ASYNC))(
While waiting for a program to exit, handle signals and run traps
@ -1450,6 +1577,7 @@ globally regardless of the tt(LOCAL_OPTIONS) option. See
noderef(Restricted Shell).
)
pindex(SHIN_STDIN)
pindex(SHINSTDIN)
item(tt(SHIN_STDIN) (tt(-s), ksh: tt(-s)))(
Commands are being read from the standard input.
Commands are read from standard input if no command is specified with
@ -1466,6 +1594,7 @@ The value of this option cannot be changed anywhere other
than the command line.
)
pindex(SINGLE_COMMAND)
pindex(SINGLECOMMAND)
cindex(single command)
pindex(INTERACTIVE, use of)
item(tt(SINGLE_COMMAND) (tt(-t), ksh: tt(-t)))(
@ -1485,6 +1614,7 @@ item(tt(BEEP) (tt(PLUS()B)) <D>)(
Beep on error in ZLE.
)
pindex(COMBINING_CHARS)
pindex(COMBININGCHARS)
cindex(characters, (Unicode) combining)
cindex(combining characters (Unicode))
cindex(Unicode combining characters)
@ -1517,6 +1647,7 @@ item(tt(OVERSTRIKE))(
Start up the line editor in overstrike mode.
)
pindex(SINGLE_LINE_ZLE)
pindex(SINGLELINEZLE)
cindex(editor, single line mode)
item(tt(SINGLE_LINE_ZLE) (tt(-M)) <K>)(
Use single-line command line editing instead of multi-line.
@ -1553,26 +1684,31 @@ options to the shell.
startitem()
pindex(BRACE_EXPAND)
pindex(BRACEEXPAND)
item(tt(BRACE_EXPAND))(
em(NO_)tt(IGNORE_BRACES)
(ksh and bash compatibility)
)
pindex(DOT_GLOB)
pindex(DOTGLOB)
item(tt(DOT_GLOB))(
tt(GLOB_DOTS)
(bash compatibility)
)
pindex(HASH_ALL)
pindex(HASHALL)
item(tt(HASH_ALL))(
tt(HASH_CMDS)
(bash compatibility)
)
pindex(HIST_APPEND)
pindex(HISTAPPEND)
item(tt(HIST_APPEND))(
tt(APPEND_HISTORY)
(bash compatibility)
)
pindex(HIST_EXPAND)
pindex(HISTEXPAND)
item(tt(HIST_EXPAND))(
tt(BANG_HIST)
(bash compatibility)
@ -1583,11 +1719,13 @@ em(NO_)tt(HIST_NO_FUNCTIONS)
(ksh compatibility)
)
pindex(MAIL_WARN)
pindex(MAILWARN)
item(tt(MAIL_WARN))(
tt(MAIL_WARNING)
(bash compatibility)
)
pindex(ONE_CMD)
pindex(ONECMD)
item(tt(ONE_CMD))(
tt(SINGLE_COMMAND)
(bash compatibility)
@ -1598,6 +1736,7 @@ tt(CHASE_LINKS)
(ksh and bash compatibility)
)
pindex(PROMPT_VARS)
pindex(PROMPTVARS)
item(tt(PROMPT_VARS))(
tt(PROMPT_SUBST)
(bash compatibility)
@ -1608,6 +1747,7 @@ tt(SHIN_STDIN)
(ksh compatibility)
)
pindex(TRACK_ALL)
pindex(TRACKALL)
item(tt(TRACK_ALL))(
tt(HASH_CMDS)
(ksh compatibility)