source: trunk/HOWTO_RELEASE @ 9043

Last change on this file since 9043 was 9043, checked in by pramsey, 5 years ago

Change how we calculate minor versions suitable for extension upgrade.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.0 KB
Line 
1How to release
2~~~~~~~~~~~~~~
3  Date: 2009-07-01
4
5Versioning Scheme
6-----------------
7
8Release version is composed by POSTGIS_MAJOR_VERSION, POSTGIS_MINOR_VERSION
9and POSTGIS_MICRO_VERSION components.
10
11By default only [POSTGIS_MICRO_VERSION] increments between releases.
12
13[POSTGIS_MINOR_VERSION] is incremented (and MICRO set to 0) when minor
14additions have been introduced (one or two functions can be considered
15*micro* additions)
16
17[POSTGIS_MAJOR_VERSION] is incremented (and MICRO and MINOR set to 0) when
18a dump/reload of existing spatial databases is *REQUIRED* for things
19to work or rather *HIGHLY RECOMMENDED* to get new functionalities.
20
21Requirements
22------------
23
24In order to build a release, you will need to build PostGIS and the
25documentation -- that means having the required software:
26
27* For PostGIS:
28  - PostgreSQL
29  - GEOS
30  - Proj4
31* For the docs:
32  - xsltproc
33  - DocBook XSL scripts
34  - ImageMagick
35
36Release procedure
37-----------------
38
391) Re-generate the ChangeLog using svn2cl.
402) Edit NEWS: set release date and check all notable changes have
41   been reported (extract from ChangeLog).
423) Edit README.postgis and set release date and version.
434) Add release notes in doc/release_notes.xml
445) Commit all your changes
456) Tag trunk: 
46   svn copy http://svn.osgeo.org/postgis/trunk http://svn.osgeo.org/postgis/tags/x.x.x
477) Checkout tag:
48   svn checkout http://svn.osgeo.org/postgis/tags/x.x.x
498) Update Version.config as specified in Versioning Scheme above.
508a) Ensure all the previous minor versions are listed in extension/upgradeable_versions.mk
519) Commit your version number change to the tag.
5210) Run: sh make_dist.sh x.x.x
5311) Copy tarball to web site and edit downloads page
5412) Announce on e-mail
55    - postgis-users
56    - postgis-devel
57    - pgsql-announce
58    - osgeo-discuss
5913) Update web sites
60    - PostGIS News
61    - PostGIS doc release versioned doc - http://www.postgis.org/documentation/
62     (or remind Chris Hodgson)
63    - Freshmeat
64    - Wikipedia
6514) Update Trac and make old Milestone as completed
66
67
Note: See TracBrowser for help on using the repository browser.