PATCH: pws-21: Documentation formatting

PATCH: pws-21: Documentation formatting

[Peter Stephenson]

[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.  The new version is described at the end of
zsh-development-guide (which I can never find because it's in Util/ and
isn't a utility).  The advantages are that TeXinfo formatting is now much
better, using the proper @example and @display formats, and there is no
more confusion over whether to put newlines in after `noindent(' or before
the corresponding `)' etc. etc.: the macros insert all requisite newlines,
except the ones which surround the whole expression which are there for
clarity.

I've also turned off setnewchapternewpage, because it was producing far too
much space with the short chapters; the new TeX'd version is now 34 pages
shorter.  This has the side effect of making single-sided printing the
default, but that should ideally be handled by definitions in the
Makefile.  Bleugh.

Lastly, I changed the texinfo node `Programmable Completion' into
`Programmable Completion Using compctl', because, as some readers of this
list may faintly recall, there is now an alternative model for programmable
completion.

begin 644 docs_fill.dif.gz
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
:=A8LYB@'V!L!-YE+Z9(X:_\%4*Y%^]1X```V
`
end

-- 
Peter Stephenson <pws@ibmth.df.unipi.it>       Tel: +39 050 844536
WWW:  http://www.ifh.de/~pws/
Dipartimento di Fisica, Via Buonarroti 2, 56127 Pisa, Italy

PATCH: pws-21 + Documentation formatting: Spell checking

[Bart Schaefer]

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