bybrooklyn/zsh
1
0
Fork 0
mirror of https://git.code.sf.net/p/zsh/code synced 2026-04-18 06:53:35 -04:00
Code Issues Packages Projects Releases Wiki Activity

Minor tweak to _generic plus doc fixes for info interpretation of hyphens.

Browse Source
This commit is contained in:
Bart Schaefer
2005-04-24 18:38:01 +00:00
parent d373eb8f1e
commit 337a2e3bfd
10 changed files with 58 additions and 49 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
Doc/Zsh/invoke.yo
View File

@@ -51,32 +51,33 @@ tt(-o) can be stacked up with preceding single-letter options, so for example
cindex(long option)
Options may also be specified by name in GNU long option style,
`tt(--)var(option-name)'. When this is done, `tt(-)' characters in the
`tt(-)tt(-)var(option-name)'. When this is done, `tt(-)' characters in the
option name are permitted: they are translated into `tt(_)', and thus ignored.
So, for example, `tt(zsh --sh-word-split)' invokes zsh with the
So, for example, `tt(zsh -)tt(-sh-word-split)' invokes zsh with the
tt(SH_WORD_SPLIT) option turned on. Like other option syntaxes, options can
be turned off by replacing the initial `tt(-)' with a `tt(PLUS())'; thus
`tt(+-sh-word-split)' is equivalent to `tt(--no-sh-word-split)'.
`tt(+-sh-word-split)' is equivalent to `tt(-)tt(-no-sh-word-split)'.
Unlike other option syntaxes, GNU-style long options cannot be stacked with
any other options, so for example `tt(-x-shwordsplit)' is an error,
rather than being treated like `tt(-x --shwordsplit)'.
rather than being treated like `tt(-x -)tt(-shwordsplit)'.
cindex(--version)
cindex(--help)
The special GNU-style option `tt(--version)' is handled; it sends to standard
output the shell's version information, then exits successfully.
`tt(--help)' is also handled; it sends to standard output a list of options
that can be used when invoking the shell, then exits successfully.
The special GNU-style option `tt(-)tt(-version)' is handled; it sends to
standard output the shell's version information, then exits successfully.
`tt(-)tt(-help)' is also handled; it sends to standard output a list of
options that can be used when invoking the shell, then exits successfully.
Option processing may be finished, allowing following arguments that start with
`tt(-)' or `tt(PLUS())' to be treated as normal arguments, in two ways.
Firstly, a lone `tt(-)' (or `tt(PLUS())') as an argument by itself ends option
processing. Secondly, a special option `tt(--)' (or `tt(PLUS()-)'), which may
be specified on its own (which is the standard POSIX usage) or may be stacked
with preceding options (so `tt(-x-)' is equivalent to `tt(-x --)'). Options
are not permitted to be stacked after `tt(--)' (so `tt(-x-f)' is an error),
but note the GNU-style option form discussed above, where `tt(--shwordsplit)'
is permitted and does not end option processing.
Firstly, a lone `tt(-)' (or `tt(PLUS())') as an argument by itself ends
option processing. Secondly, a special option `tt(-)tt(-)' (or
`tt(PLUS()-)'), which may be specified on its own (which is the standard
POSIX usage) or may be stacked with preceding options (so `tt(-x-)' is
equivalent to `tt(-x -)tt(-)'). Options are not permitted to be stacked
after `tt(-)tt(-)' (so `tt(-x-f)' is an error), but note the GNU-style
option form discussed above, where `tt(-)tt(-shwordsplit)' is permitted
and does not end option processing.
Except when the bf(sh)/bf(ksh) emulation single-letter options are in effect,
the option `tt(-b)' (or `tt(PLUS()b)') ends option processing.