Re: [SLUG] Tools for documentation.

[Jeff Waugh <jdub@nospam.aphid.net>]

> > At the risk of being flamed, I'd recommend you don't go with TeX because it
> > could be seen to be `legacy technology'. 
>   ^^^^^^^^^^^^^
> Ah! lucky you put that proviso in or I might have bitten
> stronger ;-)

I put that one in for you, Michael. ;)

> Its as legacy as is UNIX.

And has as wonderful a history and ethos.

> Does he want to document code? Here is where the choice becomes more
> difficult.  noweb when teamed with LaTeX formats, cross references and
> indexes all your code chunks. I don't think DocBook does that as its more
> just like LaTeX  - a markup language.  (noweb could be rewritten to work
> with DocBook though, now that would be nice).

DocBook is great for documenting code - Alan Cox has been working on a
kernel documentation system with it for some time. However, the idea of
combining noweb (which I've heard about here and there, and am very keen to hear your
talk) and DocBook sounds intriguing.

> So we need to find out what Rodos wants to document (then can we have a
> DocBook/LaTeX flame war?). 

Sure.

Rodos? Clarify please, Michael and I are up for a flame.


;) - Jeff


-- jdub@nospam.aphid.net ------------------------------------- jdub@nospam.linux.org.au --

   w: http://www.slug.org.au/
   i: 16341281 (jdub!)
   q: "In addition to these ample facilities, there exists a powerful
       configuration tool called gcc." - Elliot Hughes, author of lwm

--
SLUG - Sydney Linux Users Group Mailing List - http://www.slug.org.au
To unsubscribe send email to slug-request@nospam.slug.org.au with
unsubscribe in the text