PostgreSQL documentation is in DocBook format. In my experience, this is far from trivial to get working on any platform where it isn't installed by the default packages - and even worse if it's installed by default but in the wrong version.

Turns out on Windows it's both better and worse - it's definitly harder than a pre-installed system, but a lot easier than one with the wrong version installed. Here are some step-by-step instructions for how to do it in a way that uses only pre-made binary packages of the required tools. It's a manual build not integrated with the pg Makefile, but it's a start...

First of all, decide on a root for the docbook installation. In my case, I chose f:\docbook. Download and uncompress the following files:

ActiveState Perl, installed anywhere and present in the PATH

OpenJade 1.3.1-2 binaries, uncompress to f:\docbook\openjade-1.3.1.

DocBook DTD 4.2, uncompress to f:\docbook\docbook.

DocBook DSSSL 1.79, uncompress to f:\docbook\docbook-dsssl-1.79.

ISO character entities, uncompress to f:\docbook\docbook.

With this done, some files in the docbook directory need renaming. Create a .bat file named r.bat (or whatever, really) in the docbook\docbook directory that looks like this:

@echo off
for %%f in (ISO*) do (
set foo=%%f
ren !foo! !foo:~0,3!-!foo:~3!.gml
)

And execute this file using:

cmd /v /c r.bat

That done, step into your PostgreSQL installation tree in doc\src\sgml. Run the following commands (beware of linebreaks!):

To prevent automated Bots from commentspamming, please enter the string you see in the image below in the appropriate input box. Your comment will only be submitted if the strings match. Please ensure that your browser supports and accepts cookies, or your comment cannot be verified correctly.