Re: PATCH: docs

["Bart Schaefer" <schaefer@xxxxxxxxxxxxxxxxxxxxxxx>]

On Apr 28,  3:17pm, Sven Wischnowsky wrote:
} Subject: PATCH: docs
}
} 
} This mentions the `zcompile -z' trick for fans of KSH_AUTOLOAD in the
} compsys manual and moves the compctl section behind, err... after,
} err... to the err... compsys section.

Humph.  I still think it reads better with the compctl section first,
if you're just reading through it like a book.  There's very little
explanation in any of the completion sections about what completion
actually IS, and to have the first section be the one about writing
new widgets is putting the cart before the horse, IMO.  And if you are
not reading it like a book, then it doesn't matter what order they're
in, does it?

Nevertheless, if you're going to insist on rearranging it, rearrange it
everywhere.

Index: Doc/Zsh/intro.yo
===================================================================
@@ -21,9 +21,9 @@
 list(em(zshbuiltins)  Zsh built-in functions)
 list(em(zshzle)       Zsh command line editing)
 list(em(zshcompwid)   Zsh completion widgets)
+list(em(zshcompsys)   Zsh completion system)
 list(em(zshcompctl)   Zsh completion control)
 list(em(zshmodules)   Zsh loadable modules)
-list(em(zshcompsys)   Zsh completion system)
 list(em(zshzftpsys)   Zsh built-in FTP client)
 ifzshone(\
 list(em(zshall)       Meta-man page containing all of the above)
Index: Doc/Zsh/manual.yo
===================================================================
@@ -28,9 +28,9 @@
 menu(Options)
 menu(Shell Builtin Commands)
 menu(Zsh Line Editor)
-menu(Completion Using compctl)
 menu(Completion Widgets)
 menu(Completion System)
+menu(Completion Using compctl)
 menu(Zsh Modules)
 menu(Zftp Function System)
 
@@ -98,14 +98,6 @@
 menu(Completion)
 menu(Miscellaneous)
 
-Completion Using compctl
-
-menu(Command Flags)
-menu(Option Flags)
-menu(Alternative Completion)
-menu(Extended Completion)
-menu(Example)
-
 Completion Widgets
 
 menu(Special Parameters)
@@ -121,6 +113,14 @@
 menu(Bindable Commands)
 menu(Completion Functions)
 menu(Completion Directories)
+
+Completion Using compctl
+
+menu(Command Flags)
+menu(Option Flags)
+menu(Alternative Completion)
+menu(Extended Completion)
+menu(Example)
 
 Zsh Modules
 

-- 
Bart Schaefer                                 Brass Lantern Enterprises
http://www.well.com/user/barts              http://www.brasslantern.com