= Welcome to the Developers PostGIS Wiki! =
[[Image(wiki:WikiStart:OSGeo_project.png)]]

Everybody is welcome to contribute to this wiki. This wiki is designed for individuals
who want to contribute to PostGIS by developing patches or testing out changes.

There will be some sections that are of equal value to both PostGIS users and Developers such as compiling 
source etc.  Feel free to contribute to this and make any corrections you see fit.

 * You must login to create new pages and modify existing ones. You can create your own [https://www.osgeo.org/cgi-bin/ldap_create_user.py OSGEO Userid] or use your existing one or you can use the generic one (login:wiki;password:wiki).
 * Please prefix every new page names in this section with "!DevWiki" in order to easily distinguish them from other Wiki Trac pages.
 * For a quick overview of how to format page's content [wiki:WikiFormatting see this page].

== Useful Links ==
 * [wiki:DevWikiComitGuidelines Committer Guidelines] 
 * [wiki:DevWikiRFC PostGIS RFCs for Past and Future Change Proposals]

== PostGIS Subversion Work Branches ==
 * PostGIS SVN trunk -- [http://svn.osgeo.org/postgis/trunk] (this is where latest unstable work happens (currently PostGIS 2.0))
 * PostGIS SVN current stable branch -- [http://svn.osgeo.org/postgis/branches/1.5]
 * PostGIS SVN Raster  -- [http://svn.osgeo.org/postgis/trunk/raster]

== Doxygen Autogenerated Developer Documentation ==
 * [http://www.postgis.org/documentation/postgis-doxygen/ PostGIS Doxygen Documentation including Raster introduced in PostGIS 2.0]
 * [http://www.postgis.org/documentation/raster-doxygen/ (WKT Raster obsolete stand-alone branch) Doxygen Documentation]

== Other stuff ==
 * [http://svn.osgeo.org/postgis/trunk/STYLE PostGIS coding Style Guide]
 * [http://subversion.tigris.org/ Subversion clients] for Windows users Tortoise is probably the easiest to use
 * [wiki:DevWikiEmptyGeometry Semantics of EMPTY geometries]
 * [wiki:NewDistCalc Description of new distance calculation]
 * [wiki:DevWikiAffineParameters How to calculate parameters for affine transformation]
 * [wiki:DevelopmentDiscussion Topics for discussion on PostGIS 2.0]
 * [wiki:LWGeomUpdate LWGEOM updates on PostGIS 2.0]
 * [wiki:DevWikiISO19125 Comments/Questions related to ISO19125]
 * [wiki:DevWikiPostGISCoding Notes on memory management and code structures in PostGIS]
 * [wiki:DevWikiProvenanceReview Code Provenance Review]

== Compilation and Installation Guides ==
 * [wiki:UsersWikiPostgreSQLPostGIS PostgreSQL/PostGIS version support matrix]
 * Directions for [wiki:UsersWikiPostgisRpmInstallation PostGIS RPM Installation].
 * Directions for [wiki:UsersWikiPostgisOnUbuntu PostGIS on Ubuntu].
 * Directions for [wiki:UsersWikiWinCompile Compiling in Windows].
 * [http://symbiatch.jutut.fi/article/2955 Sami's PostgreSQL 9.0 64-bit PostGIS 1.5.2 64-bit compiled under VC++] with some comments about gotchas to change.
 * [wiki:UsersWikiWinCompileInitdb Initializing PostgreSQL Data Cluster for testing]
 * Directions for [wiki:DevWikiWinNSIS Creating PostGIS setup.exe for Windows using NSIS].
 * [wiki:UsersWikiMakeCheckConsiderations Make Check Gotchas].

== Debugging Guides ==
 * Directions for [wiki:DevWikiGettingABackTrace getting a backtrace] if your query crashes PostGIS.

== Patch Submission Guidelines ==
General model Major.Minor.Micro (1.3.6, 1.4.0,1.5.0SVN)

As of PostGIS 1.4 -- we will no longer be releasing additional functions to micro releases. 

Micro releases will be focused primarily on bug fixes and secondly speed enhancements to existing functions.

PostGIS 1.3 and below will be critical bug and security fixes. 

This means that only currently documented functions for PostGIS 1.4.0 are all you will see in 1.4.1

New functions submitted will have to go into the next minor release which is currently (PostGIS 2.0). 

New functions/features that require on disk structural changes will go into next major release (PostGIS 2.0)
 * [wiki:DevWikiPGRegress Preparing PostgreSQL Specific Regress Tests]
 * [wiki:DevWikiCUnit Preparing CUnit Tests]
 * [wiki:DevWikiDocNewFeature Preparing Documentation Patches for new features]
 * [wiki:DevWikiPatch Preparing code and other patches]

== Additional Testing ==
 * [wiki:DevWikiGardenTest Building and Running Garden (Torture) Tests]