octave-maintainers
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: FAQ format


From: Thomas Weber
Subject: Re: FAQ format
Date: Thu, 26 Mar 2009 23:22:17 +0100
User-agent: Mutt/1.5.18 (2008-05-17)

On Wed, Mar 25, 2009 at 02:12:11PM -0400, John W. Eaton wrote:
> Having it as an HTML document might be OK too, as it would look better
> on the web, but I find editing HTML to be relatively unpleasant.
> 
> Comments?

Are you aware of ReStructuredText?
http://docutils.sourceforge.net/rst.html

Pure ASCII, Emacs mode available and both HTML and LaTeX can be
generated from it.
Debian package is 'python-docutils'. 

Example for an .rst file and the resulting HTML output:
http://tw-math.de/~weber/using-debbugs.rst
http://tw-math.de/~weber/using-debbugs.html

I'd say that the FAQ as text/.rst document shipped in the source tarball
is sufficient, though. Otherwise, we'll add a dependency on doctuils for
building Octave.

        Thomas


reply via email to

[Prev in Thread] Current Thread [Next in Thread]