[erlang-questions] Is there a way to generate PDFs with edoc?

[Kenneth Lundin]

The way we use to produce html and pdf documentation in Erlang/OTP
from R13B-3 works like this:

If edoc markup in the sources then
   run edoc with docb_edoc_xml_cb (from docbuilder app) as layout
callback module
   This produces XML according to the DTDs described in docbuilder
   feed this XML into erl_docgen (introduced in R13B03) which uses
xsltproc and xslt for the transformation to html and xsl-fo
   the xsl-fo is fed into Apache FOP which produces PDF.

I.e there is no use of Latex in this.
You don't need to program anything your self.
The process is not fully documented yet (will be in later releases)
but it should be possible to mimic
what we are doing in edoc and syntax tools (in the R13B03 release and onwards).

/Kenneth

On Thu, Jan 7, 2010 at 3:27 PM, Axel Andrén <axelandren@REDACTED> wrote:
> I'm afraid I have no idea what I'm looking for. I see that it depends on
> .tex files, but there are none in the application folder...
>
> 2010/1/5 Kenneth Lundin <kenneth.lundin@REDACTED>
>>
>> Hi,
>>
>> We are generating pdf via edoc for some of the applications.
>> For example the doc for edoc and syntax_tools are generated this way.
>>
>> We use a layout callback module for edoc which produces XML according to
>> the
>> DTD we use for OTP documentation.
>> The callback module belongs to the docbuilder application and the module
>> name
>> is docb_edoc_xml_cb. You find an example on how to use it in the
>> source of that module.
>>
>> If you use that approach you PDF will look like :
>> http://www.erlang.org/doc/apps/edoc/edoc.pdf
>>
>> See the make files in the doc directory of the edoc and syntax_tools
>> applications.
>>
>> /Kenneth Erlang/OTP, Ericsson
>>
>>
>> On Tue, Jan 5, 2010 at 10:22 AM, Axel Andrén <axelandren@REDACTED> wrote:
>> > Hello!
>> >
>> > I'm part of a student group that has been working on an erlang-based
>> > cluster
>> > for the half a year or so. We are currently writing the report for both
>> > the
>> > cluster and the course it was part of, and would like to use the edoc
>> > comment documentation in the product report. But edoc makes html files,
>> > which is a bit inconvenient for including in a report.
>> >
>> > Ideally we'd like to put the documentation for each application in one
>> > big
>> > pdf, but getting one pdf for each app would work fine too.
>> >
>> > Is there a way we can do this?
>> >
>> > Best regards,
>> > Axel Andrén, Student at Uppsala University
>> >
>
>