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

Kenneth Lundin kenneth.lundin@REDACTED
Sat Jul 11 23:21:18 CEST 2009


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.

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<harveyd@REDACTED> wrote:
> Is there any updates on when the build sources for the documentation
> will be released?
>
> 2008/2/15 Mats Cronqvist <masse@REDACTED>
>
>> 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
>> _______________________________________________
>> erlang-questions mailing list
>> erlang-questions@REDACTED
>> http://www.erlang.org/mailman/listinfo/erlang-questions
>>
>


More information about the erlang-questions mailing list