2009-07-03 04:56:08 +00:00
|
|
|
====================================================
|
2006-05-10 13:40:20 +00:00
|
|
|
Overview
|
2009-07-03 04:56:08 +00:00
|
|
|
====================================================
|
2006-05-10 13:40:20 +00:00
|
|
|
|
2009-07-03 04:56:08 +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 convert to chunked html, single-file html and pdf.
|
|
|
|
|
|
|
|
Make targets are:
|
|
|
|
|
|
|
|
make # defaults to creating
|
|
|
|
# - the images used in the generated documentation
|
|
|
|
# - the documentation as a single html file
|
|
|
|
# - a sql script used to apply COMMENTS for every postgis function
|
|
|
|
|
|
|
|
make html/postgis.html # generates a single-file html file called 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 a sql script that add COMMENTs for every function (derived from the documentation)
|
|
|
|
make doxygen # generates the developer's documentation using Doxygen
|
|
|
|
|
|
|
|
make install # copies PostGIS' utility (ie. shp2pgsql) man pages to the PostgreSQL's doc directory
|
|
|
|
make uninstall # removes PostGIS' utility man pages
|
|
|
|
make comments-install # copies the postgis-comments.sql script to the PostgreSQL's contrib directory
|
|
|
|
make comments-uninstall # removes the postgis-comments.sql script from the contrib directory
|
|
|
|
|
|
|
|
make clean # removes any generated files (except images and html files)
|
|
|
|
make maintainer-clean # clears out the generated images and html files
|
2006-05-10 13:40:20 +00:00
|
|
|
|
|
|
|
|
2006-05-17 13:04:20 +00:00
|
|
|
====================================================
|
2009-07-03 04:56:08 +00:00
|
|
|
Requirements
|
2006-05-17 13:04:20 +00:00
|
|
|
====================================================
|
|
|
|
|
2009-07-03 04:56:08 +00:00
|
|
|
To generate the html files:
|
|
|
|
xsltproc (http://xmlsoft.org/XSLT/xsltproc2.html)
|
|
|
|
DocBook XSL scripts
|
2006-05-17 13:04:20 +00:00
|
|
|
|
2009-07-03 04:56:08 +00:00
|
|
|
To generate the images:
|
|
|
|
ImageMagick (http://www.imagemagick.org/script/index.php)
|
2006-05-17 13:04:20 +00:00
|
|
|
|
2009-07-03 04:56:08 +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:
|
|
|
|
doxygen (http://www.stack.nl/~dimitri/doxygen)
|
2006-05-10 13:40:20 +00:00
|
|
|
|
|
|
|
|
2009-08-28 15:16:50 +00:00
|
|
|
====================================================
|
|
|
|
How To
|
|
|
|
====================================================
|
2006-05-17 13:04:20 +00:00
|
|
|
|
2009-08-28 15:16:50 +00:00
|
|
|
To generate images used in the documentation, follow these instructions on the PostGIS wiki:
|
|
|
|
http://trac.osgeo.org/postgis/wiki/DevWikiDocNewFeature
|
2009-10-08 11:43:32 +00:00
|
|
|
|
|
|
|
To run garden tests against functions, follow these instructions on the PostGIS dev wiki:
|
|
|
|
http://trac.osgeo.org/postgis/wiki/DevWikiGardenTest
|