2012-03-27 09:56:17 +00:00
|
|
|
PostGIS Documentation
|
|
|
|
=====================
|
|
|
|
|
2006-05-10 13:40:20 +00:00
|
|
|
Overview
|
2012-03-27 09:56:17 +00:00
|
|
|
--------
|
|
|
|
|
|
|
|
PostGIS documentation is written in DocBook XML. The input file is
|
|
|
|
``postgis.xml``, which in turn includes all the individual chapter XML files.
|
|
|
|
From that file we can publish several formats, including HTML and PDF.
|
|
|
|
|
|
|
|
Make targets
|
|
|
|
------------
|
|
|
|
|
|
|
|
``make``
|
|
|
|
same as ``make comments``
|
|
|
|
|
|
|
|
``make install``
|
|
|
|
same as ``make comments-install``
|
|
|
|
|
|
|
|
``make uninstall``
|
|
|
|
same as ``make comments-uninstall``
|
|
|
|
|
|
|
|
``make html``
|
|
|
|
generates a single-file ``html/postgis.html``
|
|
|
|
|
|
|
|
``make chunked-html``
|
|
|
|
generates a separate html file for every chapter or section break
|
|
|
|
|
|
|
|
``make pdf``
|
|
|
|
generates a single PDF file with the PostGIS version as a filename
|
|
|
|
|
|
|
|
``make images``
|
|
|
|
generates all the images used in the HTML and PDF targets
|
|
|
|
|
|
|
|
``make comments``
|
|
|
|
generates an SQL script that add COMMENTs for every function (derived from
|
|
|
|
the documentation)
|
|
|
|
|
|
|
|
``make doxygen``
|
|
|
|
generates the developer's documentation using Doxygen
|
2006-05-10 13:40:20 +00:00
|
|
|
|
2012-03-27 09:56:17 +00:00
|
|
|
``make comments-install``
|
|
|
|
copies the ``postgis-comments.sql`` script to the PostgreSQL ``contrib``
|
|
|
|
directory
|
2009-07-03 04:56:08 +00:00
|
|
|
|
2012-03-27 09:56:17 +00:00
|
|
|
``make comments-uninstall``
|
|
|
|
removes the ``postgis-comments.sql`` script from the ``contrib`` directory
|
2009-07-03 04:56:08 +00:00
|
|
|
|
2012-03-27 09:56:17 +00:00
|
|
|
``make clean``
|
|
|
|
removes generated files except comments
|
2012-03-06 09:45:47 +00:00
|
|
|
|
2012-03-27 09:56:17 +00:00
|
|
|
``make maintainer-clean``
|
|
|
|
removes all generated files (including comments)
|
2006-05-10 13:40:20 +00:00
|
|
|
|
|
|
|
|
2009-07-03 04:56:08 +00:00
|
|
|
Requirements
|
2012-03-27 09:56:17 +00:00
|
|
|
------------
|
2006-05-17 13:04:20 +00:00
|
|
|
|
2012-03-01 15:51:43 +00:00
|
|
|
To generate the html files and the comments:
|
2012-03-27 09:56:17 +00:00
|
|
|
* xsltproc - http://xmlsoft.org/xslt/xsltproc2.html
|
|
|
|
* DocBook XSL stylesheets
|
|
|
|
* MathML 3 DTD - http://www.w3.org/Math/DTD/
|
2012-03-01 15:51:35 +00:00
|
|
|
|
2009-07-03 04:56:08 +00:00
|
|
|
To generate the images:
|
2012-03-27 09:56:17 +00:00
|
|
|
* ImageMagick - http://www.imagemagick.org/
|
2006-05-17 13:04:20 +00:00
|
|
|
|
2012-03-27 09:56:17 +00:00
|
|
|
To generate a PDF:
|
|
|
|
* dblatex - http://dblatex.sourceforge.net
|
2006-05-10 13:40:20 +00:00
|
|
|
|
2009-07-03 04:56:08 +00:00
|
|
|
To generate the developer's documentation:
|
2012-03-27 09:56:17 +00:00
|
|
|
* Doxygen - http://www.stack.nl/~dimitri/doxygen/
|
|
|
|
* Graphviz - http://www.graphviz.org/
|
2006-05-10 13:40:20 +00:00
|
|
|
|
2012-03-27 09:56:17 +00:00
|
|
|
How to
|
|
|
|
------
|
2006-05-10 13:40:20 +00:00
|
|
|
|
2012-03-27 09:56:17 +00:00
|
|
|
To generate images used in the documentation, follow these instructions on the
|
|
|
|
PostGIS wiki: http://trac.osgeo.org/postgis/wiki/DevWikiDocNewFeature
|
2006-05-17 13:04:20 +00:00
|
|
|
|
2012-03-27 09:56:17 +00:00
|
|
|
To run garden tests against functions, follow these instructions on the PostGIS
|
|
|
|
dev wiki: http://trac.osgeo.org/postgis/wiki/DevWikiGardenTest
|