...

или внеочередные заметки


Previous Entry Share Next Entry
Build postgres documentation with brew
trekking, Himalaya
obartunov
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
Tags: ,

?

Log in

No account? Create an account