Re: [HACKERS] Revised nonblocking patches + quasi docs

> > > I've actually been trying to work on the sgml and failing miserably,
> > > I have no clue how this stuff works (sgml compilation) are you asking
> > > for a couple of paragraphs that describe the proposed changes?
> > > If so I hope this suffices, if not some help on building the sgml
> > > would be much appreciated:
> 'course I run freebsd. :)  I even have the docproj port installed,
> however it seems that there's some things missing here, (see the
> end of this message).
> Perhaps someone can offer a step-by-step to building _postgresql's_
> doc files, or maybe there's a machine out there where this will
> build properly and someone can give me an account on it?

You are probably very near having something working. The Postgres docs
have an appendix on "Documentation", which contains some information
on getting jade built and running. The makefile in doc/src/sgml has
comments which indicate what probably needs to be changed, and how to
do it (the parameters are set so the stuff builds on postgresql.org,
but I have a couple of lines in my Makefile.custom to get things to
work at home).

In particular, the .dsl files are somewhere in your jade installation
tree (it is in /usr/lib/sgml/stylesheets/nwalsh-modular/{print,html}
on my Linux box).

Ask more specific questions and we'll help you through it, but only
after you get some sleep :)

I'm out of town through the weekend, but will be on-list Monday night
afaik.
                   - Thomas

> ~/pgcvs/pgsql/doc/src % gmake
> gmake all
> gmake[1]: Entering directory `/home/bright/pgcvs/pgsql/doc/src'
> gmake -C sgml clean
> gmake[2]: Entering directory `/home/bright/pgcvs/pgsql/doc/src/sgml'
> (rm -rf HTML.manifest *.html *.htm *.1 *.l man1 manl manpage*)
> gmake[2]: Leaving directory `/home/bright/pgcvs/pgsql/doc/src/sgml'
> gmake -C sgml admin.html
> gmake[2]: Entering directory `/home/bright/pgcvs/pgsql/doc/src/sgml'
> (rm -rf *.htm)
> jade -D ref -D ../graphics -V %use-id-as-filename% -d /home/users/t/thomas/db118.d/docbook/html/docbook.dsl -t sgml
admin.sgml
> 
>    ^^^^^^^^^^^^---- huh?
>    ~/pgcvs/pgsql/doc % find . -name "*.dsl"
>    ~/pgcvs/pgsql/doc %
> 
>    continues...


-- 
Thomas Lockhart                lockhart@alumni.caltech.edu
South Pasadena, California