Re: making docs ?

hubert depesz lubaczewski writes:

> hi
> i have postgresql from cvs. updated last on 15th february 2001.
> i use :
> openjade-1.4
> opensp-1.4
> sgml-common-0.2

What stylesheet version?

> when i tried to build src docs (cd doc/src; make) i got several hundred
> error-lines which looked like:
> jade:E: flow objects at the root must be all of class scroll or all of class
> page-sequence or simple-page-sequence

What format did you/it try to create?

> at the end of output of make i got:
> make[1]: *** [admin.html] B³±d 1
> make[1]: Opuszczam katalog `/home/depesz/various/downloaded.by.cvs/pgsql.test/doc/src/sgml'
> make: *** [admin.tar] B³±d 2

Translation? ;-)

> anybody knows what is the problem and what should i use to build it?

Go into doc/src/sgml, run 'make check'.  That verifies that the jade
package and the docbook dtd is installed correctly.  Then try make
postgres.html/user.html/admin.html/etc.  Those are exercised heavily and
should work.  I think you were trying to build a print format, but a quick
check didn't reveal any problems here.

--
Peter Eisentraut      peter_e@gmx.net       http://yi.org/peter-e/