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.
--
Best regards,
Kern
(">
/\
V_V
-------------------------------------------------------
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
