Re: [SLUG] Tools for documentation.

[Michael Lake <Mike.Lake@nospam.uts.edu.au>]

Andrew Morton wrote:
> Jeff Waugh wrote:
> > DocBook is extraordinarily fast to work with - once you have a working
> > knowledge of the tags you need, it's lucid.
> erm..  I once did a 60 pager in Docbook and nearly died.  It were
> 'orrid.
> 
> What tool do you people use for the actual editing?  Do you edit the
> tags directly?  Use emacs PSGML mode?  Anyone tried Conglomerate?  (I
> think that's xml-only...)

Thats one major difference between LaTeX and DocBook. LaTeX
was designed in the days of text editors and entry of the
markup tags was done by humans. The DocBook markup is more
verbose and takes more typing if entering it by hand unless
you use macros in emacs or gvim - even then it IS more
typing. DocBook is best entered with a purpose GUI editor.

Using Jeff's example...

DocBook
-------
<sect1>
<title>Widgets</title>
<para>Widgets are really helpful, blah, blah, blah... [and
so on]</para>
    <sect2>
    <title>The Big Widget</title>
    <para>Only very strong engineers should work with Big
Widgets...</para>
    </sect2>
</sect1>

LaTeX
-----
\section{Widgets}
Widgets are really helpful, blah, blah, blah... [and so on]

\section{The Big Widget}
Only very strong engineers should work with Big Widgets...

LaTeX is much easier to use in a text editor.

> And one other thing:  changebars.
yep - Latex has changebars.

Mike
-- 
--------------------------------------------------------------------
Michael Lake
University of Technology, Sydney
Email: mailto:Mike.Lake@nospam.uts.edu.au Ph: 02 9514 1724 Fx: 02
9514 1628 
URL: http://www.science.uts.edu.au/~michael-lake/
Linux enthusiast, active caver and interested in anything
technical.
--------------------------------------------------------------------
--
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