Re: Vastly better HTML docs

[Jesse W <jessw@xxxxxxxxxxx>]

On Apr 16, 2009, at 3:11 AM, Peter Stephenson wrote:
> The version being distributed on the systems I have is actually 1.78.
Looking over the NEWS files, it looks like the important new features 
are present in that version, so that'll still work.
> This turns the option on.
Great.  When can I expect a new version to be uploaded to 
zsh.docsrc.org and zsh.sourceforge.net, and is this anything I can be 
of help with?
> We now have to assume all .html options are
> output from texi2html, but it's a good bet.
We could also add the zsh- prefix to all the generated file names 
easily enough, if that would make things safer...

Here's a patch to the documentation where we mention the details of the 
HTML conversion (do we really need this? Maybe we should just change it 
to "Please look in the Makefile". ;-))

Index: manual.yo
===================================================================
RCS file: /cvsroot/zsh/zsh/Doc/Zsh/manual.yo,v
retrieving revision 1.18
diff -u -r1.18 manual.yo
--- manual.yo   14 Jul 2008 17:39:26 -0000      1.18
+++ manual.yo   16 Apr 2009 18:28:14 -0000
@@ -187,9 +187,9 @@
 tt(http://zsh.sunsite.dk/Doc/).

 (The HTML version is produced with bf(texi2html), which may be obtained
-from tt(http://www.mathematik.uni-kl.de/~obachman/Texi2html/). The 
command is
-`tt(texi2html -split chapter -expand info zsh.texi)'.  If necessary,
-upgrade to version 1.64 of texi2html.)
+from tt(http://www.nongnu.org/texi2html/). The command is
+`tt(texi2html --output . --ifinfo --split=chapter --node-files 
zsh.texi)'.  If necessary,
+upgrade to version 1.78 of texi2html.)
 )
 enditem()