2005-12-16 09:32:53 +00:00
|
|
|
How to release
|
|
|
|
~~~~~~~~~~~~~~
|
2015-10-08 11:38:25 +00:00
|
|
|
Date: 2015-10-08
|
2005-12-16 09:32:53 +00:00
|
|
|
|
|
|
|
Versioning Scheme
|
|
|
|
-----------------
|
|
|
|
|
2015-10-08 11:38:25 +00:00
|
|
|
*PostGIS*
|
|
|
|
|
|
|
|
PostGIS release version is composed by POSTGIS_MAJOR_VERSION,
|
|
|
|
POSTGIS_MINOR_VERSION and POSTGIS_MICRO_VERSION components, all
|
|
|
|
set in Version.config.
|
2005-12-16 09:32:53 +00:00
|
|
|
|
2008-05-14 17:10:19 +00:00
|
|
|
By default only [POSTGIS_MICRO_VERSION] increments between releases.
|
2015-10-08 11:38:25 +00:00
|
|
|
Starting at PostGIS 2.1 in development POSTGIS_MICRO_VERSION should have
|
|
|
|
a "dev" string at the end
|
2005-12-16 09:32:53 +00:00
|
|
|
|
2008-05-14 17:10:19 +00:00
|
|
|
[POSTGIS_MINOR_VERSION] is incremented (and MICRO set to 0) when minor
|
2005-12-16 09:32:53 +00:00
|
|
|
additions have been introduced (one or two functions can be considered
|
|
|
|
*micro* additions)
|
|
|
|
|
2008-05-14 17:10:19 +00:00
|
|
|
[POSTGIS_MAJOR_VERSION] is incremented (and MICRO and MINOR set to 0) when
|
2005-12-16 09:32:53 +00:00
|
|
|
a dump/reload of existing spatial databases is *REQUIRED* for things
|
|
|
|
to work or rather *HIGHLY RECOMMENDED* to get new functionalities.
|
|
|
|
|
2014-05-14 08:43:40 +00:00
|
|
|
All POSTGIS_MICRO_VERSION that are in branch or trunk should end in dev.
|
|
|
|
So for example if you just release 2.1.1, then the 2.1 branch should have
|
|
|
|
POSTGIS_MICRO_VERSION set to 2dev so that the full version is 2.1.2dev.
|
|
|
|
|
2015-10-08 11:38:25 +00:00
|
|
|
*Liblwgeom*
|
|
|
|
|
|
|
|
Liblwgeom versioning is composed by by LIBLWGEOM_IFACE_CUR,
|
|
|
|
LIBLWGEOM_IFACE_AGE and LIBLWGEOM_IFACE_REV; all set and documented
|
|
|
|
in Version.config.
|
|
|
|
|
|
|
|
The liblwgeom versioning represents compatibility of the library
|
|
|
|
within a PostGIS minor version.
|
|
|
|
|
2009-07-02 16:00:11 +00:00
|
|
|
Requirements
|
|
|
|
------------
|
|
|
|
|
2009-07-02 16:31:51 +00:00
|
|
|
In order to build a release, you will need to build PostGIS and the
|
|
|
|
documentation -- that means having the required software:
|
|
|
|
|
|
|
|
* For PostGIS:
|
|
|
|
- PostgreSQL
|
|
|
|
- GEOS
|
|
|
|
- Proj4
|
2013-11-16 22:35:10 +00:00
|
|
|
- GDAL (for raster)
|
|
|
|
- json-c (for GeoJSON load support)
|
2009-07-02 16:31:51 +00:00
|
|
|
* For the docs:
|
|
|
|
- xsltproc
|
|
|
|
- DocBook XSL scripts
|
2013-11-16 22:35:10 +00:00
|
|
|
- ImageMagic
|
|
|
|
- DbLatex (for PDF)
|
2009-07-02 16:00:11 +00:00
|
|
|
|
2005-12-16 09:32:53 +00:00
|
|
|
Release procedure
|
|
|
|
-----------------
|
|
|
|
|
2014-05-14 09:09:40 +00:00
|
|
|
- Re-generate the ChangeLog (make ChangeLog)
|
|
|
|
- Edit NEWS: set release date and check all notable changes have
|
|
|
|
been reported (extract from ChangeLog).
|
|
|
|
- Edit README.postgis and set release date and version.
|
|
|
|
- Add release notes in doc/release_notes.xml
|
|
|
|
- Update Version.config to drop the "dev" suffix
|
|
|
|
- Commit all changes
|
|
|
|
- Tag branch:
|
2014-05-14 08:43:40 +00:00
|
|
|
$ base=http://svn.osgeo.org/postgis/
|
|
|
|
$ rev=x.x.0
|
|
|
|
$ svn copy -m "Tagged release $rev" $base/trunk $base/tags/$rev
|
2014-05-14 09:09:40 +00:00
|
|
|
- Run: sh make_dist.sh $rev (or use debbie for this)
|
|
|
|
- Build and test generated tarball (including extension upgrade)
|
|
|
|
- Copy tarball to web site and edit downloads page
|
|
|
|
- Announce on e-mail
|
2009-06-15 17:48:27 +00:00
|
|
|
- postgis-users
|
|
|
|
- postgis-devel
|
|
|
|
- pgsql-announce
|
|
|
|
- osgeo-discuss
|
2014-05-14 09:09:40 +00:00
|
|
|
- Update web sites
|
2013-11-16 22:35:10 +00:00
|
|
|
- PostGIS News
|
2015-10-07 19:15:38 +00:00
|
|
|
- https://svn.osgeo.org/postgis/web/_content/posts
|
2013-01-16 09:16:35 +00:00
|
|
|
a) create a new Post for current year making sure the page name starts with mm-dd
|
2013-09-08 15:08:45 +00:00
|
|
|
b) Update links on https://svn.osgeo.org/postgis/web/_content/pages/source.html
|
|
|
|
c) commit and wait 5 minutes to see changes on website
|
2013-01-16 09:16:35 +00:00
|
|
|
- PostGIS doc release versioned doc - http://postgis.net/documentation/
|
|
|
|
(For building pdf, debbie has tagged jobs
|
|
|
|
-- http://debbie.postgis.net:8080 (log in)
|
2013-11-16 22:35:10 +00:00
|
|
|
Create new job copy last tag e.g. PostGIS_2.0_tagged_docs to PostGIS_2.1_tagged_docs
|
2013-01-16 09:16:35 +00:00
|
|
|
and make appropriate edits and then just run.
|
2013-11-16 22:35:10 +00:00
|
|
|
Or just be lazy and bug Regina Obe do this.
|
2009-06-15 17:48:27 +00:00
|
|
|
- Wikipedia
|
2013-01-16 09:16:35 +00:00
|
|
|
- Twitter (we all love twitter don't we)
|
2014-05-14 09:09:40 +00:00
|
|
|
- Update Trac and make old Milestone as completed
|
|
|
|
- Push the revision number forward (see Versioning Scheme)
|
|
|
|
- Ensure all the previous released minor versions are listed in
|
|
|
|
extension/upgradeable_versions.mk including the one you just released
|
2012-02-08 17:36:41 +00:00
|
|
|
|
2007-08-13 16:12:57 +00:00
|
|
|
|