Re: [OctDev] Re: docbook

[Rafael L. <lab...@mp...>]

* Paul Kienzle <pki...@ja...> [2002-03-20 11:33]:

> I don't care too much about format so long as it is stable, convenient, and
> flexible.  If the latex to html translators do what we need, and we all are
> familiar with latex, then you will need to provide a compelling argument
> for us to learn DocBook.  

The only argument in favour of DocBook is that it is DTD designed for
technical documentation, containing specific tags like <function>,
<parameter>, etc.  Docbook is a markup "language", while LaTeX is just a
typesetting language (much like HTML in that regard).  That places LaTeX at
lower level of abstraction than DocBook.  Besides, that are hosts of ways to
efficiently parse DocBook-XML nowadays.

Actually, I don't care neither about the format, but the final choice would
depend on the answer to the questions: what are our specific needs here?
What kind of markup do we need in the doc strings?  Are those texinfo
markups enough, or do we need something more powerful?

-- 
Rafael