From help-octave-request at bevo dot che dot wisc dot edu Sun Nov 30 20:44:40 2003
Subject: Re: Starting using octave
From: "John W. Eaton" <jwe at bevo dot che dot wisc dot edu>
To: taltman at lbl dot gov
Cc: help-octave at bevo dot che dot wisc dot edu
Date: Sun, 30 Nov 2003 20:44:32 -0600

On 30-Nov-2003, Tomer Altman <taltman at lbl dot gov> wrote:

| Then, at least, could we use the following Texinfo utility?
| 
| Texi2html
| http://www.mathematik.uni-kl.de/~obachman/Texi2html/
| 
| This script generates very nice web pages automatically from Texinfo
| sources. Here is one of my favorite examples (all the header, footer,
| index, & contents links are generated dynamically) :

Yes, I'm aware of texi2html.  Every Octave source package includes a
set of HTML files automatically generated from the Texinfo sources.  I
believe that Dirk packages these files separately for Debian in the
octave2.1-htmldoc package.

But how does this help improve the content of the manual?

If you think that it would be easier for people to contribute to the
manual if they modified some wiki pages instead of the actual manual
sources, then I think that might be a reasonable thing, but someone
would need to take those user contributions and generate actual
patches for the real manual sources, and also update the wiki pages as
the manual changes.  If no one does this work, then the manual sources
will diverge from the wiki pages.  Chances are good both will be
inaccurate and incomplete.

jwe



-------------------------------------------------------------
Octave is freely available under the terms of the GNU GPL.

Octave's home on the web:  http://www.octave.org
How to fund new projects:  http://www.octave.org/funding.html
Subscription information:  http://www.octave.org/archive.html
-------------------------------------------------------------