Documentation proposal

Yves-Alexis Perez corsac at debian.org
Mon May 4 17:31:03 CEST 2009


On dim, 2009-05-03 at 21:31 +0200, Jannis Pohlmann wrote:
> Jim pointed me to reStructuredText [1] yesterday. I tried it today.
> It's very easy to use, the reST sources are very easy to read and the
> best thing is: there's a tool called Sphinx [2] which generates HTML and
> PDF from it and links different reST source files together.

Another stuff you might want to look at (sorry I'm a bit late) is
asciidoc. I use it myself for all the doc (or related) stuff I write,
and it's used for the producing the git manpages. You can generate
docbook (and so latex/pdf), html and manpages quite easily.

See:

http://www.methods.co.nz/asciidoc/
http://www.kernel.org/pub/software/scm/git/docs/

Cheers,
-- 
Yves-Alexis
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
URL: <http://mail.xfce.org/pipermail/xfce4-dev/attachments/20090504/95373bb9/attachment.pgp>


More information about the Xfce4-dev mailing list