Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Re: Man pages missing



<> In any event, I know n/t/groff and can muddle through TeX stuff.
<> I'll be damned if I am going to learn yodl.  To learn yet another
<> text processor is just too much.
<
<No, it's not too much.  What's too much is to have to handle too
<different documentation format, and sync them all the time.

I commented to RC separately about the documentation.  Personally I think
the man pages and the manual should be separated.  The man pages should be
very brief, to the point that the zsh man page could be only a couple of
pages long.

The manual should be vastly expanded, adding lots of examples of how all
of the various functions work.  Te current documentation discusses all
of the little pieces, but the big picture is easily lost.

The main manual should be done using a package like Framemaker, which would
allow for easier WYSIWYG editing and formatting.  Lots of examples could
be added to the document.  Zsh needs a decent manual.  What we have now
are the man pages without the nroff/man-page-looking-format.

Yes it would be a big project, something that I think Zsh deserves.

Using FrameMaker would also allow for the document to be turned into a PDF
file for on-line help.  Frankly, the current help files are old fashioned.
A state-of-the-art shell needs state-of-the-art manuals.

Those are my thoughts.

MB
-- 
System Administrator - Finnigan FT/MS - Madison WI. <URL:http://www.ftms.com/>
e-mail: brown@xxxxxxxx
phone: (608) 273-8262 ext: 612  fax: (608) 273-8719
Visit - <URL:http://www.cdsnet.net/vidiot/>  (Your link to Star Trek and UPN)



Messages sorted by: Reverse Date, Date, Thread, Author