[erlang-questions] Documentation build process: creating DocBook XML?
Sun Jul 12 01:29:57 CEST 2009
On Sat, Jul 11, 2009 at 11:21 PM, Kenneth
> 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
>>> > (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...
More information about the erlang-questions