home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / Shells / zsh-3.0.5-MIHS / docs / zsh.info-6 < prev    next >
Encoding:
GNU Info File  |  1997-06-23  |  45.5 KB  |  853 lines

  1. This is Info file zsh.info, produced by Makeinfo-1.64 from the input
  2. file ../../zsh-3.0.4/Doc/zsh.texi.
  3.  
  4. This is a texinfo version of the man page for the Z Shell, originally by
  5. Paul Falstad.  It was converted from the `zsh.1' file distributed with
  6. zsh v2.5.0 by Jonathan Hardwick, `jch@cs.cmu.edu' and updated/modified
  7. by Clive Messer, `clive@epos.demon.co.uk' to its present state.
  8.  
  9.    Permission is granted to make and distribute verbatim copies of this
  10. manual provided the copyright notice and this permission notice are
  11. preserved on all copies.
  12.  
  13.    Permission is granted to copy and distribute modified versions of
  14. this manual under the conditions for verbatim copying, provided also
  15. that the entire resulting derived work is distributed under the terms
  16. of a permission notice identical to this one.
  17.  
  18.    Permission is granted to copy and distribute translations of this
  19. manual into another language, under the above conditions for modified
  20. versions.
  21.  
  22. 
  23. File: zsh.info,  Node: Flags with arguments,  Next: Control Flags,  Prev: Simple Flags,  Up: Options Flags
  24.  
  25. Flags with arguments
  26. --------------------
  27.  
  28. These have user supplied arguments to determine how the list of
  29. completions is to be made up:
  30.  
  31. `-k ARRAY'
  32.      Names taken from the elements of `$ARRAY' (note that the `$' does
  33.      not appear on the command  line).   Alternatively, the argument
  34.      `ARRAY' itself may be a set of space or comma separated values in
  35.      parentheses, in which any delimiter may be escaped with a
  36.      backslash; in this case the argument should be quoted.  For
  37.      example, `compctl -k "(cputime filesize datasize stacksize
  38.      coredumpsize resident descriptors)" limit'.
  39.  
  40. `-g GLOBSTRING'
  41.      The GLOBSTRING is expanded using filename globbing; it should be
  42.      quoted to protect it from immediate expansion.  The resulting
  43.      filenames are taken as possible completions.  Use `*(/)' instead
  44.      of `*/' for directories.  The `fignore' special parameter is not
  45.      applied to the resulting files.  More than one pattern may be
  46.      given separated by blanks. (Note that brace expansion is not part
  47.      of globbing.  Use the syntax (`either|or') to match alternatives.)
  48.  
  49. `-K FUNCTION'
  50.      Call the given function to get the completions.  The function is
  51.      passed two arguments: the prefix and the suffix of the word on
  52.      which completion is to be attempted, in other words those
  53.      characters before the cursor position, and those from the cursor
  54.      position onwards.  The function should set the variable `reply' to
  55.      an array containing the completions (one completion per element);
  56.      note that `reply' should not be made local to the function.  From
  57.      such a function the command line can be accessed with the `-c' and
  58.      `-l' flags to the `read' builtin.  For example,
  59.  
  60.      `function whoson { reply=(`users`); }'
  61.      `compctl -K whoson talk'
  62.  
  63.      completes only logged-on users after `talk'.  Note that `whoson'
  64.      must return an array so that just `reply=`users`' is incorrect.
  65.  
  66. `-H NUM PATTERN'
  67.      The possible completions are taken from the last NUM history
  68.      lines.  Only words matching PATTERN are taken.  If NUM is zero or
  69.      negative the whole history is searched and if PATTERN is the empty
  70.      string all words are taken (as with `*').  A typical use is
  71.  
  72.      `compctl -D -f + -H 0 '' -X '(No file found; using history)''
  73.  
  74.      which forces completion to look back in the history list for a
  75.      word if no filename matches.  The explanation string is useful as
  76.      it tells the user that no file of that name exists, which is
  77.      otherwise ambiguous.  (See the next section for `-X'.)
  78.  
  79. 
  80. File: zsh.info,  Node: Control Flags,  Prev: Flags with arguments,  Up: Options Flags
  81.  
  82. Control Flags
  83. -------------
  84.  
  85. These do not directly specify types of name to be completed, but
  86. manipulate the options that do:
  87.  
  88. `-Q'
  89.      This instructs the shell not to quote any metacharacters in the
  90.      possible completions.  Normally the results of a completion are
  91.      inserted into the command line with any metacharacters quoted so
  92.      that they  are interpreted as  normal characters.  This is
  93.      appropriate for filenames and ordinary strings.  However, for
  94.      special effects, such as inserting a backquoted expression from a
  95.      completion array (`-k') so that the expression will not be
  96.      evaluated until the complete line is executed, this option must be
  97.      used.
  98.  
  99. `-P PREFIX'
  100.      The PREFIX is inserted just before the completed string; any
  101.      initial part already typed will be completed and the whole PREFIX
  102.      ignored for completion purposes.  For example,
  103.  
  104.      `compctl -j -P "%" kill'
  105.  
  106.      inserts a `%' after the `kill' command and then completes job
  107.      names.
  108.  
  109. `-S SUFFIX'
  110.      When a completion is found the SUFFIX is inserted after the
  111.      completed string.  In the case of menu completion the SUFFIX is
  112.      inserted immediately, but it is still possible to cycle through
  113.      the list of completions by repeatedly hitting the same key.
  114.  
  115. `-q'
  116.      If used with a suffix as specified by the previous option, this
  117.      causes the suffix to be removed if the next character typed is a
  118.      blank or does not insert anything (the same rule as used for the
  119.      `AUTO_REMOVE_SLASH' option).  The option is most useful for list
  120.      separators (comma, colon, etc.).
  121.  
  122. `-l CMD'
  123.      This option cannot be combined with any other option.  It
  124.      restricts the range of command line words that are considered to be
  125.      arguments.  If combined with one of the extended completion
  126.      patterns `p[...]', `r[...]', or `R[...]' (*Note Extended
  127.      Completion::.) the range is restricted to the arguments specified
  128.      in the brackets.  Completion is then performed as if these had
  129.      been given as arguments to the CMD supplied with the option.  If
  130.      the CMD string is empty the first word in the range is instead
  131.      taken as the command name, and command name completion performed
  132.      on the first word in the range.  For example,
  133.  
  134.      `compctl -x 'r[-exec,;]' -l '' -- find'
  135.  
  136.      completes arguments between `-exec' and the following `;' (or the
  137.      end of the command line if there is no such string) as if they
  138.      were a separate command line.
  139.  
  140. `-U'
  141.      Use the whole list of possible completions, whether or not they
  142.      actually match the word on the command line.  The word typed so
  143.      far will be deleted.  This is most useful with a function (given
  144.      by the `-K' option) which can examine the word components passed
  145.      to it (or via the `read' builtin's `-c' and `-l' flags) and use
  146.      its own criteria to decide what matches.  If there is no
  147.      completion, the original word is retained.
  148.  
  149. `-X EXPLANATION'
  150.      Print EXPLANATION when trying completion on the current set of
  151.      options.  A `%n' in this string is replaced by the number of
  152.      matches.
  153.  
  154. 
  155. File: zsh.info,  Node: Alternative Completion,  Next: Extended Completion,  Prev: Options Flags,  Up: Programmable Completion
  156.  
  157. Alternative Completion
  158. ======================
  159.  
  160. `compctl [ -CDT ] OPTIONS + OPTIONS [ + ... ] [ + ] COMMAND ...'
  161.  
  162. The form with `+' specifies alternative OPTIONS.  Completion is tried
  163. with the OPTIONS before the first `+'.  If this produces no matches
  164. completion is tried with the flags after the `+' and so on.  If there
  165. are no flags after the last `+' and a match has not been found up to
  166. that point, default completion is tried.
  167.  
  168. 
  169. File: zsh.info,  Node: Extended Completion,  Next: Example,  Prev: Alternative Completion,  Up: Programmable Completion
  170.  
  171. Extended Completion
  172. ===================
  173.  
  174. `compctl  [  -CDT  ]  OPTIONS -x PATTERN OPTIONS - ... -- [ COMMAND ...
  175. ]'
  176.  
  177. `compctl [ -CDT ] OPTIONS [ -x PATTERN OPTIONS - ... -- ]'
  178. `        [ + OPTIONS [ -x ... -- ] ... [+] ] [ COMMAND ... ]'
  179.  
  180. The form with `-x' specifies extended completion for the commands
  181. given; as shown, it may be combined with alternative completion using
  182. `+'.  Each PATTERN is examined in turn; when a match is found, the
  183. corresponding OPTIONS, as described in *Note Options Flags::, are used
  184. to generate possible completions.  If no PATTERN matches, the OPTIONS
  185. given before the `-x' are used.
  186.  
  187. Note that each pattern should be supplied as a single argument and
  188. should be quoted to prevent expansion of meta-characters by the shell.
  189.  
  190. A PATTERN is built of sub-patterns separated by commas; it matches if
  191. at least one of these sub-patterns matches (they are `or''ed).  These
  192. sub-patterns are in turn composed of other sub-patterns separated by
  193. white spaces which match if all of the sub-patterns match (they are
  194. `and''ed).  An element of the sub-patterns is of the  form
  195. `c[...][...]', where the pairs of brackets may be repeated as often as
  196. necessary, and matches if any of the sets of brackets match (an `or').
  197. The example below makes this clearer.
  198.  
  199. The elements may be any of the following:
  200.  
  201. `S[STRING] ...'
  202.      Matches if the current word on the command line starts with one of
  203.      the strings given in brackets.  The STRING is not removed and is
  204.      not part of the completion.
  205.  
  206. `S[STRING] ...'
  207.      Like S[STRING] except that the STRING is part of the completion.
  208.  
  209. `P[FROM,TO] ...'
  210.      Matches if the number of the current word is between one of the
  211.      FROM and TO pairs inclusive.  The comma and TO are optional; TO
  212.      defaults to the same value as FROM.  The numbers may be negative:
  213.      `-n' refers to the `n''th last word on the line.
  214.  
  215. `C[OFFSET,STRING] ...'
  216.      Matches if the STRING matches the word offset by OFFSET from the
  217.      current word position.  Usually OFFSET will be negative.
  218.  
  219. `C[OFFSET,PATTERN] ...'
  220.      Like C but using pattern matching instead.
  221.  
  222. `W[INDEX,STRING] ...'
  223.      Matches if the word in position INDEX is equal to the
  224.      corresponding  STRING.  Note that the word count is made after any
  225.      alias expansion.
  226.  
  227. `W[INDEX,PATTERN] ...'
  228.      Like W but using pattern matching instead.
  229.  
  230. `N[INDEX,STRING] ...'
  231.      Matches if the current word contains STRING.  Anything up to and
  232.      including the INDEX'th occurrence of this STRING will not be
  233.      considered part of the completion, but the rest will.  INDEX may be
  234.      negative to count from the end: in most cases, INDEX will be 1 or
  235.      -1.
  236.  
  237. `N[INDEX,STRING] ...'
  238.      Like N[INDEX,STRING] except that the STRING will be taken as a
  239.      character class.  Anything up to and including the INDEX'th
  240.      occurrence of any of the characters in STRING will not be
  241.      considered part of the completion.
  242.  
  243. `M[MIN,MAX] ...'
  244.      Matches if the total number of words lies between MIN and MAX
  245.      inclusive.
  246.  
  247. `R[STR1,STR2] ...'
  248.      Matches if the cursor is after a word with prefix STR1.  If there
  249.      is also a word with prefix STR2 on the command line it matches
  250.      only if the cursor is before this word.
  251.  
  252. `R[STR1,STR2] ...'
  253.      Like R but using pattern matching instead.
  254.  
  255. 
  256. File: zsh.info,  Node: Example,  Prev: Extended Completion,  Up: Programmable Completion
  257.  
  258. Example
  259. =======
  260.  
  261. `compctl -u -x 's[+] c[-1,-f],s[-f+]' -g '~/Mail/*(:t)' -
  262. 's[-f],c[-1,-f]' -f -- mail'
  263.  
  264. This is to be interpreted as follows:
  265.  
  266. If the current command is `mail', then
  267.  
  268. if  ((the current word begins with `+' and the previous word is `-f')
  269. or (the current word begins with `-f+')), then complete the
  270. non-directory part (the `:t' glob modifier) of files in the directory
  271. `~/Mail'; else
  272.  
  273. if the current word begins with `-f' or the previous word was `-f',
  274. then complete any file; else
  275.  
  276. complete user names.
  277.  
  278. 
  279. File: zsh.info,  Node: Concept Index,  Next: Variables Index,  Prev: Programmable Completion,  Up: Top
  280.  
  281. Concept Index
  282. *************
  283.  
  284. * Menu:
  285.  
  286. * $0, setting:                          Description of Options.
  287. * alias:                                Shell Builtin Commands.
  288. * aliases, completion of:               Description of Options.
  289. * aliases, global:                      Aliasing.
  290. * aliases, removing:                    Shell Builtin Commands.
  291. * aliasing:                             Aliasing.
  292. * alternate forms for complex commands: Alternate Forms For Complex Commands.
  293. * ambiguous completions:                Description of Options.
  294. * annoying keyboard, sun:               Description of Options.
  295. * arithmetic evaluation:                Arithmetic Evaluation.
  296. * arithmetic expansion:                 Arithmetic Expansion.
  297. * arithmetic operators:                 Arithmetic Evaluation.
  298. * array elements:                       Array Parameters.
  299. * array expansion, rc style:            Parameter Expansion.
  300. * array parameter, declaring:           Shell Builtin Commands.
  301. * arrays, ksh style:                    Description of Options.
  302. * author:                               Author.
  303. * autoloading functions:                Shell Builtin Commands.
  304. * background jobs, IO:                  Jobs & Signals.
  305. * background jobs, notification:        Description of Options.
  306. * background jobs, priority of:         Description of Options.
  307. * beep, ambiguous completion:           Description of Options.
  308. * beep, enable:                         Description of Options.
  309. * beep, history:                        Description of Options.
  310. * bindings, key:                        Zsh Line Editor.
  311. * brace expansion:                      Brace Expansion.
  312. * brace expansion, disabling:           Description of Options.
  313. * brace expansion, extending:           Description of Options.
  314. * builtin commands:                     Shell Builtin Commands.
  315. * case selection:                       Complex Commands.
  316. * cd, automatic:                        Description of Options.
  317. * cd, behaving like pushd:              Description of Options.
  318. * cd, to parameter:                     Description of Options.
  319. * clobbering, of files:                 Description of Options.
  320. * command execution:                    Command Execution.
  321. * command execution, enabling:          Description of Options.
  322. * command hashing:                      Description of Options.
  323. * command substitution:                 Command Substitution.
  324. * commands, alternate forms for complex: Alternate Forms For Complex Commands.
  325. * commands, complex:                    Complex Commands.
  326. * commands, disabling:                  Shell Builtin Commands.
  327. * commands, simple:                     Simple Commands & Pipelines.
  328. * comments:                             Comments.
  329. * comments, in interactive shells:      Description of Options.
  330. * compatibility:                        Compatibility.
  331. * compatibility, csh:                   Shell Builtin Commands.
  332. * compatibility, ksh:                   Shell Builtin Commands.
  333. * compatibility, sh:                    Shell Builtin Commands.
  334. * completion, beep on ambiguous:        Description of Options.
  335. * completion, controlling:              Programmable Completion.
  336. * completion, exact matches:            Description of Options.
  337. * completion, listing choices:          Description of Options.
  338. * completion, menu:                     Description of Options.
  339. * completion, menu, on TAB:             Description of Options.
  340. * completion, programmable:             Programmable Completion.
  341. * completions, ambiguous:               Description of Options.
  342. * complex commands:                     Complex Commands.
  343. * conditional expressions:              Conditional Expressions.
  344. * continuing loops:                     Shell Builtin Commands.
  345. * coprocesses:                          Simple Commands & Pipelines.
  346. * correction, spelling:                 Description of Options.
  347. * csh, compatibility:                   Shell Builtin Commands.
  348. * csh, history style:                   Description of Options.
  349. * csh, loop style:                      Description of Options.
  350. * csh, null command style:              Parameters Used By The Shell.
  351. * csh, null globbing style:             Description of Options.
  352. * csh, quoting style:                   Description of Options.
  353. * csh, tilde expansion:                 Parameter Expansion.
  354. * descriptors, file:                    Redirection.
  355. * directories, changing:                Shell Builtin Commands.
  356. * directories, hashing:                 Description of Options.
  357. * directories, marking:                 Description of Options.
  358. * directories, named <1>:               Description of Options.
  359. * directories, named:                   Filename Expansion.
  360. * directory stack, ignoring dups:       Description of Options.
  361. * directory stack, printing:            Shell Builtin Commands.
  362. * directory stack, silencing:           Description of Options.
  363. * disabling brace expansion:            Description of Options.
  364. * disabling commands:                   Shell Builtin Commands.
  365. * disabling the editor:                 Description of Options.
  366. * disowning jobs:                       Jobs & Signals.
  367. * echo, BSD compatible:                 Description of Options.
  368. * editing parameters:                   Shell Builtin Commands.
  369. * editing the history:                  Shell Builtin Commands.
  370. * editor, disabling:                    Description of Options.
  371. * editor, line:                         Zsh Line Editor.
  372. * editor, modes:                        Zsh Line Editor.
  373. * editor, overstrike mode:              Description of Options.
  374. * editor, single line mode:             Description of Options.
  375. * enable history substitution:          Description of Options.
  376. * enable the beep:                      Description of Options.
  377. * enabling globbing:                    Description of Options.
  378. * EOF, ignoring:                        Description of Options.
  379. * evaluating arguments as commands:     Shell Builtin Commands.
  380. * evaluation, arithmetic:               Arithmetic Evaluation.
  381. * event designators, history:           Event Designators.
  382. * exclusion, globbing:                  Filename Generation.
  383. * execution, of commands:               Command Execution.
  384. * execution, timed:                     Shell Builtin Commands.
  385. * exit status, printing:                Description of Options.
  386. * exit status, trapping:                Description of Options.
  387. * exiting loops:                        Shell Builtin Commands.
  388. * expanding parameters:                 Shell Builtin Commands.
  389. * expansion:                            Expansion.
  390. * expansion style, sh:                  Description of Options.
  391. * expansion, arithmetic:                Arithmetic Expansion.
  392. * expansion, brace:                     Brace Expansion.
  393. * expansion, brace, disabling:          Description of Options.
  394. * expansion, brace, extended:           Description of Options.
  395. * expansion, filename:                  Filename Expansion.
  396. * expansion, history:                   History Expansion.
  397. * expansion, parameter:                 Parameter Expansion.
  398. * export, automatic:                    Description of Options.
  399. * expressions, conditional:             Conditional Expressions.
  400. * features, undocumented:               Undocumented Features.
  401. * file clobbering, allowing:            Description of Options.
  402. * file descriptors:                     Redirection.
  403. * file, history:                        Shell Builtin Commands.
  404. * filename expansion:                   Filename Expansion.
  405. * filename generation:                  Filename Generation.
  406. * filename generation, bad pattern:     Description of Options.
  407. * filename substitution, =:             Description of Options.
  408. * files used:                           Startup/Shutdown Files.
  409. * files, marking type of:               Description of Options.
  410. * files, shutdown:                      Startup/Shutdown Files.
  411. * files, startup:                       Startup/Shutdown Files.
  412. * files, temporary:                     Process Substitution.
  413. * flags, shell:                         Invocation.
  414. * flow control:                         Description of Options.
  415. * for loops:                            Complex Commands.
  416. * functions:                            Functions.
  417. * functions, autoloading:               Shell Builtin Commands.
  418. * functions, removing:                  Shell Builtin Commands.
  419. * functions, returning from:            Shell Builtin Commands.
  420. * globbing:                             Filename Generation.
  421. * globbing, enabling:                   Description of Options.
  422. * globbing, excluding patterns:         Filename Generation.
  423. * globbing, extended:                   Description of Options.
  424. * globbing, malformed pattern:          Description of Options.
  425. * globbing, no matches:                 Description of Options.
  426. * globbing, null, csh style:            Description of Options.
  427. * globbing, of . files:                 Description of Options.
  428. * globbing, qualifiers:                 Filename Generation.
  429. * globbing, sh style:                   Description of Options.
  430. * grammar, shell:                       Shell Grammar.
  431. * hashing, of commands:                 Description of Options.
  432. * hashing, of directories:              Description of Options.
  433. * history:                              History Expansion.
  434. * history beeping:                      Description of Options.
  435. * history event designators:            Event Designators.
  436. * history expansion:                    History Expansion.
  437. * history modifiers:                    Modifiers.
  438. * history word designators:             Word Designators.
  439. * history, appending to file:           Description of Options.
  440. * history, editing:                     Shell Builtin Commands.
  441. * history, enable substitution:         Description of Options.
  442. * history, file:                        Shell Builtin Commands.
  443. * history, ignoring duplicates:         Description of Options.
  444. * history, ignoring spaces:             Description of Options.
  445. * history, timestamping:                Description of Options.
  446. * history, verifying substitution:      Description of Options.
  447. * if construct:                         Complex Commands.
  448. * integer parameters:                   Arithmetic Evaluation.
  449. * invocation:                           Invocation.
  450. * job control, allowing:                Description of Options.
  451. * jobs:                                 Jobs & Signals.
  452. * jobs, background priority:            Description of Options.
  453. * jobs, background, IO:                 Jobs & Signals.
  454. * jobs, disowning:                      Jobs & Signals.
  455. * jobs, hup:                            Description of Options.
  456. * jobs, killing:                        Shell Builtin Commands.
  457. * jobs, list format:                    Description of Options.
  458. * jobs, referring to:                   Jobs & Signals.
  459. * jobs, resuming automatically:         Description of Options.
  460. * jobs, suspending:                     Jobs & Signals.
  461. * jobs, waiting for:                    Shell Builtin Commands.
  462. * key bindings:                         Zsh Line Editor.
  463. * keys, rebinding:                      Shell Builtin Commands.
  464. * killing jobs:                         Shell Builtin Commands.
  465. * ksh, compatibility <1>:               Shell Builtin Commands.
  466. * ksh, compatibility:                   Compatibility.
  467. * ksh, editor mode:                     Zsh Line Editor.
  468. * ksh, null command style:              Parameters Used By The Shell.
  469. * ksh, option printing style:           Description of Options.
  470. * ksh, single letter options style:     Description of Options.
  471. * ksh, style arrays:                    Description of Options.
  472. * limits, resource:                     Shell Builtin Commands.
  473. * line editor:                          Zsh Line Editor.
  474. * line, reading:                        Shell Builtin Commands.
  475. * links, symbolic:                      Description of Options.
  476. * list:                                 Simple Commands & Pipelines.
  477. * list format, of jobs:                 Description of Options.
  478. * loop style, csh:                      Description of Options.
  479. * loops, continuing:                    Shell Builtin Commands.
  480. * loops, exiting:                       Shell Builtin Commands.
  481. * loops, for:                           Complex Commands.
  482. * loops, repeat:                        Complex Commands.
  483. * loops, until:                         Complex Commands.
  484. * loops, while:                         Complex Commands.
  485. * mail, warning of arrival:             Description of Options.
  486. * mailing lists:                        Mailing Lists.
  487. * marking directories:                  Description of Options.
  488. * marking file types:                   Description of Options.
  489. * mode, privileged:                     Description of Options.
  490. * modifiers, history:                   Modifiers.
  491. * modifiers, precommand:                Precommand Modifiers.
  492. * named directories:                    Filename Expansion.
  493. * notification of background jobs:      Description of Options.
  494. * null command, setting:                Parameters Used By The Shell.
  495. * null globbing, csh style:             Description of Options.
  496. * operators, arithmetic:                Arithmetic Evaluation.
  497. * option printing, ksh style:           Description of Options.
  498. * options:                              Options.
  499. * options, description:                 Description of Options.
  500. * options, processing:                  Shell Builtin Commands.
  501. * options, setting:                     Shell Builtin Commands.
  502. * options, single letter:               Single Letter Options.
  503. * options, specifying:                  Specifying Options.
  504. * options, unsetting:                   Shell Builtin Commands.
  505. * overstrike mode, of editor:           Description of Options.
  506. * parameter expansion:                  Parameter Expansion.
  507. * parameters:                           Parameters.
  508. * parameters, array:                    Shell Builtin Commands.
  509. * parameters, editing:                  Shell Builtin Commands.
  510. * parameters, expanding:                Shell Builtin Commands.
  511. * parameters, integer:                  Arithmetic Evaluation.
  512. * parameters, marking readonly:         Shell Builtin Commands.
  513. * parameters, positional:               Shell Builtin Commands.
  514. * parameters, setting:                  Shell Builtin Commands.
  515. * parameters, substituting unset:       Description of Options.
  516. * parameters, unsetting:                Shell Builtin Commands.
  517. * path search, extended:                Description of Options.
  518. * pipeline:                             Simple Commands & Pipelines.
  519. * popd, controlling syntax:             Description of Options.
  520. * precommand modifiers:                 Precommand Modifiers.
  521. * privileged mode:                      Description of Options.
  522. * process substitution:                 Process Substitution.
  523. * prompt, with CR:                      Description of Options.
  524. * pushd, making cd behave like:         Description of Options.
  525. * pushd, to home:                       Description of Options.
  526. * qualifiers, globbing:                 Filename Generation.
  527. * querying before rm *:                 Description of Options.
  528. * quoting:                              Quoting.
  529. * quoting style, csh:                   Description of Options.
  530. * quoting style, rc:                    Description of Options.
  531. * rc, array expansion style:            Parameter Expansion.
  532. * rc, quoting style:                    Description of Options.
  533. * reading a line:                       Shell Builtin Commands.
  534. * rebinding the keys:                   Shell Builtin Commands.
  535. * redirection:                          Redirection.
  536. * referring to jobs:                    Jobs & Signals.
  537. * repeat loops:                         Complex Commands.
  538. * reserved words:                       Reserved Words.
  539. * resource limits:                      Shell Builtin Commands.
  540. * resuming jobs automatically:          Description of Options.
  541. * rm *, querying before:                Description of Options.
  542. * selection, case:                      Complex Commands.
  543. * selection, user:                      Complex Commands.
  544. * sh, compatibility <1>:                Shell Builtin Commands.
  545. * sh, compatibility:                    Compatibility.
  546. * sh, expansion style:                  Description of Options.
  547. * sh, globbing style:                   Description of Options.
  548. * sh, word splitting style <1>:         Description of Options.
  549. * sh, word splitting style:             Parameter Expansion.
  550. * shell flags:                          Invocation.
  551. * shell grammar:                        Shell Grammar.
  552. * shell, suspending:                    Shell Builtin Commands.
  553. * shell, timing:                        Shell Builtin Commands.
  554. * signals:                              Jobs & Signals.
  555. * signals, trapping <1>:                Shell Builtin Commands.
  556. * signals, trapping:                    Functions.
  557. * simple commands:                      Simple Commands & Pipelines.
  558. * single command:                       Description of Options.
  559. * single letter options, ksh style:     Description of Options.
  560. * slash, removing trailing:             Description of Options.
  561. * sorting, numerically:                 Description of Options.
  562. * spelling correction:                  Description of Options.
  563. * startup files:                        Startup/Shutdown Files.
  564. * startup files, sourcing:              Description of Options.
  565. * sublist:                              Simple Commands & Pipelines.
  566. * subshells:                            Complex Commands.
  567. * substitution, command:                Command Substitution.
  568. * substitution, process:                Process Substitution.
  569. * substrings:                           Array Parameters.
  570. * sun keyboard, annoying:               Description of Options.
  571. * suspending jobs:                      Jobs & Signals.
  572. * symbolic links:                       Description of Options.
  573. * temporary files:                      Process Substitution.
  574. * termcap string, printing:             Shell Builtin Commands.
  575. * testing conditional expression:       Complex Commands.
  576. * tilde expansion, csh:                 Parameter Expansion.
  577. * timed execution:                      Shell Builtin Commands.
  578. * timing:                               Complex Commands.
  579. * timing the shell:                     Shell Builtin Commands.
  580. * tracing, of commands:                 Description of Options.
  581. * tracing, of input lines:              Description of Options.
  582. * trapping signals <1>:                 Shell Builtin Commands.
  583. * trapping signals:                     Functions.
  584. * tty, freezing:                        Shell Builtin Commands.
  585. * umask:                                Shell Builtin Commands.
  586. * unset parameters, substituting:       Description of Options.
  587. * until loops:                          Complex Commands.
  588. * user selection:                       Complex Commands.
  589. * users, watching:                      Shell Builtin Commands.
  590. * waiting for jobs:                     Shell Builtin Commands.
  591. * watching users:                       Shell Builtin Commands.
  592. * while loops:                          Complex Commands.
  593. * word designators, history:            Word Designators.
  594. * word splitting, sh style <1>:         Description of Options.
  595. * word splitting, sh style:             Parameter Expansion.
  596.  
  597. 
  598. File: zsh.info,  Node: Variables Index,  Next: Options Index,  Prev: Concept Index,  Up: Top
  599.  
  600. Variables Index
  601. ***************
  602.  
  603. * Menu:
  604.  
  605. * !:                                    Parameters Set By The Shell.
  606. * #:                                    Parameters Set By The Shell.
  607. * $:                                    Parameters Set By The Shell.
  608. * *:                                    Parameters Set By The Shell.
  609. * -:                                    Parameters Set By The Shell.
  610. * ?:                                    Parameters Set By The Shell.
  611. * @:                                    Parameters Set By The Shell.
  612. * _:                                    Parameters Set By The Shell.
  613. * ARGC:                                 Parameters Set By The Shell.
  614. * argv:                                 Parameters Set By The Shell.
  615. * ARGV0:                                Parameters Used By The Shell.
  616. * BAUD:                                 Parameters Used By The Shell.
  617. * cdpath:                               Parameters Used By The Shell.
  618. * COLUMNS:                              Parameters Used By The Shell.
  619. * DIRSTACKSIZE:                         Parameters Used By The Shell.
  620. * EDITOR:                               Zsh Line Editor.
  621. * EGID:                                 Parameters Set By The Shell.
  622. * ERRNO:                                Parameters Set By The Shell.
  623. * EUID:                                 Parameters Set By The Shell.
  624. * FCEDIT:                               Parameters Used By The Shell.
  625. * fignore:                              Parameters Used By The Shell.
  626. * fpath:                                Parameters Used By The Shell.
  627. * GID:                                  Parameters Set By The Shell.
  628. * histchars:                            Parameters Used By The Shell.
  629. * histchars, use of:                    Comments.
  630. * HISTFILE:                             Parameters Used By The Shell.
  631. * HISTSIZE:                             Parameters Used By The Shell.
  632. * HISTSIZE, use of:                     History Expansion.
  633. * HOME:                                 Parameters Used By The Shell.
  634. * HOST:                                 Parameters Set By The Shell.
  635. * IFS <1>:                              Shell Builtin Commands.
  636. * IFS:                                  Parameters Used By The Shell.
  637. * IFS, use of <1>:                      Command Substitution.
  638. * IFS, use of:                          Parameter Expansion.
  639. * KEYTIMEOUT:                           Parameters Used By The Shell.
  640. * LANG:                                 Parameters Used By The Shell.
  641. * LC_ALL:                               Parameters Used By The Shell.
  642. * LC_COLLATE:                           Parameters Used By The Shell.
  643. * LC_CTYPE:                             Parameters Used By The Shell.
  644. * LC_MESSAGES:                          Parameters Used By The Shell.
  645. * LC_TIME:                              Parameters Used By The Shell.
  646. * LINENO:                               Parameters Set By The Shell.
  647. * LINES:                                Parameters Used By The Shell.
  648. * LISTMAX:                              Parameters Used By The Shell.
  649. * LOGCHECK:                             Parameters Used By The Shell.
  650. * LOGNAME:                              Parameters Set By The Shell.
  651. * MACHTYPE:                             Parameters Set By The Shell.
  652. * MAIL:                                 Parameters Used By The Shell.
  653. * MAILCHECK:                            Parameters Used By The Shell.
  654. * mailpath:                             Parameters Used By The Shell.
  655. * manpath:                              Parameters Used By The Shell.
  656. * NULLCMD:                              Parameters Used By The Shell.
  657. * OLDPWD:                               Parameters Set By The Shell.
  658. * OPTARG:                               Parameters Set By The Shell.
  659. * OPTARG, use of:                       Shell Builtin Commands.
  660. * OPTIND:                               Parameters Set By The Shell.
  661. * OPTIND, use of:                       Shell Builtin Commands.
  662. * OSTYPE:                               Parameters Set By The Shell.
  663. * path:                                 Parameters Used By The Shell.
  664. * path, use of:                         Command Execution.
  665. * PERIOD:                               Functions.
  666. * POSTEDIT:                             Parameters Used By The Shell.
  667. * PPID:                                 Parameters Set By The Shell.
  668. * PROMPT:                               Parameters Used By The Shell.
  669. * PROMPT2:                              Parameters Used By The Shell.
  670. * PROMPT3:                              Parameters Used By The Shell.
  671. * PROMPT4:                              Parameters Used By The Shell.
  672. * PS1:                                  Parameters Used By The Shell.
  673. * PS2:                                  Parameters Used By The Shell.
  674. * PS3:                                  Parameters Used By The Shell.
  675. * PS4:                                  Parameters Used By The Shell.
  676. * psvar:                                Parameters Used By The Shell.
  677. * PWD:                                  Parameters Set By The Shell.
  678. * RANDOM:                               Parameters Set By The Shell.
  679. * READNULLCMD:                          Parameters Used By The Shell.
  680. * REPORTTIME:                           Parameters Used By The Shell.
  681. * RPROMPT:                              Parameters Used By The Shell.
  682. * RPS1:                                 Parameters Used By The Shell.
  683. * SAVEHIST:                             Parameters Used By The Shell.
  684. * SECONDS:                              Parameters Set By The Shell.
  685. * SHLVL:                                Parameters Set By The Shell.
  686. * signals:                              Parameters Set By The Shell.
  687. * SPROMPT:                              Parameters Used By The Shell.
  688. * status:                               Parameters Set By The Shell.
  689. * STTY:                                 Parameters Used By The Shell.
  690. * TERM:                                 Zsh Line Editor.
  691. * TIMEFMT:                              Parameters Used By The Shell.
  692. * TMOUT:                                Parameters Used By The Shell.
  693. * TMPPREFIX:                            Parameters Used By The Shell.
  694. * TTY:                                  Parameters Set By The Shell.
  695. * TTYIDLE:                              Parameters Set By The Shell.
  696. * UID:                                  Parameters Set By The Shell.
  697. * USERNAME:                             Parameters Set By The Shell.
  698. * VENDOR:                               Parameters Set By The Shell.
  699. * VISUAL:                               Zsh Line Editor.
  700. * watch:                                Parameters Used By The Shell.
  701. * watch, use of:                        Shell Builtin Commands.
  702. * WATCHFMT:                             Parameters Used By The Shell.
  703. * WORDCHARS:                            Parameters Used By The Shell.
  704. * ZDOTDIR:                              Parameters Used By The Shell.
  705. * ZSH_NAME:                             Parameters Set By The Shell.
  706. * ZSH_VERSION:                          Parameters Set By The Shell.
  707. * ZSHNAME:                              Parameters Set By The Shell.
  708.  
  709. 
  710. File: zsh.info,  Node: Options Index,  Next: Functions Index,  Prev: Variables Index,  Up: Top
  711.  
  712. Options Index
  713. *************
  714.  
  715. * Menu:
  716.  
  717. * ALL_EXPORT:                           Description of Options.
  718. * ALWAYS_LAST_PROMPT:                   Description of Options.
  719. * ALWAYS_TO_END:                        Description of Options.
  720. * APPEND_HISTORY:                       Description of Options.
  721. * AUTO_CD:                              Description of Options.
  722. * AUTO_LIST:                            Description of Options.
  723. * AUTO_MENU:                            Description of Options.
  724. * AUTO_NAME_DIRS:                       Description of Options.
  725. * AUTO_PARAM_KEYS:                      Description of Options.
  726. * AUTO_PARAM_SLASH:                     Description of Options.
  727. * AUTO_PUSHD:                           Description of Options.
  728. * AUTO_PUSHD, use of:                   Parameters Used By The Shell.
  729. * AUTO_REMOVE_SLASH:                    Description of Options.
  730. * AUTO_RESUME:                          Description of Options.
  731. * BAD_PATTERN:                          Description of Options.
  732. * BANG_HIST:                            Description of Options.
  733. * BEEP:                                 Description of Options.
  734. * BG_NICE:                              Description of Options.
  735. * BRACE_CCL:                            Description of Options.
  736. * BRACE_CCL, use of:                    Brace Expansion.
  737. * BSD_ECHO:                             Description of Options.
  738. * BSD_ECHO, use of:                     Shell Builtin Commands.
  739. * CDABLE_VARS:                          Description of Options.
  740. * CDABLEVARS, use of:                   Shell Builtin Commands.
  741. * CHASE_LINKS:                          Description of Options.
  742. * CHASE_LINKS, use of:                  Shell Builtin Commands.
  743. * CLOBBER:                              Description of Options.
  744. * CLOBBER, use of:                      Redirection.
  745. * COMPLETE_ALIASES:                     Description of Options.
  746. * COMPLETE_IN_WORD:                     Description of Options.
  747. * CORRECT:                              Description of Options.
  748. * CORRECT_ALL:                          Description of Options.
  749. * CSH_JUNKIE_HISTORY:                   Description of Options.
  750. * CSH_JUNKIE_LOOPS <1>:                 Description of Options.
  751. * CSH_JUNKIE_LOOPS:                     Parameter Expansion.
  752. * CSH_JUNKIE_QUOTES:                    Description of Options.
  753. * CSH_NULL_GLOB:                        Description of Options.
  754. * EQUALS:                               Description of Options.
  755. * ERR_EXIT:                             Description of Options.
  756. * EXEC:                                 Description of Options.
  757. * EXTENDED_GLOB:                        Description of Options.
  758. * EXTENDED_GLOB, use of:                Filename Generation.
  759. * EXTENDED_HISTORY:                     Description of Options.
  760. * FLOW_CONTROL:                         Description of Options.
  761. * FUNCTION_ARGZERO:                     Description of Options.
  762. * GLOB:                                 Description of Options.
  763. * GLOB, use of:                         Filename Generation.
  764. * GLOB_ASSIGN:                          Description of Options.
  765. * GLOB_COMPLETE:                        Description of Options.
  766. * GLOB_DOTS:                            Description of Options.
  767. * GLOB_DOTS, setting in pattern:        Filename Generation.
  768. * GLOB_DOTS, use of:                    Filename Generation.
  769. * GLOB_SUBST:                           Description of Options.
  770. * HASH_CMDS:                            Description of Options.
  771. * HASH_DIRS:                            Description of Options.
  772. * HASH_LIST_ALL:                        Description of Options.
  773. * HIST_ALLOW_CLOBBER:                   Description of Options.
  774. * HIST_BEEP:                            Description of Options.
  775. * HIST_IGNORE_DUPS:                     Description of Options.
  776. * HIST_IGNORE_SPACE:                    Description of Options.
  777. * HIST_NO_STORE:                        Description of Options.
  778. * HIST_VERIFY:                          Description of Options.
  779. * HUP:                                  Description of Options.
  780. * IGNORE_BRACES:                        Description of Options.
  781. * IGNORE_EOF:                           Description of Options.
  782. * IGNORE_EOF, use of:                   Shell Builtin Commands.
  783. * INTERACTIVE:                          Description of Options.
  784. * INTERACTIVE, use of:                  Description of Options.
  785. * INTERACTIVE_COMMENTS:                 Description of Options.
  786. * INTERACTIVE_COMMENTS, use of <1>:     Miscellaneous.
  787. * INTERACTIVE_COMMENTS, use of:         Comments.
  788. * KSH_ARRAYS:                           Description of Options.
  789. * KSH_ARRAYS, use of:                   Array Parameters.
  790. * KSH_OPTION_PRINT:                     Description of Options.
  791. * LIST_AMBIGUOUS:                       Description of Options.
  792. * LIST_BEEP:                            Description of Options.
  793. * LIST_TYPES:                           Description of Options.
  794. * LOCAL_OPTIONS:                        Description of Options.
  795. * LOGIN:                                Description of Options.
  796. * LONG_LIST_JOBS:                       Description of Options.
  797. * MAGIC_EQUAL_SUBST:                    Description of Options.
  798. * MAIL_WARNING:                         Description of Options.
  799. * MARK_DIRS:                            Description of Options.
  800. * MARK_DIRS, setting in pattern:        Filename Generation.
  801. * MENU_COMPLETE:                        Description of Options.
  802. * MENU_COMPLETE, use of:                Completion.
  803. * MONITOR:                              Description of Options.
  804. * MONITOR, use of:                      Jobs & Signals.
  805. * MULTIOS:                              Description of Options.
  806. * MULTIOS, use of:                      Redirection.
  807. * NO_NOMATCH:                           Description of Options.
  808. * NO_RCS, use of:                       Startup/Shutdown Files.
  809. * NOMATCH, use of:                      Filename Generation.
  810. * NOTIFY:                               Description of Options.
  811. * NULL_GLOB:                            Description of Options.
  812. * NULL_GLOB, setting in pattern:        Filename Generation.
  813. * NULL_GLOB, use of:                    Filename Generation.
  814. * NUMERIC_GLOB_SORT:                    Description of Options.
  815. * OVER_STRIKE:                          Description of Options.
  816. * PATH_DIRS:                            Description of Options.
  817. * POSIX_BUILTINS:                       Description of Options.
  818. * PRINT_EXIT_VALUE:                     Description of Options.
  819. * PRIVILEGED:                           Description of Options.
  820. * PROMPT_CR:                            Description of Options.
  821. * PROMPT_SUBST:                         Description of Options.
  822. * PUSHD_IGNORE_DUPS:                    Description of Options.
  823. * PUSHD_MINUS:                          Description of Options.
  824. * PUSHD_MINUS, use of <1>:              Shell Builtin Commands.
  825. * PUSHD_MINUS, use of:                  Filename Expansion.
  826. * PUSHD_SILENT:                         Description of Options.
  827. * PUSHD_SILENT, use of:                 Shell Builtin Commands.
  828. * PUSHD_TO_HOME:                        Description of Options.
  829. * PUSHD_TO_HOME, use of:                Shell Builtin Commands.
  830. * RC_EXPAND_PARAM:                      Description of Options.
  831. * RC_EXPAND_PARAM, use of:              Parameter Expansion.
  832. * RC_QUOTES:                            Description of Options.
  833. * RCS:                                  Description of Options.
  834. * REC_EXACT:                            Description of Options.
  835. * RM_STAR_SILENT:                       Description of Options.
  836. * SH_FILE_EXPANSION:                    Description of Options.
  837. * SH_GLOB:                              Description of Options.
  838. * SH_OPTION_LETTERS:                    Description of Options.
  839. * SH_WORD_SPLIT:                        Description of Options.
  840. * SH_WORD_SPLIT, use of:                Parameter Expansion.
  841. * SHIN_STDIN:                           Description of Options.
  842. * SHORT_LOOPS:                          Description of Options.
  843. * SINGLE_COMMAND:                       Description of Options.
  844. * SINGLE_LINE_ZLE:                      Description of Options.
  845. * SINGLE_LINE_ZLE, use of:              Zsh Line Editor.
  846. * SUN_KEYBOARD_HACK:                    Description of Options.
  847. * UNSET:                                Description of Options.
  848. * VERBOSE:                              Description of Options.
  849. * XTRACE:                               Description of Options.
  850. * ZLE:                                  Description of Options.
  851. * ZLE, use of:                          Zsh Line Editor.
  852.  
  853.