Kern Sibbald wrote:
On Thursday 12 January 2006 23:09, Paul Heinlein wrote:
On Thu, 12 Jan 2006, Andrew Ford wrote:
Maybe what is needed is a separate documentation mailing list to
gather together the interested parties and then to draw up a
strategy for the documentation as a sub-project.
I'll comment on Andrew's ideas tomorrow, which I find excellent ...
If part of the move includes migrating the documentation to something
like DocBook XML (a good idea, imo), I'm willing to volunteer some
time. The migration would likely encompass markup of the existing docs
and assembling a decent toolchain for building various output formats:
(x)html, man pages, PDF, ...
I appreciate your interest, but as you will soon learn, I'm not a fan of
DocBook
I once used DocBook for the apcupsd documentation, and found it the worst
typesetting language I have ever seen in my life. I have used many
documentation systems and even wrote a typesetting program called DPS that is
probably still used today by the largest magazine publisher in the US.
When I was working with DocBook, I had nothing but pain an agony. XML may be
fine for computers, but it not fit for human editing ... As a consequence,
I am not interested in migrating the existing TeX document to DocBook.
Maybe someday when really good GUIs exist for the Open Document format, I'll
rethink my current position.
I'll echo Kern's thoughts on DocBook. I wrote the Apache Pocket
Reference for O'Reilly using DocBook and Emacs as the editor and it was
painful. All the styling of the LaTeX should be done in LaTeX class and
package files so the markup should be logical. I would argue that if
one restricts oneself in what commands one uses then the source file can
be quite readable (and I have typeset documentation, and computing and
cookery books with LaTeX), which is certainly not the case with HTML,
SGML or XML. I think a compromise is to define a limited set of LaTeX
commands that may be used and have a LaTeX to DocBook convertor.
Andrew Ford
-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems? Stop! Download the new AJAX search engine that makes
searching your log files as easy as surfing the web. DOWNLOAD SPLUNK!
http://ads.osdn.com/?ad_id=7637&alloc_id=16865&op=click
_______________________________________________
Bacula-users mailing list
Bacula-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/bacula-users
