Build postgres documentation with brew
Official documentation how to build postgres documentation requires a set of tools, which should be installed. Some years ago I tested this way under Linux and it worked to me, but now I use Mac OS X and brew and the whole process could be done much easier.
To build postgres documentation with brew I used:
1. From
https://github.com/petere/homebrew-sgml
brew tap petere/sgml
brew install docbook docbook-dsssl docbook-sgml docbook-xsl openjade
export SGML_CATALOG_FILES=/usr/local/etc/sgml/catalog
2. I use separate account "postgres", so I need to add it to admin group to have access to sgml files (it's possible, that it's my fault and you don't need this step).
dseditgroup -o edit -a postgres -t user admin
3. run configure script (I use this parameters for my development and testing) in postgres sources directory.
4. Now "make docs" will produce html and man pages.
5. For pdf documentation install mactex:
brew install brew-cask - optional, if you didn't install brew cask
brew cask install mactex
cd docs/src/sgml directory
make postgres-A4.pdf
To build postgres documentation with brew I used:
1. From
https://github.com/petere/homebrew-sgml
brew tap petere/sgml
brew install docbook docbook-dsssl docbook-sgml docbook-xsl openjade
export SGML_CATALOG_FILES=/usr/local/etc/sgml/catalog
2. I use separate account "postgres", so I need to add it to admin group to have access to sgml files (it's possible, that it's my fault and you don't need this step).
dseditgroup -o edit -a postgres -t user admin
3. run configure script (I use this parameters for my development and testing) in postgres sources directory.
4. Now "make docs" will produce html and man pages.
5. For pdf documentation install mactex:
brew install brew-cask - optional, if you didn't install brew cask
brew cask install mactex
cd docs/src/sgml directory
make postgres-A4.pdf