OT: [erlang-bugs] Building docs for R13B-03 fails

[Bengt Kleberg]

Greetings,

It has been well over a year since last time I mentioned this paper
"Recursive Make Considered Harmful",
(http://miller.emu.id.au/pmiller/books/rmch/). so I hope it is ok that I
do it again.

Nice little reading for those that find themselves wondering if they are
the only ones that think make is somewhat lacking, at times.


bengt

On Mon, 2009-12-14 at 13:02 +0300, Sergei Golovan wrote:
> Hi!
> 
> I did some further investigations and found that simply calling make
> in all doc/src
> directories works better then trying to run make recursively.
> 
> pwd=`pwd`
> for i in `find . -wholename '*/doc/src'` ; do
>     (cd $i ; make man ERL_TOP=$pwd )
> done
> 
> (using Erlang R12B-02-1 edoc and docbuilder, and the attached docb_gen script)
> generates manpages perfectly, make html and make pdf though suffer from runtime
> errors while running xsltproc.
> 
> Running make recursively reveals a whole bunch of problems with
> missing and redefined
> 'docs' targets in makefiles.
> 
> On Mon, Dec 14, 2009 at 12:16 PM,  <lars@REDACTED> wrote:
> > Hi Sergei,
> > we started to build our documentation with open source tools in R13B03 so it
> > would be possible to build the doc from the delivered sources.
> >
> > But it's still only built in house because we hadn't time to test it but the plan is
> > to have it work for everyone in R13B04.
> >
> > Thanks for your report, we'll have a look at those fault.
> >
> > Regards Lars
> >
> >
> > Sergei Golovan wrote:
> >> Hi!
> >>
> >> I'm trying to build Erlang documentation from the sources (the goal is
> >> to switch from prebuilt docs for Debian Erlang packages as building
> >> them from the source is preferable).
> >>
> >> To do that I run
> >> make
> >> make TYPE=docs
> >> (in fact, make libs doesn't recognize TYPE, so I had to replace "make
> >> opt" by "make $(TYPE) in the top-level Makefile).
> >>
> >> and I've found several problems which make build fail:
> >>
> >> 1) For some XML files (e.g. erts/docs/src/book.xml) xsltproc reports
> >> runtime errors about undefined variables (partnum in line 871 and 963
> >> of db_pdf.xsl, in lines 1075 and 1173 of db_html.xsl). Is this a bug
> >> in the stylesheets or in xsltproc? (Both 1.1.24 from Debian stable and
> >> 1.1.26 from Debian unstable failed.)
> >>
> >> 2) wx application has duplicated targets html and docs in its makefile.
> >>
> >> 3) wx application (and others too) require docb_gen script to generate
> >> XML docs sources. It is missing. (I suppose that it is a simple
> >> wrapper around docb_gen Erlang module and could be recreated, but It'd
> >> be better if it were shipped in Erlang sources.)
> >>
> >> Is Erlang documentation supposed to be buildable from the source, or
> >> it still requires some unavailable tools?
> >>
> >> Cheers!
> >
> >
> 
> 
> 
> ________________________________________________________________
> erlang-bugs mailing list. See http://www.erlang.org/faq.html
> erlang-bugs (at) erlang.org