Re: Zsh guide

[Peter Stephenson <pws@xxxxxxxxxxxxxxxxx>]

Clint Adams wrote:
> > Urgh.  Well, that's been there a good while longer, but it's really the
> > manual.  Maybe it should be called that.
> 
> I agree.  Especially since the manpages refer to sections within it.

Does anyone object to the manual being called the manual, in keeping with
standard UNIX terminology?  If not, after applying the patch you should
rename Doc/Zsh/guide.yo to Doc/Zsh/manual.yo .

--- Doc/Makefile.in.gf	Wed Sep 29 16:08:37 1999
+++ Doc/Makefile.in	Wed Sep 29 16:08:58 1999
@@ -54,7 +54,7 @@
 YODLSRC = zmacros.yo zman.yo ztexi.yo Zsh/arith.yo Zsh/builtins.yo \
 Zsh/compat.yo Zsh/compctl.yo Zsh/compsys.yo Zsh/compwid.yo Zsh/cond.yo \
 Zsh/exec.yo Zsh/expn.yo \
-Zsh/filelist.yo Zsh/files.yo Zsh/func.yo Zsh/grammar.yo Zsh/guide.yo \
+Zsh/filelist.yo Zsh/files.yo Zsh/func.yo Zsh/grammar.yo Zsh/manual.yo \
 Zsh/index.yo Zsh/intro.yo Zsh/invoke.yo Zsh/jobs.yo Zsh/metafaq.yo \
 Zsh/modules.yo Zsh/mod_cap.yo \
 Zsh/mod_clone.yo Zsh/mod_comp1.yo Zsh/mod_compctl.yo Zsh/mod_complist.yo \
--- Doc/Zsh/guide.yo.gf	Wed Sep 29 16:08:37 1999
+++ Doc/Zsh/guide.yo	Wed Sep 29 16:26:18 1999
@@ -1,6 +1,6 @@
 texiifinfo(\
-texinode(Top)(The Z Shell Guide)((dir))((dir))
-texitop(The Z Shell Guide)
+texinode(Top)(The Z Shell Manual)((dir))((dir))
+texitop(The Z Shell Manual)
 This Info file documents Zsh, a freely available UNIX command interpreter
 (shell), which of the standard shells most closely resembles the Korn shell
 (ksh), although it is not completely compatible.
@@ -9,7 +9,7 @@
 )\
 
 startmenu()
-menu(The Z Shell Guide)
+menu(The Z Shell Manual)
 menu(Introduction)
 menu(Invocation)
 menu(Files)
@@ -131,26 +131,26 @@
 menu(The zftp Module)
 menu(The zle Module)
 endmenu()
-texinode(The Z Shell Guide)(Introduction)(Top)(Top)
-chapter(The Z Shell Guide)
+texinode(The Z Shell Manual)(Introduction)(Top)(Top)
+chapter(The Z Shell Manual)
 This document has been produced from the texinfo file tt(zsh.texi),
 included in the tt(Doc) sub-directory of the Zsh distribution.
 sect(Producing documentation from zsh.texi)
 The texinfo source may be converted into several formats:
 
 startitem()
-item(The Info guide)(
+item(The Info manual)(
 The Info format allows searching for topics, commands, functions, etc.
 from the many Indices. The command `tt(makeinfo zsh.texi)' is used to
 produce the Info documentation.
 )
-item(The printed guide)(
+item(The printed manual)(
 The command `tt(texi2dvi zsh.texi)' will output tt(zsh.dvi) which can
 then be processed with bf(dvips) and optionally bf(gs) (Ghostscript) to
-produce a nicely formatted printed guide.
+produce a nicely formatted printed manual.
 )
-item(The HTML guide)(
-An HTML version of this guide is available at the Zsh web site via:
+item(The HTML manual)(
+An HTML version of this manual is available at the Zsh web site via:
 
 tt(http://sunsite.auc.dk/zsh/Doc/index.html).
 
--- Doc/Zsh/intro.yo.gf	Wed Sep 29 16:08:37 1999
+++ Doc/Zsh/intro.yo	Wed Sep 29 16:09:53 1999
@@ -1,4 +1,4 @@
-texinode(Introduction)(Invocation)(The Z Shell Guide)(Top)
+texinode(Introduction)(Invocation)(The Z Shell Manual)(Top)
 chapter(Introduction)
 ifzman(\
 sect(Synopsis)
--- Doc/zsh.yo.gf	Wed Sep 29 16:08:37 1999
+++ Doc/zsh.yo	Wed Sep 29 16:10:11 1999
@@ -21,7 +21,7 @@
 @finalout
 @end iftex)
 texititlepage()
-texititle(The Z Shell Guide)
+texititle(The Z Shell Manual)
 texisubtitle(Version version())
 texisubtitle(Updated date())
 texiauthor(Original documentation by Paul Falstad)
@@ -42,7 +42,7 @@
 into another language, under the above conditions for modified versions.
 texiendtitlepage()
 )\
-ifnzman(includefile(Zsh/guide.yo))

+ifnzman(includefile(Zsh/manual.yo))

 includefile(Zsh/intro.yo)

 includefile(Zsh/invoke.yo)

 includefile(Zsh/files.yo)

--- Doc/ztexi.yo.gf	Wed Sep 29 16:08:37 1999
+++ Doc/ztexi.yo	Wed Sep 29 16:10:40 1999
@@ -63,7 +63,7 @@
   NOTRANS(@ifinfo)NL()\
   NOTRANS(@dircategory Utilities)NL()\
   NOTRANS(@direntry)NL()\
-  NOTRANS(     * ZSH: (zsh).                     The Z Shell Guide.)NL()\
+  NOTRANS(     * ZSH: (zsh).                     The Z Shell Manual.)NL()\
   NOTRANS(@end direntry)NL()\
   NOTRANS(@end ifinfo)NL()\
 )


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