Public SourceMage Discussion List

["Andraž 'ruskie' Levstik" <ruskie AT codemages.net>]

On 10:08:12 2008-09-02 Remko van der Vossen <wich AT stack.nl> wrote:
> On Fri, Aug 29, 2008 at 07:54:52AM -0500, David Kowis wrote:
> >> I haven't seen the IRC discussion, but I would raise a note of
> >> caution on the point of DocBook and LaTeX.  I like LaTeX and I would
> >> still be hesitant to use it in this type of situation.  Anyone can
> >> throw together some docs in MoinMoin with a few minutes work.  Even
> >> someone familiar with LaTeX is going to have to invest considerably
> >> more time in putting together documentation.
> >>
> >> The more work you require to create and update the documentation, the
> >> less documentation you're going to get.  :-)
> >>
> >
> > Yeah. I agree with this. Keep the bar to entry low. Where's our   
> > Spellwriter's handbook? Oh it's in LaTeX supoosedly still under   
> > development by sandalle. How long has it been there? Years...
> >
> > I don't think doing docs in anything other than simple plain text is
> > a good idea. (wikisyntax is okay)
> 
> Actually I would very much be in favour of LaTeX documentation, there
> are quite a number of tools to create other forms from the LaTeX (html
> single page, multi page and framed, man pages, texinfo pages and txt) in
> addition to the regular dvi, ps and pdf.

Me too.

The guru handbook is in the rdp.git repo. I agree with you on the
versatility of LaTeX as it is easy to convert to other formats either
markup or plaintext.

So here's another +1 for the LaTeX idea...

--
Andraž "ruskie" Levstik
Source Mage GNU/Linux Games grimoire guru
Geek/Hacker/Tinker

Be sure brain is in gear before engaging mouth.
Quis custodiet ipsos custodies.
Ryle hira.

Key id = F4C1F89C
Key fingerprint = 6FF2 8F20 4C9D DB36 B5B6  F134 884D 72CC F4C1 F89C