From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 21740 invoked from network); 13 Jun 1999 17:28:23 -0000 Received: from sunsite.auc.dk (130.225.51.30) by ns1.primenet.com.au with SMTP; 13 Jun 1999 17:28:23 -0000 Received: (qmail 6604 invoked by alias); 13 Jun 1999 17:28:13 -0000 Mailing-List: contact zsh-workers-help@sunsite.auc.dk; run by ezmlm Precedence: bulk X-No-Archive: yes X-Seq: 6608 Received: (qmail 6596 invoked from network); 13 Jun 1999 17:28:09 -0000 From: "Bart Schaefer" Message-Id: <990613172734.ZM17571@candle.brasslantern.com> Date: Sun, 13 Jun 1999 17:27:34 +0000 In-Reply-To: <9906121437.AA12470@ibmth.df.unipi.it> Comments: In reply to Peter Stephenson "PATCH: pws-21: Documentation formatting" (Jun 12, 4:37pm) References: <9906121437.AA12470@ibmth.df.unipi.it> X-Mailer: Z-Mail (5.0.0 30July97) To: zsh-workers@sunsite.auc.dk (Zsh hackers list) Subject: PATCH: pws-21 + Documentation formatting: Spell checking MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii On Jun 12, 4:37pm, Peter Stephenson wrote: } Subject: PATCH: pws-21: Documentation formatting } } [Emerges from engine room with blackened face, carrying large wrench and } random engine part which is still puttering slightly and dripping oil:] } I've tried to sort out the mess with filling and indentation in the } documentation. As a follow-on to that patch, here are corrections for a number of typos. This is entirely the result of running "ispell" over the .yo files, so I made only one attempt (the use of a `sectref' yodl macro which is not defined anywhere) to correct the semantics. Index: Doc/Zsh/compctl.yo =================================================================== @@ -56,7 +56,7 @@ arranges for completion of the words of any command beginning with tt(foo). When completion is attempted, all pattern completions are tried in the reverse order of their definition until one matches. By -default, completion then procedes as normal, i.e. the shell will try to +default, completion then proceeds as normal, i.e. the shell will try to generate more matches for the specific command on the command line; this can be overridden by including tt(-tn) in the flags for the pattern completion. @@ -277,7 +277,7 @@ ) item(tt(-K) var(function))( Call the given function to get the completions. Unless the name -starts with an underscode, the function is +starts with an underscore, the function is passed two arguments: the prefix and the suffix of the word on which completion is to be attempted, in other words those characters before the cursor position, and those from the cursor position onwards. The @@ -405,7 +405,7 @@ use its own criteria to decide what matches. If there is no completion, the original word is retained. Since the produced possible completions seldom seldom have interesting common prefixes -and suffixes, menucompletion is started immediatly if tt(AUTO_MENU) is +and suffixes, menucompletion is started immediately if tt(AUTO_MENU) is set and this flag is used. ) item(tt(-y) var(func-or-var))( Index: Doc/Zsh/compsys.yo =================================================================== @@ -51,7 +51,7 @@ The script tt(compinstall) can be run by a user to set up the completion system for use. It will usually insert code into tt(.zshrc), although if -that is not writeable it will save it in another file and tell you that +that is not writable it will save it in another file and tell you that file's locations. Note that it is up to you to make sure that the lines added to tt(.zshrc) are actually run; you may, for example, need to move them to an earlier place in the file if tt(.zshrc) usually returns early. @@ -89,7 +89,7 @@ configuration which will be read in on future invocations. The easiest way to do this is by adding the option tt(-d) whenever tt(compinit) is sourced. In this case the dumped file will have the same name as the sourced file, -but with tt(.dump) appended to the end, or, if that is not writeable by the +but with tt(.dump) appended to the end, or, if that is not writable by the user, the file tt(.zcompdump) in the same directory as the startup files (i.e. tt($ZDOTDIR) or tt($HOME)); alternatively, an explicit file name can be given following the tt(-d). On the next call to tt(compinit -d), the @@ -106,7 +106,7 @@ If the number of completion files changes, tt(compinit) will recognise this and produce a new dump file. However, if the name of a function or the -arguments in the first line of a tt(#compdef) funcion (as described below) +arguments in the first line of a tt(#compdef) function (as described below) change, it is easiest to delete the dump file by hand so that the next time tt(compinit) will re-create it. Index: Doc/Zsh/compwid.yo =================================================================== @@ -223,7 +223,7 @@ ) item(tt(insert))( This controls the manner in which a match is inserted into the command -line. On entry to the widget fuction, if it is unset the command line is +line. On entry to the widget function, if it is unset the command line is not to be changed; if set to tt(unambiguous), any prefix common to all matches is to be inserted; if set to tt(menu) or tt(automenu) the usual behaviour of the tt(MENU_COMPLETE) or tt(AUTO_MENU) options, respectively, @@ -256,7 +256,7 @@ This is set to tt(yes) if there is still a valid list of completions from a previous completion at the time the widget is invoked. This will usually be the case if and only if the previous editing operation was a -completion widget or one of the builtin completion fuctions. If there is a +completion widget or one of the builtin completion functions. If there is a valid list and it is also currently shown on the screen, the value of this key is tt(shown). @@ -333,7 +333,7 @@ generated them directly from a tt(compctl)-definition with the same flags. The completion code will consider only those matches as possible completions that match the prefix and suffix from the special -parameters desribed above. These strings will be compared with the +parameters described above. These strings will be compared with the generated matches using the normal matching rules and any matching specifications given with the tt(-M) flag to tt(compgen) and the global matching specifications given via the tt(compctl -M )var(spec1 ...) @@ -612,14 +612,14 @@ ) item(tt(-q))( If the cursor is currently inside single or double quotes, the word -currenly being completed is split in separate words at the spaces. The +currently being completed is split in separate words at the spaces. The resulting words are stored in the tt(words) array, and tt(PREFIX), tt(SUFFIX), tt(QIPREFIX), and tt(QISUFFIX) are modified to reflect the word part that is completed. ) enditem() -In all the above cases the return value is zero if the test succeded +In all the above cases the return value is zero if the test succeeded and the parameters were modified and non-zero otherwise. This allows one to use this builtin in tests such as: Index: Doc/Zsh/expn.yo =================================================================== @@ -729,7 +729,7 @@ whole substitution is in double quotes, and what flags are supplied to the current level of substitution, just as if the nested substitution were the outermost. The flags are not propagated up to enclosing -substitutions; the nested subsitution will return either a scalar or an +substitutions; the nested substitution will return either a scalar or an array as determined by the flags, possibly adjusted for quoting. All the following steps take place where applicable at all levels of substitution. Note that, unless the `tt((P))' flag is present, the flags and any subscripts Index: Doc/Zsh/files.yo =================================================================== @@ -26,7 +26,7 @@ When a login shell exits, the files tt($ZDOTDIR/.zlogout) and then tt(/etc/zlogout) are read. This happens with either an explicit exit -via the tt(exit) or tt(logout) commands, or an implict exit by reading +via the tt(exit) or tt(logout) commands, or an implicit exit by reading end-of-file from the terminal. However, if the shell terminates due to tt(exec)'ing another process, the logout files are not read. These are also affected by the tt(RCS) and tt(GLOBAL_RCS) options. Index: Doc/Zsh/mod_mapfile.yo =================================================================== @@ -34,13 +34,13 @@ it should not automatically be assumed that use of tt(mapfile) represents a gain in efficiency over use of other mechanisms. Note in particular that the whole contents of the file will always reside physically in memory when -accessed (possibly multiple times, due to standard parameter subsitution +accessed (possibly multiple times, due to standard parameter substitution operations). In particular, this means handling of sufficiently long files (greater than the machine's swap space, or than the range of the pointer type) will be incorrect. No errors are printed or flagged for non-existent, unreadable, or -unwriteable files, as the parameter mechanism is too low in the shell +unwritable files, as the parameter mechanism is too low in the shell execution hierarchy to make this convenient. It is unfortunate that the mechanism for loading modules does not yet allow Index: Doc/Zsh/mod_zftp.yo =================================================================== @@ -209,7 +209,7 @@ Create a new directory var(directory) on the server. ) item(tt(rmdir) var(directory))( -Delete the diretory var(directory) on the server. +Delete the directory var(directory) on the server. ) item(tt(rename) var(old-name) var(new-name))( Rename file var(old-name) to var(new-name) on the server. @@ -221,7 +221,7 @@ item(tt(quote) var(args...))( Send the raw FTP command sequence to the server. You should be familiar with the FTP command set as defined in RFC959 before doing -this. Useful comands may include tt(STAT) and tt(HELP). Note also +this. Useful commands may include tt(STAT) and tt(HELP). Note also the mechanism for returning messages as described for the variable tt(ZFTP_VERBOSE) below, in particular that all messages from the control connection are sent to standard error. @@ -335,7 +335,7 @@ startitem() item(1.)( -A positive prelimnary reply. +A positive preliminary reply. ) item(2.)( A positive completion reply. @@ -442,7 +442,7 @@ will not be reflected by changes to the variables (but should be otherwise harmless). -On some operatings systems, the control connection is not valid after a +On some operating systems, the control connection is not valid after a fork(), so that operations in subshells or on the left hand side of a pipeline are not possible. Index: Doc/Zsh/params.yo =================================================================== @@ -95,7 +95,7 @@ array (but not an associative array) may be created by assignment to a range or element. Arrays do not nest, so assigning a parenthesized list of values to an element or range changes the number of elements in the -array, shifting the other elements to accomodate the new values. (This +array, shifting the other elements to accommodate the new values. (This is not supported for associative arrays.) To delete an element of an ordinary array, assign `tt(LPAR()RPAR())' to @@ -180,7 +180,7 @@ values. Note that, because the positional parameters form an array, an array assignment of the form `var(n)tt(=LPAR())var(value) ...tt(RPAR())' is allowed, and has the effect of shifting all the values at positions greater -than var(n) by as many positions as necessary to accomodate the new values. +than var(n) by as many positions as necessary to accommodate the new values. texinode(Local Parameters)(Parameters Set By The Shell)(Positional Parameters)(Parameters) sect(Local Parameters) Index: Doc/Zsh/zftpsys.yo =================================================================== @@ -8,7 +8,7 @@ to perform FTP operations from the shell command line or within functions or scripts. The interface is similar to a traditional FTP client (e.g. the tt(ftp) command itself, see manref(ftp)(1)), but as it is entirely done -within the shell all the familar completion, editing and globbing features, +within the shell all the familiar completion, editing and globbing features, and so on, are present, and macros are particularly simple to write as they are just ordinary shell functions. @@ -116,7 +116,7 @@ In the first form with var(dir) present, change to the directory var(dir). The command `tt(zfcd ..)' is treated specially, so is guaranteed to work on -non-UNIX servers (note this is handled internall by tt(zftp)). If var(dir) +non-UNIX servers (note this is handled internally by tt(zftp)). If var(dir) is omitted, has the effect of `tt(zfcd ~)'. The second form changes to the directory previously current. @@ -275,7 +275,7 @@ ) enditem() -subsect(Closing the connectino) +subsect(Closing the connection) startitem() item(tt(zfclose))( Close the connection. @@ -324,7 +324,7 @@ startitem() item(tt(zfinit [ -n ]))( -As decribed above, this is used to initialise the zftp function system. +As described above, this is used to initialise the zftp function system. The tt(-n) option should be used if the zftp command is already built into the shell. ) @@ -356,7 +356,7 @@ item(tt(zfrglob var(varname)))( Perform remote globbing, as describes in more detail below. var(varname) is the name of a variable containing the pattern to be expanded; if there -were any matches, the same variable will be set to the exanded set of +were any matches, the same variable will be set to the expanded set of filenames on return. ) item(tt(zfrtime var(lfile) var(rfile) [ var(time) ]))( @@ -412,7 +412,7 @@ handling is problematic and it is recommended that globbing only be used within the current directory. The list of files in the current directory, if retrieved, will be cached, so that subsequent globs in the same -directory without an interventing tt(zfcd) are fast. +directory without an intervening tt(zfcd) are fast. If the variable tt($zfrglob) is set to a non-zero length, globbing is instead performed on the remote host: the server is asked for a list of Index: Doc/Zsh/zle.yo =================================================================== @@ -83,7 +83,7 @@ in keymaps are bound to are in fact widgets. Widgets can be user-defined or built in. -There are 162 standard widgets built in to ZLE (see sectref(Standard Widgets)). +There are 162 standard widgets built in to ZLE (see Standard Widgets below). Other built-in widgets can be defined by other modules (see ifzman(zmanref(zshmodules))\ ifnzman(noderef(Zsh Modules))\ @@ -160,7 +160,7 @@ item(tt(keys) (array))( The keys typed to invoke this widget, one element per key. Control-keys are reported with a leading `tt(^)', as in `tt(^A)', -and meta-keys are repoted with a leading `tt(M-)', as in `tt(M-a)' and +and meta-keys are reported with a leading `tt(M-)', as in `tt(M-a)' and `tt(M-^A)'. ) vindex(NUMERIC) -- Bart Schaefer Brass Lantern Enterprises http://www.well.com/user/barts http://www.brasslantern.com