home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume35 / zsh / part06 < prev    next >
Text File  |  1993-02-20  |  56KB  |  1,903 lines
  1. Newsgroups: comp.sources.misc
  2. From: zsh-list@cs.uow.edu.au (The Zsh Mailing List)
  3. Subject: v35i056:  zsh - The Z Shell, version 2.3.1, Part06/22
  4. Message-ID: <1993Feb20.212201.28411@sparky.imd.sterling.com>
  5. X-Md4-Signature: 2ee3f57f0511f5fa1420edc970fa6f61
  6. Date: Sat, 20 Feb 1993 21:22:01 GMT
  7. Approved: kent@sparky.imd.sterling.com
  8.  
  9. Submitted-by: zsh-list@cs.uow.edu.au (The Zsh Mailing List)
  10. Posting-number: Volume 35, Issue 56
  11. Archive-name: zsh/part06
  12. Environment: UNIX
  13. Supersedes: zsh2.2: Volume 29, Issue 97-113
  14.  
  15. #! /bin/sh
  16. # This is a shell archive.  Remove anything before this line, then feed it
  17. # into a shell via "sh file" or similar.  To overwrite existing files,
  18. # type "sh file -c".
  19. # The tool that generated this appeared in the comp.sources.unix newsgroup;
  20. # send mail to comp-sources-unix@uunet.uu.net if you want that tool.
  21. # Contents:  help/read man/man1/zsh.1.02 src/signals.h.sample
  22. # Wrapped by mattson@odin on Sat Feb  6 14:41:52 1993
  23. PATH=/bin:/usr/bin:/usr/ucb ; export PATH
  24. echo If this archive is complete, you will see the following message:
  25. echo '          "shar: End of archive 6 (of 22)."'
  26. if test -f 'help/read' -a "${1}" != "-c" ; then 
  27.   echo shar: Will not clobber existing file \"'help/read'\"
  28. else
  29.   echo shar: Extracting \"'help/read'\" \(1012 characters\)
  30.   sed "s/^X//" >'help/read' <<'END_OF_FILE'
  31. X     read [ -rzp ] [ -un ] [ name?prompt ] [ name ...  ]
  32. X          Read one line and break it into fields using the  char-
  33. X          acters  in  IFS as separators.  In raw mode, -r, a \ at
  34. X          the end of a line does not signify  line  continuation.
  35. X          If  the  -z  flag  is  set, read from the editor buffer
  36. X          stack.  The first field is assigned to the first  name,
  37. X          the  second  field to the second name, etc., with left-
  38. X          over fields assigned to the  last  name.   If  name  is
  39. X          omitted  then REPLY is used.  If -un is specified, then
  40. X          input is read from file descriptor n; if -p  is  speci-
  41. X          fied,  then input is read from the coprocess.  The exit
  42. X          status is 0 unless end-of-file is encountered.  If  the
  43. X          first argument contains a ?, the remainder of this word
  44. X          is used as a prompt on standard error when the shell is
  45. X          interactive.   The  exit  status is 0 unless an end-of-
  46. X          file is encountered.
  47. END_OF_FILE
  48.   if test 1012 -ne `wc -c <'help/read'`; then
  49.     echo shar: \"'help/read'\" unpacked with wrong size!
  50.   fi
  51.   # end of 'help/read'
  52. fi
  53. if test -f 'man/man1/zsh.1.02' -a "${1}" != "-c" ; then 
  54.   echo shar: Will not clobber existing file \"'man/man1/zsh.1.02'\"
  55. else
  56.   echo shar: Extracting \"'man/man1/zsh.1.02'\" \(49353 characters\)
  57.   sed "s/^X//" >'man/man1/zsh.1.02' <<'END_OF_FILE'
  58. XSearch in the history list for a line matching the current one and
  59. Xfetch the event following it.
  60. X.TP
  61. X\fBinsert-last-word\fP (ESC-_ ESC-.)
  62. XInsert the last word from the previous history event at the
  63. Xcursor position.
  64. X.TP
  65. X\fBvi-repeat-search\fP (unbound) (n)
  66. XRepeat the last vi history search.
  67. X.TP
  68. X\fBvi-rev-repeat-search\fP (unbound) (N)
  69. XRepeat the last vi history search, but in reverse.
  70. X.TP
  71. X\fBtoggle-literal-history\fP (ESC-R ESC-r)
  72. XToggle between literal and lexical history.  The default is
  73. Xlexical history unless the \fBHISTLIT\fP option is set.
  74. X.TP
  75. X\fBup-line-or-history\fP (^P ESC-[A) (- k)
  76. XMove up a line in the buffer, or if already at the top line,
  77. Xmove to the previous event in the history list.
  78. X.TP
  79. X\fBup-line-or-search\fP
  80. XMove up a line in the buffer, or if already at the top line,
  81. Xsearch backward in the history for a line beginning with the
  82. Xfirst word in the buffer.
  83. X.TP
  84. X\fBup-history\fP (unbound) (^P)
  85. XMove to the previous event in the history list.
  86. X.SS Modifying Text
  87. X.TP
  88. X\fBvi-add-eol\fP (unbound) (A)
  89. XMove to the end of the line and enter insert mode.
  90. X.TP
  91. X\fBvi-add-next\fP (unbound) (a)
  92. XMove forward one character and enter insert mode.
  93. X.TP
  94. X\fBbackward-delete-char\fP (^H ^?) (^?)
  95. XDelete the character behind the cursor.
  96. X.TP
  97. X\fBvi-backward-delete-char\fP (unbound) (X)
  98. XDelete the character behind the cursor, without changing lines.
  99. X.TP
  100. X\fBbackward-delete-word\fP
  101. XDelete the word behind the cursor.
  102. X.TP
  103. X\fBbackward-kill-line\fP
  104. XKill from the beginning of the line to the cursor position.
  105. X.TP
  106. X\fBbackward-kill-word\fP (^W ESC-^H ESC-^?)
  107. XKill the word behind the cursor.
  108. X.TP
  109. X\fBvi-backward-kill-word\fP (unbound) (^W)
  110. XKill the word behind the cursor.
  111. X.TP
  112. X\fBcapitalize-word\fP (ESC-C ESC-c)
  113. XCapitalize the current word and move past it.
  114. X.TP
  115. X\fBvi-change\fP (unbound) (c)
  116. XRead a movement command from the keyboard, and kill
  117. Xfrom the cursor position to the endpoint of the movement.
  118. XThen enter insert mode.
  119. XIf the command is \fBvi-change\fP, kill the current line.
  120. X.TP
  121. X\fBvi-change-eol\fP (unbound) (C)
  122. XKill to the end of the line and enter insert mode.
  123. X.TP
  124. X\fBvi-change-whole-line\fP (unbound) (S s)
  125. XKill the current line and enter insert mode.
  126. X.TP
  127. X\fBcopy-region-as-kill\fP (ESC-W ESC-w)
  128. XCopy the area from the cursor to the mark to the kill buffer.
  129. X.TP
  130. X\fBcopy-prev-word\fP (ESC-^_)
  131. XDuplicate the word behind the cursor.
  132. X.TP
  133. X\fBvi-delete\fP (unbound) (d)
  134. XRead a movement command from the keyboard, and kill 
  135. Xfrom the cursor position to the endpoint of the movement.
  136. XIf the command is \fBvi-delete\fP, kill the current line.
  137. X.TP
  138. X\fBdelete-char\fP (unbound) (x)
  139. XDelete the character under the cursor.
  140. X.TP
  141. X\fBvi-delete-char\fP (unbound) (x)
  142. XDelete the character under the cursor.
  143. X.TP
  144. X\fBdelete-word\fP (ESC-D ESC-d)
  145. XDelete the current word.
  146. X.TP
  147. X\fBdown-case-word\fP (ESC-L ESC-l)
  148. XConvert the current word to all lowercase and move past it.
  149. X.TP
  150. X\fBkill-word\fP
  151. XKill the current word.
  152. X.TP
  153. X\fBgosmacs-transpose-chars\fP
  154. XExchange the two characters behind the cursor.
  155. X.TP
  156. X\fBvi-indent\fP (unbound) (>)
  157. XIndent a number of lines.
  158. X.TP
  159. X\fBvi-insert\fP (unbound) (i)
  160. XEnter insert mode.
  161. X.TP
  162. X\fBvi-insert-bol\fP (unbound) (I)
  163. XMove to the beginning of the line and enter insert mode.\fP
  164. X.TP
  165. X\fBvi-join\fP (^X^J)
  166. XJoin the current line with the next one.
  167. X.TP
  168. X\fBkill-line\fP (^K) (D)
  169. XKill from the cursor to the end of the line.
  170. X.TP
  171. X\fBkill-region\fP
  172. XKill from the cursor to the mark.
  173. X.TP
  174. X\fBkill-buffer\fP (^X^U) (^U)
  175. XKill the entire buffer.
  176. X.TP
  177. X\fBkill-whole-line\fP (^U) (unbound)
  178. XKill the current line.
  179. X.TP
  180. X\fBvi-match-bracket\fP (^X^B) (%)
  181. XMove to the bracket character (one of {\|}, (\|), or [\|]) that
  182. Xmatches the one under the cursor.
  183. X.TP
  184. X\fBvi-open-line-above\fP (unbound) (O)
  185. XOpen a line above the cursor and enter insert mode.
  186. X.TP
  187. X\fBvi-open-line-below\fP (unbound) (o)
  188. XOpen a line below the cursor and enter insert mode.
  189. X.TP
  190. X\fBvi-oper-swap-case\fP
  191. XRead a movement command from the keyboard, and swap
  192. Xthe case of all characters
  193. Xfrom the cursor position to the endpoint of the movement.
  194. XIf the movement command is \fBvi-oper-swap-case\fP,
  195. Xswap the case of all characters on the current line.
  196. X.TP
  197. X\fBoverwrite-mode\fP (^X^O)
  198. XToggle between overwrite mode and insert mode.
  199. X.TP
  200. X\fBvi-put-after\fP (unbound) (p)
  201. XInsert the contents of the kill buffer after the cursor.
  202. X.TP
  203. X\fBquoted-insert\fP (^V)
  204. XInsert the next character typed into the buffer literally.
  205. X.TP
  206. X\fBquote-line\fP (ESC-')
  207. XQuote the current line; that is, put a ' character at the
  208. Xbeginning and the end, and convert all ' characters
  209. Xto '\e''.
  210. X.TP
  211. X\fBquote-region\fP (ESC-")
  212. XQuote the region from the cursor to the mark.
  213. X.TP
  214. X\fBvi-replace\fP (unbound) (R)
  215. XEnter overwrite mode.
  216. X.TP
  217. X\fBvi-repeat-change\fP (unbound) (.)
  218. XRepeat the last vi mode text modification.
  219. X.TP
  220. X\fBvi-replace-chars\fP (unbound) (r)
  221. XReplace the character under the cursor with a character
  222. Xread from the keyboard.
  223. X.TP
  224. X\fBself-insert\fP (printable characters)
  225. XPut a character in the buffer at the cursor position.
  226. X.TP
  227. X\fBself-insert-unmeta\fP (ESC-^I ESC-^J ESC-^M)
  228. XPut a character in the buffer after stripping the meta bit
  229. Xand converting \fB^M\fP to \fB^J\fP.
  230. X.TP
  231. X\fBvi-substitute\fP (unbound) (s)
  232. XSubstitute the next character(s).
  233. X.TP
  234. X\fBvi-swap-case\fP (unbound) (~)
  235. XSwap the case of the character under the cursor and move past it.
  236. X.TP
  237. X\fBtranspose-chars\fP (^T)
  238. XExchange the two characters to the left of the
  239. Xcursor if at end of line, else exchange the
  240. Xcharacter under the cursor with the character
  241. Xto the left.
  242. X.TP
  243. X\fBtranspose-words\fP (ESC-T ESC-t)
  244. XExchange the current word with the one before it.
  245. X.TP
  246. X\fBvi-unindent\fP (unbound) (<)
  247. XUnindent a number of lines.
  248. X.TP
  249. X\fBup-case-word\fP (ESC-U ESC-u)
  250. XConvert the current word to all caps and move past it.
  251. X.TP
  252. X\fByank\fP (^Y) (P)
  253. XInsert the contents of the kill buffer at the cursor position.
  254. X.TP
  255. X\fByank-pop\fP (ESC-y) (unbound)
  256. XRemove the text just yanked, rotate the kill\-ring,
  257. Xand yank the new top.  Only works following
  258. X\fByank\fP or \fByank-pop\fP.
  259. X.TP
  260. X\fBvi-yank\fP (unbound) (y)
  261. XRead a movement command from the keyboard, and copy the region
  262. Xfrom the cursor position to the endpoint of the movement
  263. Xinto the kill buffer.
  264. XIf the command is \fBvi-yank\fP, copy the current line.
  265. X.TP
  266. X\fBvi-yank-eol\fP (unbound) (Y)
  267. XCopy the region from the cursor position to the end of the line
  268. Xinto the kill buffer.
  269. X.SS Arguments
  270. X.TP
  271. X\fBdigit-argument\fP (ESC-0..ESC-9) (0-9)
  272. XStart a new numeric argument, or add to the current one.
  273. X.TP
  274. X\fBuniversal-argument\fP
  275. XMultiply the argument of the next command by 4.
  276. X.SS Completion
  277. X.TP
  278. X\fBaccept-and-menu-complete\fP
  279. XIn a menu completion, insert the current completion into the buffer,
  280. Xand advance to the next possible completion.
  281. X.TP
  282. X\fBcomplete-word\fP (unbound) (\|\e\|)
  283. XAttempt completion on the current word.
  284. X.TP
  285. X\fBdelete-char-or-list\fP (^D)
  286. XDelete the character under the cursor.  If the cursor
  287. Xis at the end of the line, list possible completions for the
  288. Xcurrent word.
  289. X.TP
  290. X\fBexecute-named-cmd\fP (ESC-x)
  291. XRead the name of a editor command and execute it.
  292. X.TP
  293. X\fBexecute-last-named-cmd\fP (ESC-z)
  294. XRedo the last function executed with \fBexecute-named-cmd\fP.
  295. X.TP
  296. X\fBexpand-cmd-path\fP
  297. XExpand the current command to its full pathname.
  298. X.TP
  299. X\fBexpand-or-complete\fP (TAB) (TAB ^X)
  300. XAttempt shell expansion on the current word.
  301. XIf that fails,
  302. Xattempt completion.
  303. X.TP
  304. X\fBexpand-history\fP (ESC-space ESC-!)
  305. XPerform history expansion on the edit buffer.
  306. X.TP
  307. X\fBexpand-word\fP (^X*)
  308. XAttempt shell expansion on the current word.
  309. X.TP
  310. X\fBlist-choices\fP (ESC-^D) (^D =)
  311. XList possible completions for the current word.
  312. X.TP
  313. X\fBlist-expand\fP (^Xg ^XG) (^G)
  314. XList the expansion of the current word.
  315. X.TP
  316. X\fBmagic-space\fP
  317. XPerform history expansion and insert a space into the
  318. Xbuffer.  This is intended to be bound to space.
  319. X.TP
  320. X\fBmenu-complete\fP
  321. XLike \fBcomplete-word\fP, except that menu completion is used.
  322. XSee the \fBMENU_COMPLETE\fP option below.
  323. X.TP
  324. X\fBmenu-expand-or-complete\fP
  325. XLike \fBexpand-or-complete\fP, except that menu completion is used.
  326. X.TP
  327. X\fBreverse-menu-complete\fP
  328. XSee the \fBMENU_COMPLETE\fP option below.
  329. X.SS Miscellaneous
  330. X.TP
  331. X\fBaccept-and-hold\fP (ESC-A ESC-a)
  332. XPush the contents of the buffer on the buffer stack
  333. Xand execute it.
  334. X.TP
  335. X\fBaccept-and-infer-next-history\fP
  336. XExecute the contents of the buffer.
  337. XThen search the history list for a line matching the current one
  338. Xand push the event following onto the buffer stack.
  339. X.TP
  340. X\fBaccept-line\fP (^J ^M)
  341. XExecute the contents of the buffer.
  342. X.TP
  343. X\fBaccept-line-and-down-history\fP (^O)
  344. XExecute the current line, and push the next history
  345. Xevent on the the buffer stack.
  346. X.TP
  347. X\fBvi-cmd-mode\fP (^X^V) (^[)
  348. XEnter command mode; that is, use the alternate keymap.
  349. XYes, this is bound by default in emacs mode.
  350. X.TP
  351. X\fBvi-caps-lock-panic\fP (unbound) (H K)
  352. XHang until any lowercase key is pressed.
  353. XThis is for vi users without the mental capacity to keep
  354. Xtrack of their caps lock key (like the author).
  355. X.TP
  356. X\fBclear-screen\fP (^L ESC-^L)
  357. XClear the screen and redraw the prompt.
  358. X.TP
  359. X\fBexchange-point-and-mark\fP (^X^X)
  360. XExchange the cursor position with the position of the mark.
  361. X.TP
  362. X\fBget-line\fP (ESC-G ESC-g)
  363. XPop the top line off the buffer stack and insert it at the
  364. Xcursor position.
  365. X.TP
  366. X\fBpound-insert\fP (unbound) (#)
  367. XIf there is no # character at the beginning of the current line,
  368. Xadd one.  If there is one, remove it.  In either case, accept the
  369. Xcurrent line.  The \fBINTERACTIVE_COMMENTS\fP option must be set
  370. Xfor this to have any usefulness.
  371. X.TP
  372. X\fBpush-line\fP (^Q ESC-Q ESC-q)
  373. XPush the current buffer onto the buffer stack and clear
  374. Xthe buffer.
  375. XNext time the editor starts up, the buffer will be popped
  376. Xoff the top of the buffer stack and loaded into the editing
  377. Xbuffer.
  378. X.TP
  379. X\fBredisplay\fP (unbound) (^R)
  380. XRedisplays the edit buffer.
  381. X.TP
  382. X\fBrun-help\fP (ESC-H ESC-h)
  383. XPush the buffer onto the buffer stack, and execute the
  384. Xcommand "\fBrun-help\fP \fIcmd\fP", where \fIcmd\fP is the current
  385. Xcommand.  \fBrun-help\fP is normally aliased to \fBman\fP.
  386. X.TP
  387. X\fBsend-break\fP (^C)
  388. XAbort the parsing of the current line.
  389. X.TP
  390. X\fBvi-set-buffer\fP (unbound) (")
  391. XSpecify a buffer to be used in the following command.
  392. X.TP
  393. X\fBvi-set-mark\fP (unbound) (m)
  394. XSet the specified mark at the cursor position.
  395. X.TP
  396. X\fBset-mark-command\fP (^@)
  397. XSet the mark at the cursor position.
  398. X.TP
  399. X\fBspell-word\fP (ESC-$ ESC-S ESC-s)
  400. XAttempt spelling correction on the current word.
  401. X.TP
  402. X\fBundefined-key\fP
  403. XBeep.
  404. X.TP
  405. X\fBundo\fP (^_ ^X^U) (u)
  406. XIncrementally undo the last text modification.
  407. X.TP
  408. X\fBwhich-command\fP (ESC-?)
  409. XPush the buffer onto the buffer stack, and execute the
  410. Xcommand "\fBwhich-command\fP \fIcmd\fP", where \fIcmd\fP is the current
  411. Xcommand.  \fBwhich-command\fP is normally aliased to \fBwhence\fP.
  412. X.SH PARAMETERS
  413. XA parameter has a name, a value, and a number of attributes.
  414. XA name may be any sequence of alphanumeric
  415. Xcharacters and _'s, or the single characters
  416. X*, @, #, ?, \-, $, or !.
  417. XThe value may be either a \fIscalar\fP (a string),
  418. Xan integer, or an array.
  419. XTo assign a scalar or integer value to a parameter,
  420. Xuse the \fBtypeset\fP builtin.
  421. XTo assign an array value, use \fBset \-A\fP \fIname\fP \fIvalue\fP ....
  422. XThe value of a parameter may also be assigned by writing:
  423. X.RS
  424. X.PP
  425. X\fIname\fP=\fIvalue\fP ...
  426. X.RE
  427. X.PP
  428. XIf the integer attribute, \-\fBi\fP, is set for \fIname\fP,
  429. Xthe \fIvalue\fP is subject to arithmetic evaluation.
  430. X.PP
  431. XThe value of an array parameter may be assigned by writing:
  432. X.RS
  433. X.PP
  434. X\fIname\fP=(\fIvalue\fP ...) ...
  435. X.RE
  436. XIndividual elements of an array may be selected using a 
  437. Xsubscript.  A subscript of the form \fB[\fIexp\fB]\fR
  438. Xselects the single element \fIexp\fP, where \fIexp\fP is
  439. Xan arithmetic expression.  The elements are numbered
  440. Xbeginning with 1.
  441. XA subscript of the form \fB[*]\fP or \fB[@]\fP evaluates to all
  442. Xelements of an array; there is no difference between the two
  443. Xexcept when they appear within double quotes.
  444. X"$foo[*]" evaluates to "$foo[1] $foo[2] ...", while
  445. X"$foo[@]" evaluates to "$foo[1]" "$foo[2]", etc.
  446. XA subscript of the form \fB[\fIexp1\fP,\fIexp2\fB]\fR
  447. Xselects all elements in the range \fIexp1\fP to \fIexp2\fP,
  448. Xinclusive.
  449. XIf one of the subscripts evaluates to a negative number,
  450. Xsay \-\fIn\fP, then the \fIn\fPth element from the end
  451. Xof the array is used.  Thus "$foo[-3]" is the third element
  452. Xfrom the end of the array \fIfoo\fP, and
  453. X"$foo[1,-1]" is the same as "$foo[*]".
  454. X.PP
  455. XSubscripting may also be performed on non-array values, in which
  456. Xcase the subscripts specify a substring to be extracted.
  457. XFor example, if \fBFOO\fP is set to \fBfoobar\fP, then
  458. X\fBecho $FOO[2,5]\fP prints \fBooba\fP.
  459. X.SS Positional Parameters
  460. XPositional parameters are set by the shell on invocation,
  461. Xby the \fBset\fP builtin, or by direct assignment.
  462. XThe parameter \fIn\fP, where \fIn\fP is a number,
  463. Xis the \fIn\fPth positional parameter.
  464. XThe parameters \fB*\fP, \fB@\fP, and \fBargv\fP are
  465. Xarrays containing all the positional parameters;
  466. Xthus \fBargv\fP[\fIn\fP], etc. is equivalent to simply \fIn\fP.
  467. X.SS Special Parameters
  468. XThe following parameters are automatically set by the shell:
  469. X.PP
  470. X.RS
  471. X.PD 0
  472. X.TP
  473. X.B !
  474. XThe process id of the last background command invoked.
  475. X.TP
  476. X.B #
  477. XThe number of positional parameters in decimal.
  478. X.TP
  479. X.B ARGC
  480. XSame as \fB#\fP.
  481. X.TP
  482. X.B $
  483. XThe process id of this shell.
  484. X.TP
  485. X.B \-
  486. XFlags supplied to the shell on invocation or by the \fBset\fP
  487. Xor \fBsetopt\fP commands.
  488. X.TP
  489. X.B *
  490. XAn array containing the positional parameters.
  491. X.TP
  492. X.B argv
  493. XSame as \fB*\fP.
  494. X.TP
  495. X.B @
  496. XSame as \fBargv[@]\fP.
  497. X.TP
  498. X.B ?
  499. XThe exit value returned by the last command.
  500. X.TP
  501. X.B status
  502. XSame as \fB?\fP.
  503. X.TP
  504. X.B _
  505. XThe last argument of the previous command.
  506. XAlso, this parameter is set in the environment of every command
  507. Xexecuted to the full pathname of the command.
  508. X.TP
  509. X.B ERRNO
  510. XThe value of errno as set by the most recently failed system call.
  511. XThis value is system dependent and is intended for debugging
  512. Xpurposes.
  513. X.TP
  514. X.B GID
  515. XThe group id of the shell process.
  516. X.TP
  517. X.B HOST
  518. XThe current hostname.
  519. X.TP
  520. X.B HOSTTYPE
  521. XA string corresponding to the type of the host the shell
  522. Xis running on.
  523. X.TP
  524. X.B LINENO
  525. XThe line number of the current line within the current script
  526. Xbeing executed.
  527. X.TP
  528. X.B OLDPWD
  529. XThe previous working directory.
  530. X.TP
  531. X.B OPTARG
  532. XThe value of the last option argument processed by the \fBgetopts\fP
  533. Xcommand.
  534. X.TP
  535. X.B OPTIND
  536. XThe index of the last option argument processed by the \fBgetopts\fP
  537. Xcommand.
  538. X.TP
  539. X.B PPID
  540. XThe process id of the parent of the shell.
  541. X.TP
  542. X.B PWD
  543. XThe present working directory.
  544. X.TP
  545. X.B RANDOM
  546. XA random integer from 0 to 32767, newly generated each time
  547. Xthis parameter is referenced.  The random number generator
  548. Xcan be seeded by assigning a numeric value to \fBRANDOM\fP.
  549. X.TP
  550. X.B SECONDS
  551. XThe number of seconds since shell invocation.  If this parameter
  552. Xis assigned a value, then the value returned upon reference
  553. Xwill be the value that was assigned plus the number of seconds
  554. Xsince the assignment.
  555. X.TP
  556. X.B SHLVL
  557. XIncremented by one each time a new shell is started.
  558. X.TP
  559. X.B signals
  560. XAn array containing the names of the signals.
  561. X.TP
  562. X.B TTY
  563. XThe name of the tty associated with the shell, if any.
  564. X.TP
  565. X.B UID
  566. XThe user id of the shell process.
  567. X.TP
  568. X.B USERNAME
  569. X.TP
  570. X.B LOGNAME
  571. XThe username corresponding to the user id of the shell process.
  572. X.TP
  573. X.B VERSION
  574. XThe version number of this \fBzsh\fP.
  575. X.PD
  576. X.RE
  577. X.PP
  578. XThe following parameters are used by the shell:
  579. X.PP
  580. X.RS
  581. X.PD 0
  582. X.TP
  583. X.B BAUD
  584. XThe baud rate of the current connection.  Used by the line editor
  585. Xupdate mechanism to compensate for a slow terminal by delaying
  586. Xupdates until necessary.  This may be profitably set to a lower value
  587. Xin some circumstances, e.g.
  588. Xfor slow modems dialing into a communications server which is connected
  589. Xto a host via a fast link; in this case, this variable
  590. Xwould be set by default to the speed of the fast link, and not
  591. Xthe modem.
  592. XThis parameter should be set to the baud
  593. Xrate of the slowest part of the link for best performance.
  594. X.TP
  595. X.B bindcmds
  596. XAn write-only array
  597. Xof command names which take line editor function names
  598. Xas arguments, and which therefore should allow binding
  599. Xcompletion.
  600. X.TP
  601. X.B cdpath (CDPATH)
  602. XAn array (colon-separated list)
  603. Xof directories specifying the search path for the \fBcd\fP command.
  604. X.TP
  605. X.B COLUMNS
  606. XThe number of columns for this terminal session.
  607. XUsed for printing select lists and for the line editor.
  608. X.TP
  609. X.B DIRSTACKSIZE
  610. XThe maximum size of the directory stack.  If the 
  611. Xstack gets larger than this, it will be truncated automatically.
  612. XThis is useful with the \fBAUTO_PUSHD\fP option.
  613. X.TP
  614. X.B FCEDIT
  615. XThe default editor for the \fBfc\fP builtin.
  616. X.TP
  617. X.B fignore (FIGNORE)
  618. XAn array (colon separated list)
  619. Xcontaining the suffixes of files to be ignored
  620. Xduring filename completion.
  621. X.TP
  622. X.B fpath (FPATH)
  623. XAn array (colon separated list)
  624. Xof directories specifying the search path for
  625. Xfunction definitions.  This path is searched when a function
  626. Xwith the \-\fBu\fP attribute is referenced.  If an executable
  627. Xfile is found, then it is read and executed in the current environment.
  628. X.TP
  629. X.B HISTCHARS
  630. XThree characters used by the shell's history and lexical analysis
  631. Xmechanism.  The first character signals the start of a history
  632. Xsubstitution (default `!').  The second character signals the
  633. Xstart of a quick history substitution (default `^').  The third
  634. Xcharacter is the comment character (default `#').
  635. X.TP
  636. X.B HISTFILE
  637. XThe file to save the history in when an interactive shell exits.
  638. XIf unset, the history is not saved.
  639. X.TP
  640. X.B HISTSIZE
  641. XThe maximum size of the history list.
  642. X.TP
  643. X.B HOME
  644. XThe default argument for the \fBcd\fP command.
  645. X.TP
  646. X.B hostcmds
  647. XAn write-only array of command names which
  648. Xtake hostnames as arguments, and which should therefore
  649. Xallow hostname completion.  This sort of completion is also
  650. Xused in words containing a \fB@\fP character.
  651. X.TP
  652. X.B hosts (HOSTS)
  653. XAn array (colon separated list) of hostnames to use
  654. Xfor hostname completion.
  655. X.TP
  656. X.B IFS
  657. XInternal field separators, normally space, tab, and newline, that
  658. Xare used to separate words which result from
  659. Xcommand or parameter substitution and words read by
  660. Xthe \fBread\fP builtin.
  661. X.TP
  662. X.B LINES
  663. XThe number of lines for this terminal session.
  664. XUsed for printing select lists and for the line editor.
  665. X.TP
  666. X.B LISTMAX
  667. XIn the line editor,
  668. Xthe number of filenames to list without asking first.
  669. X.TP
  670. X.B LITHISTSIZE
  671. XThe maximum size of the literal history list (before history expansion).
  672. X.TP
  673. X.B LOGCHECK
  674. XThe interval in seconds between checks for login/logout activity
  675. Xusing the \fBwatch\fP parameter.
  676. X.TP
  677. X.B MAIL
  678. XIf this parameter is set and \fBmailpath\fP is not set,
  679. Xthe shell looks for mail in the specified file.
  680. X.TP
  681. X.B MAILCHECK
  682. XThe interval in seconds between checks for new mail. 
  683. X.TP
  684. X.B mailpath (MAILPATH)
  685. XAn array (colon-separated list)
  686. Xof filenames to check for new mail.  Each filename can
  687. Xbe followed by a ? and a message that will be printed.
  688. XThe sequence $_ in the message will be replaced by the name 
  689. Xof the mail file.
  690. XThe default message is "You have new mail."
  691. X.TP
  692. X.B manpath (MANPATH)
  693. XAn array (colon-separated list)
  694. Xwhose value is not used by the shell.  The \fBmanpath\fP
  695. Xarray can be useful, however, since setting it also sets
  696. X\fBMANPATH\fP, and vice versa.
  697. X.TP
  698. X.B NULLCMD
  699. XThe command name to assume if a redirection is specified
  700. Xwith no command.  Defaults to \fBcat\fP.  For sh/ksh-like
  701. Xbehavior, change this to \fB:\fP.  For csh-like
  702. Xbehavior, unset this parameter; the shell will print an
  703. Xerror message if null commands are entered.
  704. X.TP
  705. X.B optcmds
  706. XAn write-only array of
  707. Xcommands which take options as arguments, and which
  708. Xtherefore should allow option completion.
  709. X.TP
  710. X.B path (PATH)
  711. XAn array (colon-separated list)
  712. Xof directories to search for commands.
  713. XWhen this parameter is set, each directory is scanned
  714. Xand all files found are put in a hash table.
  715. X.TP
  716. X.B POSTEDIT
  717. XThis string is output whenever the line editor exits.
  718. XIt usually contains termcap strings to reset the terminal.
  719. X.TP
  720. X.B PROMPT
  721. XThe primary prompt string, printed before a command is read;
  722. Xthe default is "%m%# ".  If the escape sequence takes an optional
  723. Xinteger, it should appear between the '%' and the next character of the
  724. Xsequence.  The following escape sequences are recognized:
  725. X.PD
  726. X.PP
  727. X.PD 0
  728. X.RS
  729. X.TP
  730. X.B %d
  731. X.TP
  732. X.B %/
  733. XPresent working directory ($PWD).
  734. X.TP
  735. X.B %~
  736. X$PWD.
  737. XIf it has a named directory as its prefix, that part is replaced
  738. Xby a ~ followed by the name of the directory.
  739. XIf it starts with $HOME, that part is
  740. Xreplaced by a ~.
  741. X.TP
  742. X.B %c
  743. X.TP
  744. X.B %.
  745. X.TP
  746. X.B %C
  747. XTrailing component of $PWD.
  748. XAn integer may follow the '%' to get more than one component.
  749. XUnless \fB%C\fP is used, tilde expansion is performed first.
  750. X.TP
  751. X.B !
  752. X.TP
  753. X.B %h
  754. X.TP
  755. X.B %!
  756. XCurrent history event number
  757. X.TP
  758. X.B %M
  759. XThe full machine hostname.
  760. X.TP
  761. X.B %m
  762. XThe hostname up to the first '.'.
  763. XAn integer may follow the '%' to specify
  764. Xhow many components of the hostname are desired.
  765. X.TP
  766. X.B %S (%s)
  767. XStart (stop) standout mode.
  768. X.TP
  769. X.B %U (%u)
  770. XStart (stop) underline mode.
  771. X.TP
  772. X.B %B (%b)
  773. XStart (stop) boldface mode.
  774. X.TP
  775. X.B %t
  776. X.TP
  777. X.B %@
  778. XCurrent time of day, in 12-hour, am/pm format.
  779. X.TP
  780. X.B %T
  781. XCurrent time of day, in 24-hour format.
  782. X.TP
  783. X.B %*
  784. XCurrent time of day in 24-hour format, with seconds.
  785. X.TP
  786. X.B %n
  787. X\fB$USERNAME\fP.
  788. X.TP
  789. X.B %w
  790. XThe date in day\-dd format.
  791. X.TP
  792. X.B %W
  793. XThe date in mm/dd/yy format.
  794. X.TP
  795. X.B %D
  796. XThe date in yy\-mm\-dd format.
  797. X.TP
  798. X.B %D{\fIstring\fP}
  799. X\fIstring\fP is formatted using the \fBstrftime\fP function.
  800. XSee \fBstrftime(3)\fP for more details, if your system has it.
  801. X.TP
  802. X.B %l
  803. XThe line (tty) the user is logged in on.
  804. X.TP
  805. X.B %?
  806. XThe return code of the last command executed just before the prompt.
  807. X.TP
  808. X.B %#
  809. XA '#' if the shell is running as root, a '%' if not.
  810. X.TP
  811. X.B %v
  812. XThe value of the first element of the $psvar array parameter.  Following
  813. Xthe '%' with an integer gives that element of the array.
  814. X.TP
  815. X\fB%{\fP...\fB%}\fP
  816. XInclude a string as a literal escape sequence.
  817. XThe string within the braces should not change the cursor
  818. Xposition.
  819. X.RE
  820. X.PD
  821. X.PP
  822. X.PD 0
  823. X.TP
  824. X.B PROMPT2
  825. XThe secondary prompt, printed when the shell needs more information
  826. Xto complete a command.
  827. XRecognizes the same escape sequences as \fB$PROMPT\fP.
  828. XThe default is "> ".
  829. X.TP
  830. X.B PROMPT3
  831. XSelection prompt used within a \fBselect\fP loop.
  832. XRecognizes the same escape sequences as \fB$PROMPT\fP.
  833. XThe default is "?# ".
  834. X.TP
  835. X.B PROMPT4
  836. XThe execution trace prompt.  Default is "+ ".
  837. X.TP
  838. X.B PS1
  839. X.TP
  840. X.B PS2
  841. X.TP
  842. X.B PS3
  843. X.TP
  844. X.B PS4
  845. XSame as \fBPROMPT\fP, \fBPROMPT2\fP, \fBPROMPT3\fP, and \fBPROMPT4\fP,
  846. Xrespectively.
  847. X.TP
  848. X.B psvar (PSVAR)
  849. XAn array (colon-separated list) whose first nine values can be used in
  850. X\fBPROMPT\fP strings.  Setting \fBpsvar\fP also sets \fBPSVAR\fP, and
  851. Xvice versa.
  852. X.TP
  853. X.B prompt
  854. XSame as \fBPROMPT\fP.
  855. X.TP
  856. X.B READNULLCMD
  857. XThe command name to assume if a single input redirection
  858. Xis specified with no command.  Defaults to \fBmore\fP.
  859. X.TP
  860. X.B REPORTTIME
  861. XIf nonzero, commands whose combined user and system execution times
  862. X(measured in seconds) are greater than this value have timing
  863. Xstatistics printed for them.
  864. X.TP
  865. X.B RPROMPT
  866. X.TP
  867. X.B RPS1
  868. XThis prompt is displayed on the right-hand side of the screen
  869. Xwhen the primary prompt is being displayed on the left.
  870. XThis does not work if the \fBSINGLELINEZLE\fP option is set.
  871. XRecognizes the same escape sequences as \fBPROMPT\fP,
  872. Xexcept that termcap sequences like \fB%s\fP, etc. will not work.
  873. X.TP
  874. X.B SAVEHIST
  875. XThe maximum number of history events to save in the history file.
  876. X.TP
  877. X.B SPROMPT
  878. XThe prompt used for spelling correction.  The sequence
  879. X\fB%R\fP expands to the string which presumably needs spelling
  880. Xcorrection, and \fB%r\fP expands to the proposed correction.
  881. XAll other \fBPROMPT\fP escapes are also allowed.
  882. X.TP
  883. X.B STTY
  884. XIf this parameter is set in a command's environment, the shell
  885. Xruns the \fBstty\fP command with the value of this parameter as arguments
  886. Xin order to set up the terminal before executing the command.
  887. X.TP
  888. X.B TIMEFMT
  889. XThe format of process time reports with the \fBtime\fP keyword.
  890. XThe default is "%E real  %U user  %S system  %P".
  891. XRecognizes the following escape sequences:
  892. X.PD
  893. X.PP
  894. X.PD 0
  895. X.RS
  896. X.TP
  897. X.B %U
  898. XCPU seconds spent in user mode.
  899. X.TP
  900. X.B %S
  901. XCPU seconds spent in kernel mode.
  902. X.TP
  903. X.B %E
  904. XElapsed time in seconds.
  905. X.TP
  906. X.B %P
  907. XThe CPU percentage, computed as (%U+%S)/%E.
  908. X.TP
  909. X.B %W
  910. XNumber of times the process was swapped.
  911. X.TP
  912. X.B %X
  913. XThe average amount in (shared) text space used in Kbytes.
  914. X.TP
  915. X.B %D
  916. XThe average amount in (unshared) data/stack space used in Kbytes.
  917. X.TP
  918. X.B %K
  919. XThe total space used (%X+%D) in Kbytes.
  920. X.TP
  921. X.B %M
  922. XThe maximum memory the process had in use at any time in Kbytes.
  923. X.TP
  924. X.B %F
  925. XThe number of major page faults (page needed to be brought from disk).
  926. X.TP
  927. X.B %R
  928. XThe number of minor page faults.
  929. X.TP
  930. X.B %I
  931. XThe number of input operations.
  932. X.TP
  933. X.B %O
  934. XThe number of output operations.
  935. X.TP
  936. X.B %r
  937. XThe number of socket messages received.
  938. X.TP
  939. X.B %s
  940. XThe number of socket messages sent.
  941. X.TP
  942. X.B %k
  943. XThe number of signals received.
  944. X.TP
  945. X.B %w
  946. XNumber of voluntary context switches (waits).
  947. X.TP
  948. X.B %c
  949. XNumber of involuntary context switches.
  950. X.TP
  951. X.B %J
  952. XThe name of this job.
  953. X.RE
  954. X.PD
  955. X.PP
  956. X.PD 0
  957. X.TP
  958. X.B TMOUT
  959. XIf this parameter is nonzero, the shell will terminate if a command is not
  960. Xentered within the specified number of seconds after issuing
  961. Xa prompt.
  962. X.TP
  963. X.B TMPPREFIX
  964. XA pathname prefix which the shell will use for all temporary files.
  965. X.TP
  966. X.B varcmds
  967. XAn write-only array
  968. Xof command names which take parameter names
  969. Xas arguments, and which therefore should allow parameter
  970. Xcompletion.
  971. X.TP
  972. X.B watch (WATCH)
  973. XAn array (colon-separated list) of login/logout events to report.
  974. XIf it contains the single word "all", then all login/logout events
  975. Xare reported.  If it contains the single word "notme", then all
  976. Xevents are reported as with "all" except $USERNAME.
  977. XAn entry in this list may consist of a username,
  978. Xan `@' followed by a remote hostname,
  979. Xand a `%' followed by a line (tty).
  980. XAny or all of these components may be present in an entry;
  981. Xif a login/logout event matches all of them,
  982. Xit is reported.
  983. X.TP
  984. X.B WATCHFMT
  985. XThe format of login/logout reports if the \fBwatch\fP parameter is set.
  986. XDefault is "%n has %a %l from %m."
  987. XRecognizes the following escape sequences:
  988. X.PD
  989. X.PP
  990. X.PD 0
  991. X.RS
  992. X.TP
  993. X.B %n
  994. XThe name of the user that logged in/out.
  995. X.TP
  996. X.B %a
  997. XThe observed action, i.e. "logged on" or "logged off".
  998. X.TP
  999. X.B %l
  1000. XThe line (tty) the user is logged in on.
  1001. X.TP
  1002. X.B %M
  1003. XThe full hostname of the remote host.
  1004. X.TP
  1005. X.B %m
  1006. XThe hostname up to the first ".".  If only the
  1007. Xip address is available or the utmp field contains
  1008. Xthe name of an X-windows display, the whole name is printed.
  1009. X.TP
  1010. X.B %S (%s)
  1011. XStart (stop) standout mode.
  1012. X.TP
  1013. X.B %U (%u)
  1014. XStart (stop) underline mode.
  1015. X.TP
  1016. X.B %B (%b)
  1017. XStart (stop) boldface mode.
  1018. X.TP
  1019. X.B %t
  1020. X.TP
  1021. X.B %@
  1022. XThe time, in 12-hour, am/pm format.
  1023. X.TP
  1024. X.B %T
  1025. XThe time, in 24-hour format.
  1026. X.TP
  1027. X.B %w
  1028. XThe date in day\-dd format.
  1029. X.TP
  1030. X.B %W
  1031. XThe date in mm/dd/yy format.
  1032. X.TP
  1033. X.B %D
  1034. XThe date in yy\-mm\-dd format.
  1035. X.RE
  1036. X.PD
  1037. X.PP
  1038. X.PD 0
  1039. X.TP
  1040. X.B WORDCHARS
  1041. XA list of nonalphanumeric characters considered part of a word
  1042. Xby the line editor.
  1043. X.TP
  1044. X.B ZDOTDIR
  1045. XThe directory to search for shell startup files (.zshrc, etc),
  1046. Xif not \fB$HOME\fP.
  1047. X.PD
  1048. X.RE
  1049. X.PP
  1050. X.SH OPTIONS
  1051. XThe following options may be set upon invocation of the shell,
  1052. Xor with the \fBset\fP or \fBsetopt\fP builtins:
  1053. X.RS
  1054. X.PD 0
  1055. X.TP
  1056. X\fBALLEXPORT\fP (\-\fBa\fP)
  1057. XAll parameters subsequently defined are automatically exported.
  1058. X.TP
  1059. X\fBAPPEND_HISTORY\fP
  1060. XIf this is set, zsh sessions will append their history list to
  1061. Xthe history file, rather than overwrite it. Thus, multiple parallel
  1062. Xzsh sessions will all have their history lists added to the
  1063. Xhistory file, in the order they are killed.
  1064. X.TP
  1065. X\fBAUTO_CD\fP (\-\fBJ\fP)
  1066. XIf a command is not in the hash table, and there exists an
  1067. Xexecutable directory by that name, perform the \fBcd\fP
  1068. Xcommand to that directory.
  1069. X.TP
  1070. X\fBAUTOLIST\fP (\-\fB9\fP)
  1071. XAutomatically list choices on an ambiguous completion.
  1072. X.TP
  1073. X\fBAUTOMENU\fP
  1074. XAutomatically use menu completion if the \fPTAB\fP
  1075. Xkey is pressed repeatedly.
  1076. X.TP
  1077. X\fBAUTO_PUSHD\fP (\-\fBN\fP)
  1078. XMake \fBcd\fP act like \fBpushd\fP.
  1079. X.TP
  1080. X\fBAUTO_REMOVE_SLASH\fP
  1081. XWhen the last character resulting from a completion is a slash and the next
  1082. Xcharacter typed is a word delimiter, remove the slash.
  1083. X.TP
  1084. X\fBAUTO_RESUME\fP (\-\fBW\fP)
  1085. XTreat single word simple commands without redirection
  1086. Xas candidates for resumption of an existing job.
  1087. X.TP
  1088. X\fBBGNICE\fP (\-\fB6\fP)
  1089. XRun all background jobs at a lower priority.  This option
  1090. Xis set by default.
  1091. X.TP
  1092. X\fBBRACECCL\fP
  1093. XAllow brace expansions of the form \fB{a-zA-Z}\fP, etc.
  1094. X.TP
  1095. X\fBCDABLEVARS\fP (\-\fBT\fP)
  1096. XIf the argument to a \fBcd\fP command is not a directory,
  1097. Xbut a parameter exists by the same name whose value
  1098. Xbegins with a /, try to change to the directory
  1099. Xspecified by the parameter's value.
  1100. X.TP
  1101. X\fBCHASELINKS\fP (\-\fBw\fP)
  1102. XResolve symbolic links to their true values.
  1103. X.TP
  1104. X\fBCORRECT\fP (\-\fB0\fP)
  1105. XTry to correct the spelling of commands.
  1106. X.TP
  1107. X\fBCORRECT_ALL\fP (\-\fBO\fP)
  1108. XTry to correct the spelling of all arguments in a line.
  1109. X.TP
  1110. X\fBCSH_JUNKIE_LOOPS\fP
  1111. XAllow loop bodies to take the form
  1112. X"\fIlist\fP; \fBend\fP" instead of
  1113. X"\fBdo\fP \fIlist\fP; \fBdone\fP".
  1114. X.TP
  1115. X\fBCSH_JUNKIE_QUOTES\fP
  1116. XComplain if a quoted expression runs off the end of a line;
  1117. Xprevent quoted expressions from containing unescaped newlines.
  1118. X.TP
  1119. X\fBCSH_NULL_GLOB\fP
  1120. XIf a pattern for filename generation has no matches,
  1121. Xdelete the pattern from the argument list;
  1122. Xdo not report an error unless all the patterns
  1123. Xin a command have no matches.
  1124. XOverrides \fBNULLGLOB\fP.
  1125. X.TP
  1126. X\fBERREXIT\fP (\-\fBe\fP)
  1127. XIf a command has a non-zero exit status, execute the \fBERR\fP
  1128. Xtrap, if set, and exit.
  1129. X.TP
  1130. X\fBEXTENDED_GLOB\fP
  1131. XTreat the # and ^ characters as part of patterns for filename
  1132. Xgeneration, etc.
  1133. X.TP
  1134. X\fBEXTENDED_HISTORY\fP
  1135. XSave beginning and ending timestamps to the history file.
  1136. XThe format of these timestamps is
  1137. X\fI:<beginning time>:<ending time>:<command>.\fP
  1138. X.TP
  1139. X\fBGLOB_COMPLETE\fP
  1140. XLike \fBMENU_COMPLETE\fP, except that the current word
  1141. Xis expanded using normal shell expansion instead of completion.
  1142. XIf no matches are found, a * is added to the end of the word, and expansion
  1143. Xis attempted again.
  1144. X.TP
  1145. X\fBGLOB_DOTS\fP (\-\fB4\fP)
  1146. XDo not require a leading . in a filename to be matched explicitly.
  1147. X.TP
  1148. X\fBHASH_CMDS\fP
  1149. XPlace the location of each command in the hash table the first
  1150. Xtime it is executed.  If this option is unset, no path hashing
  1151. Xwill be done at all.
  1152. X.TP
  1153. X\fBHASH_DIRS\fP
  1154. XWhenever a command is executed, hash the directory containing it,
  1155. Xas well as all directories that occur earlier in the path.
  1156. XHas no effect if \fBHASH_CMDS\fP is unset.
  1157. X.TP
  1158. X\fBHASH_LIST_ALL\fP
  1159. XWhenever a command completion is attempted, make sure the entire
  1160. Xcommand path is hashed first.  This makes the first completion slower.
  1161. X.TP
  1162. X\fBHIST_IGNORE_DUPS\fP (\-\fBh\fP)
  1163. XDo not enter command lines into the history list
  1164. Xif they are duplicates of the previous event.
  1165. X.TP
  1166. X\fBHIST_IGNORE_SPACE\fP (\-\fBg\fP)
  1167. XDo not enter command lines into the history list
  1168. Xif they begin with a blank.
  1169. X.TP
  1170. X\fBHISTLIT\fP (\-\fBj\fP)
  1171. XUse literal (unparsed) versions of the history lines
  1172. Xin the editor.
  1173. X.TP
  1174. X\fBHIST_NO_STORE\fP
  1175. XRemove the \fBhistory\fP (\fBfc\fP \-\fBl\fP) command from
  1176. Xthe history when invoked.
  1177. X.TP
  1178. X\fBHIST_VERIFY\fP
  1179. XWhenever the user enters a line with history substitution,
  1180. Xdon't execute the line directly; instead, perform
  1181. Xhistory substitution and reload the line into the editing buffer.
  1182. X.TP
  1183. X\fBIGNORE_BRACES\fP (\-\fBI\fP)
  1184. XDo not perform brace expansion.
  1185. X.TP
  1186. X\fBIGNOREEOF\fP (\-\fB7\fP)
  1187. XDo not exit on end-of-file.  Require the use
  1188. Xof \fBexit\fP or \fBlogout\fP instead.
  1189. X.TP
  1190. X\fBINTERACTIVE\fP (\-\fBi\fP)
  1191. XThis is an interactive shell.
  1192. X.TP
  1193. X\fBINTERACTIVE_COMMENTS\fP (\-\fBk\fP)
  1194. XAllow comments even in interactive shells.
  1195. X.TP
  1196. X\fBKSH_OPTION_PRINT\fP
  1197. XAlters the way options settings are printed.
  1198. X.TP
  1199. X\fBLIST_TYPES\fP (\-\fBX\fP)
  1200. XWhen listing files that are possible completions, show the
  1201. Xtype of each file with a trailing identifying mark.
  1202. X.TP
  1203. X\fBLOGIN\fP (\-\fBl\fP)
  1204. XThis is a login shell.
  1205. X.TP
  1206. X\fBLONG_LIST_JOBS\fP (\-\fBR\fP)
  1207. XList jobs in the long format by default.
  1208. X.TP
  1209. X\fBMAIL_WARNING\fP (\-\fBU\fP)
  1210. XPrint a warning message if a mail file has been
  1211. Xaccessed since the shell last checked.
  1212. X.TP
  1213. X\fBMARKDIRS\fP (\-\fB8\fP)
  1214. XAppend a trailing / to all directory
  1215. Xnames resulting from filename generation (globbing).
  1216. X.TP
  1217. X\fBMENU_COMPLETE\fP (\-\fBY\fP)
  1218. XOn an ambiguous completion, instead of listing possibilities,
  1219. Xinsert the first match.  Then when completion is requested
  1220. Xagain, remove the first match and insert the second match, etc.
  1221. XWhen there are no more matches, go back to the first one again.
  1222. X\fBreverse-menu-complete\fP may be used to loop through the list
  1223. Xin the other direction.
  1224. X.TP
  1225. X\fBMENU_COMPLETE_BEEP\fP
  1226. XBeep on an ambiguous menu completion.
  1227. X.TP
  1228. X\fBMONITOR\fP (\-\fBm\fP)
  1229. XAllow job control.  Set by default in interactive shells.
  1230. X.TP
  1231. X\fBNO_BAD_PATTERN\fP (\-\fB2\fP)
  1232. XIf a pattern for filename generation is badly formed,
  1233. Xleave it unchanged in the argument list instead of
  1234. Xprinting an error.
  1235. X.TP
  1236. X\fBNO_BANG_HIST\fP (\-\fBK\fP)
  1237. XDo not perform textual history substitution.  Do not
  1238. Xtreat the ! character specially.
  1239. X.TP
  1240. X\fBNOBEEP\fP (\-\fBB\fP)
  1241. XDo not beep.
  1242. X.TP
  1243. X\fBNO_CLOBBER\fP (\-\fB1\fP)
  1244. XPrevents \fB>\fP redirection from truncating existing files.
  1245. X\fB>!\fP may be used to truncate a file instead.
  1246. XAlso prevents \fB>>\fP from creating files.
  1247. X\fB>>!\fP may be used instead.
  1248. X.TP
  1249. X\fBNO_EQUALS\fP
  1250. XDon't perform \fB=\fP filename substitution.
  1251. X.TP
  1252. X\fBNOEXEC\fP (\-\fBn\fP)
  1253. XRead commands and check them for syntax errors, but do not execute them.
  1254. X.TP
  1255. X\fBNOGLOB\fP (\-\fBF\fP)
  1256. XDisable filename generation.
  1257. X.TP
  1258. X\fBNO_HIST_BEEP\fP
  1259. XDon't beep when an attempt is made to access a history entry which
  1260. Xisn't there.
  1261. X.TP
  1262. X\fBNOHUP\fP
  1263. XDon't send the \fBHUP\fP signal to running jobs when the
  1264. Xshell exits.
  1265. X.TP
  1266. X\fBNO_LIST_BEEP\fP
  1267. XDon't beep on an ambiguous completion.
  1268. X.TP
  1269. X\fBNO_NOMATCH\fP (\-\fB3\fP)
  1270. XIf a pattern for filename generation has no matches,
  1271. Xleave it unchanged in the argument list instead of
  1272. Xprinting an error.
  1273. X.TP
  1274. X\fBNO_PROMPT_CR\fP (\-\fBV\fP)
  1275. XDon't print a carriage return just before printing
  1276. Xa prompt in the line editor.
  1277. X.TP
  1278. X\fBNO_RCS\fP (\-\fBf\fP)
  1279. XSource only the /etc/zshenv file.
  1280. XDo not source the .zshenv, /etc/zprofile, .zprofile,
  1281. X/etc/zshrc, .zshrc, /etc/zlogin, .zlogin, or .zlogout files.
  1282. X.TP
  1283. X\fBNO_SHORT_LOOPS\fP
  1284. XDisallow the short forms of \fBfor\fP, \fBselect\fP,
  1285. X\fBif\fP, and \fBfunction\fP constructs.
  1286. X.TP
  1287. X\fBNOTIFY\fP (\-\fB5\fP)
  1288. XReport the status of background jobs immediately, rather than
  1289. Xwaiting until just before printing a prompt.
  1290. X.TP
  1291. X\fBNOUNSET\fP (\-\fBu\fP)
  1292. XTreat unset parameters as an error when substituting.
  1293. X.TP
  1294. X\fBNULLGLOB\fP (\-\fBG\fP)
  1295. XIf a pattern for filename generation has no matches,
  1296. Xdelete the pattern from the argument list instead
  1297. Xof reporting an error.  Overrides \fBNO_NOMATCH\fP.
  1298. X.TP
  1299. X\fBNUMERICGLOBSORT\fP
  1300. XIf numeric filenames are matched by a filename generation pattern,
  1301. Xsort the filenames numerically rather than lexicographically.
  1302. X.TP
  1303. X\fBOVERSTRIKE\fP
  1304. XStart up the line editor in overstrike mode.
  1305. X.TP
  1306. X\fBPATH_DIRS\fP (\-\fBQ\fP)
  1307. XPerform a path search even on command names with slashes in them.
  1308. XThus if "/usr/local/bin" is in the user's path, and he types
  1309. X"X11/xinit", the command "/usr/local/bin/X11/xinit" will be executed
  1310. X(assuming it exists).
  1311. X.TP
  1312. X\fBPRINT_EXIT_VALUE\fP (\-\fBC\fP)
  1313. XPrint the exit value of programs with non-zero exit status.
  1314. X.TP
  1315. X\fBPUSHD_IGNORE_DUPS\fP
  1316. XDon't push multiple copies of the same directory onto the directory stack.
  1317. X.TP
  1318. X\fBPUSHD_MINUS\fP
  1319. XSee \fBpopd\fP below.
  1320. X.TP
  1321. X\fBPUSHD_SILENT\fP (\-\fBE\fP)
  1322. XDo not print the directory stack after \fBpushd\fP
  1323. Xor \fBpopd\fP.
  1324. X.TP
  1325. X\fBPUSHD_TO_HOME\fP (\-\fBD\fP)
  1326. XHave \fBpushd\fP with no arguments act like
  1327. X\fBpushd\fP $HOME.
  1328. X.TP
  1329. X\fBRC_EXPAND_PARAM\fP (\-\fBP\fP)
  1330. XSee \fIParameter Expansion\fP.
  1331. X.TP
  1332. X\fBRC_QUOTES\fP
  1333. XAllow the character sequence \fB''\fP to signify a single quote
  1334. Xwithin singly quoted strings.
  1335. X.TP
  1336. X\fBRECEXACT\fP (\-\fBS\fP)
  1337. XIn completion, recognize exact matches even
  1338. Xif they are ambiguous.
  1339. X.TP
  1340. X\fBRMSTARSILENT\fP (\-\fBH\fP)
  1341. XDo not query the user before executing "rm *" or "rm path/*".
  1342. X.TP
  1343. X\fBSHINSTDIN\fP (\-\fBs\fP)
  1344. XRead commands from the standard input.
  1345. X.TP
  1346. X\fBSH_WORD_SPLIT\fP (\-\fBy\fP)
  1347. XSee \fIParameter Expansion\fP.
  1348. X.TP
  1349. X\fBSINGLE_LINE_ZLE\fP (\-\fBM\fP)
  1350. XUse single-line command line editing instead of multi-line.
  1351. X.TP
  1352. X\fBSUN_KEYBOARD_HACK\fP (\-\fBL\fP)
  1353. XIf a line ends with a backquote, and there are an odd number
  1354. Xof backquotes on the line, ignore the trailing backquote.
  1355. XThis is useful on some keyboards where the return key is
  1356. Xtoo small, and the backquote key lies annoyingly close to it.
  1357. X.TP
  1358. X\fBVERBOSE\fP (\-\fBv\fP)
  1359. XPrint shell input lines as they are read.
  1360. X.TP
  1361. X\fBXTRACE\fP (\-\fBx\fP)
  1362. XPrint commands and their arguments as they are executed.
  1363. X.TP
  1364. X\fBZLE\fP (\-\fBZ\fP)
  1365. XUse the zsh line editor.
  1366. X.RE
  1367. X.PD
  1368. X.SH "SHELL BUILTIN COMMANDS"
  1369. X.TP
  1370. X\fB\&.\fP \fIfile\fP [ \fIarg\fP ... ]
  1371. XRead and execute commands from \fIfile\fP in the current shell
  1372. Xenvironment.
  1373. XIf \fIfile\fP does not contain a slash, the shell
  1374. Xlooks in the components of \fBpath\fP to find the directory
  1375. Xcontaining \fIfile\fP.
  1376. XIf any arguments \fIarg\fP are given,
  1377. Xthey become the positional parameters; the old positional
  1378. Xparameters are restored when the \fIfile\fP is done executing.
  1379. XThe exit status is the exit status of the last command executed.
  1380. X.TP
  1381. X\fB:\fP [ \fIarg\fP ... ]
  1382. XThis command only expands parameters.  A zero exit code is returned.
  1383. X.TP
  1384. X\fBalias\fP [ \-\fBg\fP ] [ \fIname\fP[=\fIvalue\fP] ] ...
  1385. XWith no arguments, print the list of aliases in the form
  1386. X\fIname\fP=\fBvalue\fP on the standard output.
  1387. XFor each \fIname\fP with a corresponding \fIvalue\fP, define an alias 
  1388. Xwith that value.
  1389. XA trailing space in \fIvalue\fP causes the next
  1390. Xword to be checked for alias substitution.
  1391. XIf the \-\fBg\fP flag is present, define a global alias; global aliases
  1392. Xare expanded even if they do not occur in command position.
  1393. XFor each \fIname\fP with no \fIvalue\fP, print the value of \fIname\fP,
  1394. Xif any.
  1395. XThe exit status is nonzero if a \fIname\fP (with no \fIvalue\fP)
  1396. Xgiven for which no alias has been defined.
  1397. X.TP
  1398. X\fBautoload\fP [ \fIname\fP ... ]
  1399. XFor each of the \fIname\fPs (which are names of functions),
  1400. Xcreate a function marked undefined.
  1401. XThe \fBfpath\fP variable will be searched to find the
  1402. Xactual function definition when the function is first referenced.
  1403. X.TP
  1404. X.PD 0
  1405. X\fBbg\fP [ \fIjob\fP ... ]
  1406. X.TP
  1407. X\fIjob\fP ... \fB&\fP
  1408. X.PD
  1409. XPut each specified \fIjob\fP in the background,
  1410. Xor the current job if none is specified.
  1411. X.TP
  1412. X.PD 0
  1413. X\fBbindkey\fP \-\fBmevd
  1414. X.TP
  1415. X\fBbindkey\fP \-\fBr\fP \fIin-string\fP ...
  1416. X.TP
  1417. X\fBbindkey\fP [ \-\fBa\fP ] \fIin-string\fP [ \fIcommand\fP ] ...
  1418. X.TP
  1419. X\fBbindkey\fP \-\fBs\fP [ \-\fBa\fP ] \fIin-string\fP \fIout-string\fP ...
  1420. X.PD
  1421. XIf one of the \-\fBe\fP, \-\fBv\fP, or \-\fBd\fP options is given,
  1422. Xreset the keymaps for emacs mode, vi mode, or the default mode,
  1423. Xrespectively; if the \-\fBm\fP option is also given,
  1424. Xallow the use of a meta key.
  1425. XIf the \-\fBr\fP option is given, remove any binding for each \fIin-string\fP.
  1426. XIf the \-\fBs\fP option is not specified, bind each \fIin-string\fP
  1427. Xto a specified \fIcommand\fP.  If no \fIcommand\fP is specified,
  1428. Xprint the binding of \fIin-string\fP if it is bound, or return
  1429. Xa nonzero exit code if it is not bound.
  1430. XIf the \-\fBs\fP option is specified, bind each \fIin-string\fP
  1431. Xto each specified \fIout-string\fP.  When \fIin-string\fP is typed,
  1432. X\fIout-string\fP will be pushed back and treated as input to the
  1433. Xline editor.
  1434. XIf the \-\fBa\fP option is specified, bind the \fIin-string\fPs in the
  1435. Xalternative keymap instead of the standard one.  The alternative
  1436. Xkeymap is used in vi command mode.
  1437. X.RS
  1438. X.PP
  1439. XFor either \fIin-string\fP or \fIout-string\fP, control characters
  1440. Xmay be specified in the form \fB^X\fP, and the backslash may
  1441. Xbe used to introduce one of the following escape sequences:
  1442. X.RS
  1443. X.PD 0
  1444. X.TP
  1445. X.B \ea
  1446. Xbell character
  1447. X.TP
  1448. X.B \en
  1449. Xlinefeed (newline)
  1450. X.TP
  1451. X.B \eb
  1452. Xbackspace
  1453. X.TP
  1454. X.B \et
  1455. Xhorizontal tab
  1456. X.TP
  1457. X.B \ev
  1458. Xvertical tab
  1459. X.TP
  1460. X.B \ef
  1461. Xform feed
  1462. X.TP
  1463. X.B \er
  1464. Xcarriage return
  1465. X.TP
  1466. X.B \ee
  1467. Xescape
  1468. X.TP
  1469. X.B \ennn
  1470. Xcharacter code in octal
  1471. X.TP
  1472. X.B \eM\-xxx
  1473. Xcharacter or escape sequence with meta bit set
  1474. X.PD
  1475. X.PP
  1476. X.RE
  1477. XIn all other cases, \e escapes the following character.  Delete is
  1478. Xwritten as `\fB^?\fP'.
  1479. X.RE
  1480. X.TP
  1481. X\fBbreak\fP [ \fIn\fP ]
  1482. XExit from an enclosing \fBfor\fP, \fBwhile\fP,
  1483. X\fBuntil\fP, \fBselect\fP, or \fBrepeat\fP loop.  If \fIn\fP
  1484. Xis specified, then break \fIn\fP levels instead of just one.
  1485. X.TP
  1486. X\fBbuiltin\fP \fIname\fP [ \fIargs\fP ] ...
  1487. XExecutes the builtin \fIname\fP, with the given \fIargs\fP.
  1488. X.TP
  1489. X\fBbye\fP
  1490. XSame as \fBexit\fP.
  1491. X.TP
  1492. X.PD 0
  1493. X\fBcd\fP [ \fIarg\fP ]
  1494. X.TP
  1495. X\fBcd\fP \fIold\fP \fInew\fP
  1496. X.TP
  1497. X\fBcd\fP \(+-\fBn\fP
  1498. X.PD
  1499. XChange the current directory.  In the first form, change the
  1500. Xcurrent directory to \fIarg\fP, or to the value of \fBHOME\fP if
  1501. X\fIarg\fP is not specified.  If \fIarg\fP is \-, change to the
  1502. Xvalue of \fBOLDPWD\fP, the previous directory.
  1503. XIf a directory named \fIarg\fP is not found in the current directory
  1504. Xand \fIarg\fP does not begin with a slash,
  1505. Xsearch each component of the shell parameter \fBcdpath\fP.
  1506. XIf the option \fBCDABLEVARS\fP is set, and a parameter named \fIarg\fP
  1507. Xexists whose value begins with a slash, treat its value as
  1508. Xthe directory.
  1509. X.RS
  1510. X.PP
  1511. XThe second form of \fBcd\fP substitutes the string \fInew\fP
  1512. Xfor the string \fIold\fP in the name of the current directory,
  1513. Xand tries to change to this new directory.
  1514. X.PP
  1515. XThe third form of \fBcd\fP is equivalent to \fBpopd\fP.
  1516. X.RE
  1517. X.TP
  1518. X\fBchdir\fP
  1519. XSame as \fBcd\fP.
  1520. X.TP
  1521. X\fBcompctl\fP [ \-\fBcfhovbCD\fP ] [ \-\fBk\fP \fIname\fP ] [ \fIarg\fP ... ]
  1522. XControl the editor's completion behavior when one of \fIarg\fP is the current
  1523. Xcommand.  With the \-\fBD\fP flag, control default completion behavior
  1524. Xfor commands not assigned any special behavior; with \-\fBC\fP, control
  1525. Xcompletion when there is no current command.  The remaining options
  1526. Xspecify the type of command arguments to look for during completion.
  1527. XFor example, \fBcompctl\fP \-\fBh\fP \fBrlogin\fP is equivalent
  1528. Xto \fBhostcmds=(rlogin)\fP.
  1529. X.RS
  1530. X.PD 0
  1531. X.TP
  1532. X\-\fBc\fP
  1533. XExpect command names.
  1534. X.TP
  1535. X\-\fBf\fP
  1536. XExpect filenames, named directories and filesystem paths.
  1537. X.TP
  1538. X\-\fBh\fP
  1539. XExpect hostnames taken from the \fB$hosts\fP variable.
  1540. X.TP
  1541. X\-\fBo\fP
  1542. XExpect option names.
  1543. X.TP
  1544. X\-\fBv\fP
  1545. XExpect variable names.
  1546. X.TP
  1547. X\-\fBb\fP
  1548. XExpect key binding names.
  1549. X.TP
  1550. X\-\fBk\fP \fIname\fP
  1551. XExpect names taken from the elements of \fB$name\fP.
  1552. X.PD
  1553. X.RE
  1554. X.TP
  1555. X\fBcontinue\fP [ \fInum\fP ]
  1556. XResume the next iteration of the enclosing
  1557. X\fBfor\fP, \fBwhile\fP, \fBuntil\fP, \fBselect\fP, or
  1558. X\fBrepeat\fP loop.  If \fIn\fP is specified, break out of
  1559. X\fIn\fP \- 1 loops and resume at the \fIn\fPth enclosing loop.
  1560. X.TP
  1561. X\fBdeclare\fP [ \fIarg\fP ... ]
  1562. XSame as \fBtypeset\fP.
  1563. X.TP
  1564. X\fBdirs\fP [ \-\fBv\fP ] [ \fIarg\fP ... ]
  1565. XWith no arguments, print the contents of the directory stack.
  1566. XIf the \-\fBv\fP option is given, number the directories
  1567. Xin the stack when printing.
  1568. XDirectories are added to this stack with the \fBpushd\fP command,
  1569. Xand removed with the \fBcd\fP or \fBpopd\fP commands.
  1570. XIf arguments are specified, load them onto the directory stack,
  1571. Xreplacing anything that was there, and push the current directory
  1572. Xonto the stack.
  1573. X.TP
  1574. X\fBdisable\fP \fIarg\fP ...
  1575. XDisable the builtin \fIarg\fP temporarily.  This allows you to use
  1576. Xan external command with the same name as a shell builtin.
  1577. XActually the same as \fBunhash\fP.
  1578. XBuiltins can be enabled with the \fBenable\fP command.
  1579. X.TP
  1580. X\fBdisown\fP \fIjob\fP ...
  1581. XRemove the specified jobs from the job table; the shell will
  1582. Xno longer report their status, and will not complain if you
  1583. Xtry to exit an interactive shell with them running or stopped.
  1584. X.TP
  1585. X\fBecho\fP [ \-\fBn\fP ] [ \fIarg\fP ... ]
  1586. XWrite each \fIarg\fP on the standard output, with a space separating
  1587. Xeach one.
  1588. XIf the \-\fBn\fP flag is not present, print a newline at the end.
  1589. X\fBecho\fP recognizes the following escape sequences:
  1590. X.RS
  1591. X.PD 0
  1592. X.TP
  1593. X.B \eb
  1594. Xbackspace
  1595. X.TP
  1596. X.B \ec
  1597. Xdon't print an ending newline
  1598. X.TP
  1599. X.B \ee
  1600. Xescape
  1601. X.TP
  1602. X.B \ef
  1603. Xform feed
  1604. X.TP
  1605. X.B \en
  1606. Xnewline
  1607. X.TP
  1608. X.B \er
  1609. Xcarriage return
  1610. X.TP
  1611. X.B \et
  1612. Xhorizontal tab
  1613. X.TP
  1614. X.B \ev
  1615. Xvertical tab
  1616. X.TP
  1617. X.B \e\e
  1618. Xbackslash
  1619. X.TP
  1620. X.B \exxx
  1621. Xcharacter code in octal
  1622. X.PD
  1623. X.RE
  1624. X.TP
  1625. X\fBechotc\fP \fIcap\fP [ \fIarg\fP ... ]
  1626. XOutput the termcap string corresponding to the capability
  1627. X\fIcap\fP, with optional arguments.
  1628. X.TP
  1629. X\fBenable\fP \fIarg\fP ...
  1630. XEnable the specified builtin commands, presumably disabled earlier
  1631. Xwith \fBdisable\fP.
  1632. X.TP
  1633. X\fBeval\fP [ \fIarg\fP ... ]
  1634. XRead the arguments as input to the shell and execute the resulting
  1635. Xcommand(s) in the current shell process.
  1636. X.TP
  1637. X\fBexit\fP [ \fIn\fP ]
  1638. XExit the shell with the exit code specified by \fIn\fP; if none
  1639. Xis specified, use the exit code from the last command executed.
  1640. XAn EOF condition will also cause the shell to exit, unless
  1641. Xthe \fBIGNOREEOF\fP option is set.
  1642. X.TP
  1643. X\fBexport\fP [ \fIname\fP[=\fIvalue\fP] ... ]
  1644. XThe specified \fIname\fPs are marked for automatic export
  1645. Xto the environment of subsequently executed commands.
  1646. X.TP
  1647. X\fBfalse\fP
  1648. XDo nothing and return an exit code of 1.
  1649. X.TP
  1650. X.PD 0
  1651. X\fBfc\fP [ \-\fBe\fP \fIename\fP ] [ \-\fBnlrdDfE\fP ] [ \fIold\fP=\fInew\fP ... ] [ \fIfirst\fP [ \fIlast\fP ] ]
  1652. X.TP
  1653. X\fBfc\fP \-\fBARWI\fP [ \fIfilename\fP ]
  1654. X.PD
  1655. XSelect a range of commands from \fIfirst\fP to \fIlast\fP from the
  1656. Xhistory list.
  1657. XThe arguments \fIfirst\fP and \fIlast\fP may be specified as a
  1658. Xnumber or as a string.  A negative number is used as an offset
  1659. Xto the current history event number.
  1660. XA string specifies the most recent event
  1661. Xbeginning with the given string.
  1662. XAll substitutions \fIold\fP=\fInew\fP, if any, are then performed
  1663. Xon the commands.
  1664. XIf the \-\fBl\fP flag is given, the resulting commands are listed on
  1665. Xstandard output.
  1666. XOtherwise the editor program \fIename\fP is invoked on a file containing
  1667. Xthese history events.  If \fIename\fP is not given, the value
  1668. Xof the parameter \fBFCEDIT\fP is used.  If \fIename\fP is "\-",
  1669. Xno editor is invoked.  When editing is complete, the edited
  1670. Xcommand(s) is executed.  
  1671. XIf \fIfirst\fP is not specified, it will be set to \-1 (the most recent
  1672. Xevent), or to -16 if the \-\fBl\fP flag is given.
  1673. XIf \fIlast\fP is not specified, it will be set to \fIfirst\fP,
  1674. Xor to \-1 if the \-\fBl\fP flag is given.
  1675. XThe flag \-\fBr\fP reverses the order of the commands and the
  1676. Xflag \-\fBn\fP suppresses command numbers when listing.
  1677. XAlso when listing, \-\fBd\fP prints timestamps for each command, and
  1678. X\-\fBf\fP prints full time-date stamps. Adding the \-\fBE\fP flag
  1679. Xcauses the dates to be printed as `dd.mm.yyyy'.
  1680. XWith the \-\fBD\fP flag, \fBfc\fP prints elapsed times.
  1681. X.RS
  1682. X.PP
  1683. X\fBfc\fP \-\fBR\fP reads the history from the given file,
  1684. X\fBfc\fP \-\fBW\fP writes the history out to the given file,
  1685. Xand \fBfc\fP \-\fBA\fP appends the history out to the given file.
  1686. X\fBfc\fP \-\fBAI\fP ( \-\fBWI\fP ) appends ( writes ) only those
  1687. Xevents that are new since last incremental append ( write ) to
  1688. Xthe history file.
  1689. X.RE
  1690. X.TP
  1691. X.PD 0
  1692. X\fBfg\fP [ \fIjob\fP ... ]
  1693. X.TP
  1694. X\fIjob\fP ...
  1695. X.PD
  1696. XBring the specified \fIjob\fPs to the foreground.
  1697. XIf no \fIjob\fP is specified, use the current job.
  1698. X.TP
  1699. X\fBfunctions\fP [ \(+-\fBtu\fP ] [ \fIname\fP ... ]
  1700. XEquivalent to \fBtypeset\fP \-\fBf\fP.
  1701. X.TP
  1702. X\fBgetln\fP \fIname\fP ...
  1703. XRead the top value from the buffer stack and put it in
  1704. Xthe shell parameter \fIname\fP.  Equivalent to
  1705. X\fBread\fP \-\fBzr\fP.
  1706. X.TP
  1707. X\fBgetopts\fP \fIoptstring\fP \fIname\fP [ \fIarg\fP ... ]
  1708. XChecks \fBarg\fP for legal options.  If \fIarg\fP is omitted,
  1709. Xuse the positional parameters.  A valid option argument
  1710. Xbegins with a + or a \-.  An argument not beginning with
  1711. Xa + or a \-, or the argument \-\-, ends the options.
  1712. X\fIoptstring\fP contains the letters that \fBgetopts\fP
  1713. Xrecognizes.  If a letter is followed by a `:', that option
  1714. Xis expected to have an argument.  The options can be
  1715. Xseparated from the argument by blanks.
  1716. X.RS
  1717. X.PP
  1718. XEach time it is invoked, \fBgetopts\fP places the option letter it finds
  1719. Xin the shell parameter \fIname\fP, prepended with a + when
  1720. X\fIarg\fP begins with a +.  The index of the next \fIarg\fP
  1721. Xis stored in \fBOPTIND\fP.  The option argument, if any,
  1722. Xis stored in \fBOPTARG\fP.
  1723. X.PP
  1724. XA leading : in \fIoptstring\fP causes \fBgetopts\fP to store the
  1725. Xletter of the invalid option in \fBOPTARG\fP, and to set \fIname\fP
  1726. Xto `?' for an unknown option and to `:' when a required option
  1727. Xis missing.  Otherwise, \fBgetopts\fP prints an error
  1728. Xmessage.  The exit status is nonzero when there are no more options.
  1729. X.RE
  1730. X.TP
  1731. X\fBhash\fP \fIname\fP \fIpath\fP
  1732. XPuts \fIname\fP in the command hash table, associating it with
  1733. Xthe pathname \fIpath\fP.  Whenever \fIname\fP is used as a command
  1734. Xargument, the shell will try to execute the file given by \fIpath\fP.
  1735. X.TP
  1736. X\fBhistory\fP [ \-\fBnr\fP ] [ \fIfirst\fP [ \fIlast\fP ] ]
  1737. XSame as \fBfc\fP \-\fBl\fP.
  1738. X.TP
  1739. X\fBinteger\fP
  1740. XSame as \fBtypeset\fP \-\fBi\fP.
  1741. X.TP
  1742. X\fBjobs\fP [ \-\fBlp\fP ] [ \fIjob\fP ... ]
  1743. XLists information about each given job, or all jobs
  1744. Xif \fIjob\fP is omitted.  The \-\fBl\fP flag lists process
  1745. Xids, and the \-\fBp\fP flag lists process groups.
  1746. X.TP
  1747. X.PD 0
  1748. X\fBkill\fP [ \-\fIsig\fP ] \fIjob\fP ...
  1749. X.TP
  1750. X\fBkill\fP \-\fBl\fP
  1751. X.PD
  1752. XSends either SIGTERM or the specified signal to the given
  1753. Xjobs or processes.
  1754. XSignals are given by number or by names
  1755. X(with the prefix "SIG" removed).
  1756. XIf the signal being sent is not KILL or CONT, then the job
  1757. Xwill be sent a CONT signal if it is stopped.
  1758. XThe argument \fIjob\fP can be the process id of a job
  1759. Xnot in the job list.
  1760. XIn the second form, \fBkill\fP \-\fBl\fP, the signal names
  1761. Xare listed.
  1762. X.TP
  1763. END_OF_FILE
  1764.   if test 49353 -ne `wc -c <'man/man1/zsh.1.02'`; then
  1765.     echo shar: \"'man/man1/zsh.1.02'\" unpacked with wrong size!
  1766.   fi
  1767.   # end of 'man/man1/zsh.1.02'
  1768. fi
  1769. if test -f 'src/signals.h.sample' -a "${1}" != "-c" ; then 
  1770.   echo shar: Will not clobber existing file \"'src/signals.h.sample'\"
  1771. else
  1772.   echo shar: Extracting \"'src/signals.h.sample'\" \(1429 characters\)
  1773.   sed "s/^X//" >'src/signals.h.sample' <<'END_OF_FILE'
  1774. XYour signals.h file should look something like this.  If it doesn't,
  1775. Xperhaps your csh or ed is different.
  1776. X
  1777. X/* this file is created automatically by buildzsh */
  1778. X/* if all this is wrong, blame csh ;-) */
  1779. X
  1780. X#define SIGCOUNT       31
  1781. X
  1782. X#ifdef GLOBALS
  1783. X
  1784. Xchar *sigmsg[SIGCOUNT+2] = {
  1785. X    "done",
  1786. X    "hangup",
  1787. X    "interrupt",
  1788. X    "quit",
  1789. X    "illegal instruction",
  1790. X    "trace trap",
  1791. X    "abort",
  1792. X    "EMT instruction",
  1793. X    "floating point exception",
  1794. X    "killed",
  1795. X    "bus error",
  1796. X    "segmentation fault",
  1797. X    "bad system call",
  1798. X    "broken pipe",
  1799. X    "SIGALRM",
  1800. X    "terminated",
  1801. X    "SIGURG",
  1802. X#ifdef USE_SUSPENDED
  1803. X    "suspended (signal)",
  1804. X#else
  1805. X    "stopped (signal)",
  1806. X#endif
  1807. X#ifdef USE_SUSPENDED
  1808. X    "suspended",
  1809. X#else
  1810. X    "stopped",
  1811. X#endif
  1812. X    "continued",
  1813. X    "SIGCHLD",
  1814. X#ifdef USE_SUSPENDED
  1815. X    "suspended (tty input)",
  1816. X#else
  1817. X    "stopped (tty input)",
  1818. X#endif
  1819. X#ifdef USE_SUSPENDED
  1820. X    "suspended (tty output)",
  1821. X#else
  1822. X    "stopped (tty output)",
  1823. X#endif
  1824. X    "SIGIO",
  1825. X    "cpu limit exceeded",
  1826. X    "filesize limit exceeded",
  1827. X    "virtual time alarm",
  1828. X    "SIGPROF",
  1829. X    "SIGWINCH",
  1830. X    "SIGLOST",
  1831. X    "SIGUSR1",
  1832. X    "SIGUSR2",
  1833. X    NULL
  1834. X};
  1835. X
  1836. Xchar *sigs[SIGCOUNT+4] = {
  1837. X    "EXIT",
  1838. X    "HUP",
  1839. X    "INT",
  1840. X    "QUIT",
  1841. X    "ILL",
  1842. X    "TRAP",
  1843. X    "ABRT",
  1844. X    "EMT",
  1845. X    "FPE",
  1846. X    "KILL",
  1847. X    "BUS",
  1848. X    "SEGV",
  1849. X    "SYS",
  1850. X    "PIPE",
  1851. X    "ALRM",
  1852. X    "TERM",
  1853. X    "URG",
  1854. X    "STOP",
  1855. X    "TSTP",
  1856. X    "CONT",
  1857. X    "CHLD",
  1858. X    "TTIN",
  1859. X    "TTOU",
  1860. X    "IO",
  1861. X    "XCPU",
  1862. X    "XFSZ",
  1863. X    "VTALRM",
  1864. X    "PROF",
  1865. X    "WINCH",
  1866. X    "LOST",
  1867. X    "USR1",
  1868. X    "USR2",
  1869. X    "ERR",
  1870. X    "DEBUG",
  1871. X    NULL
  1872. X};
  1873. X
  1874. X#else
  1875. X
  1876. Xextern char *sigs[SIGCOUNT+4],*sigmsg[SIGCOUNT+2];
  1877. X
  1878. X#endif
  1879. END_OF_FILE
  1880.   if test 1429 -ne `wc -c <'src/signals.h.sample'`; then
  1881.     echo shar: \"'src/signals.h.sample'\" unpacked with wrong size!
  1882.   fi
  1883.   # end of 'src/signals.h.sample'
  1884. fi
  1885. echo shar: End of archive 6 \(of 22\).
  1886. cp /dev/null ark6isdone
  1887. MISSING=""
  1888. for I in 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 ; do
  1889.     if test ! -f ark${I}isdone ; then
  1890.     MISSING="${MISSING} ${I}"
  1891.     fi
  1892. done
  1893. if test "${MISSING}" = "" ; then
  1894.     echo You have unpacked all 22 archives.
  1895.     rm -f ark[1-9]isdone ark[1-9][0-9]isdone
  1896. else
  1897.     echo You still must unpack the following archives:
  1898.     echo "        " ${MISSING}
  1899. fi
  1900. exit 0
  1901.  
  1902. exit 0 # Just in case...
  1903.