Thread: Building documentation in PostgreSQL 7.2devel
The build instructions in the INSTALL documentation does not lead to the documentation (HTML or man pages) being built. Here are all the directories I have having followed the instructions: [pgtest@possum pgtest]$ ls postgresql total 24 drwxrwxr-x 6 pgtest pgtest 4096 Sep 3 16:50 . drwx------ 9 pgtest pgtest 4096 Sep 3 16:50 .. drwxrwxr-x 2 pgtest pgtest 4096 Sep 3 16:51 bin drwxrwxr-x 5 pgtest pgtest 4096 Sep 3 16:50 include drwxrwxr-x 2 pgtest pgtest 4096 Sep 3 16:51 lib drwxrwxr-x 5 pgtest pgtest 4096 Sep 3 16:50 pgsql [pgtest@possum pgtest]$
John Summerfield writes: > The build instructions in the INSTALL documentation does not lead to the > documentation (HTML or man pages) being built. It's not supposed to. The documentation is built separately and copied into the tree before a release tarball is made. Historically, the documentation build tools were very hard to manage, so we did not want to have them in the critical path. This may change as time goes on. The HTML documentation is in fact being built regularly on our development server (postgresql.org) and copied to the web and ftp sites: http://www.ca.postgresql.org/devel-corner/docs/postgres/index.html ftp://ftp.de.postgresql.org/pub/dev/doc/ The man pages are only built rarely because it used to require manual intervention. (The man.tar.gz file on the ftp site was built by yours truly before the 7.1 release.) Again, this may change as the tools mature. -- Peter Eisentraut peter_e@gmx.net http://funkturm.homeip.net/~peter