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

Re: Vastly better HTML docs

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 @@

 (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.)

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