[erlang-questions] Documentation build process: creating DocBook XML?

Tuncer Ayaz <>
Sun Jul 12 01:29:57 CEST 2009


On Sat, Jul 11, 2009 at 11:21 PM, Kenneth
Lundin<> wrote:
> Most of the doc sources are already there. What's missing is
> working make files to build the doc and the top level documentation.
> But for all applications there is a <appname>/doc/src directory containing the
> xml files and other files which is the doc source for that application.
>
> The plan is to improve this gradually i.e. with working make files for
> open source users and also the tools for building to html and pdf.
>
> Currently we are using the OTP application docbuilder for generating
> the html , man and pdf formats but we have far gone plans to change
> both the tool chain and the dtd's for the sources.
> When it comes to tools we are leaning strongly towards xsltproc for
> the translation to (x)html and xsltproc + Apache FOP for the
> translation to PDF.

What's missing in docbuilder?
The current output we get in HTML and man format are perfect
for me (personally). I guess it's not about style or format and
more about missing functionality.

> The DTD's we are using are described in the docbuilder docs.
> We have plans to reduce the number of DTD's as well. Using XMLSchema instead.
>
> /Kenneth Erlang/OTP Ericsson
>
> On Sat, Jul 11, 2009 at 2:04 AM, Dale Harvey<> wrote:
>> Is there any updates on when the build sources for the documentation
>> will be released?
>>
>> 2008/2/15 Mats Cronqvist <>
>>
>>> Matthias Lang wrote:
>>> > I have a shell script which does this:
>>> >
>>> >   ~ >eman io fwr
>>> >   showing
>>> file:///usr/local/src/otp_doc_R11B-4/lib/stdlib-1.14.4/doc/html/io.html#fwrite/1
>>> >
>>> > (it pops up the page in the currently running browser). As far as I
>>> > know, I'm the only user. The web version doesn't get much traffic
>>> > either.
>>>   i used a (modified) version of it. worked fine, but i liked
>>> gotapi.com/erlang better. alas, since R12 that's
>>> stopped working properly...
>>>
>>>  mats


More information about the erlang-questions mailing list