| 1 |
Notes on Preparing a GDAL Source Release |
|---|
| 2 |
======================================== |
|---|
| 3 |
|
|---|
| 4 |
1) Regenerate configure using autogen.sh and commit if changed. There |
|---|
| 5 |
is often a reference system on which this should be done (ie. Frank's |
|---|
| 6 |
dev workstation) to avoid unnecessary churn from different autoconf |
|---|
| 7 |
versions. |
|---|
| 8 |
|
|---|
| 9 |
2) Update the release date, and number information in gcore/gdal_version.h. |
|---|
| 10 |
|
|---|
| 11 |
3) Update the VERSION file. Update ./swig/python/setup.py version information. |
|---|
| 12 |
|
|---|
| 13 |
4) Update LIBGDAL_CURRENT/REVISION/AGE macros in GDALmake.opt.in. |
|---|
| 14 |
- For a release with no interface changes just bump REVISION. |
|---|
| 15 |
- Adding interfaces, bump CURRENT/AGE, set REVISION to 0. |
|---|
| 16 |
- Deleting interfaces / compatibility issues - bump CURRENT, others to zero. |
|---|
| 17 |
|
|---|
| 18 |
5) Prepare release overview in the NEWS file. The Trac revision log for |
|---|
| 19 |
trunk or the stable branch can be helpful. |
|---|
| 20 |
|
|---|
| 21 |
http://trac.osgeo.org/gdal/log/branches/1.4 |
|---|
| 22 |
|
|---|
| 23 |
6) Update the GDAL http://trac.osgeo.org/gdal/wiki/DownloadSource topic to |
|---|
| 24 |
refer to the latest available source. |
|---|
| 25 |
|
|---|
| 26 |
7) If this is a major release, prepare a branch. |
|---|
| 27 |
|
|---|
| 28 |
svn copy https://svn.osgeo.org/gdal/trunk \ |
|---|
| 29 |
https://svn.osgeo.org/gdal/branches/1.5 |
|---|
| 30 |
|
|---|
| 31 |
8) Tag the release set in CVS: |
|---|
| 32 |
|
|---|
| 33 |
svn copy https://svn.osgeo.org/gdal/branches/1.4 \ |
|---|
| 34 |
https://svn.osgeo.org/gdal/tags/1.4.1 |
|---|
| 35 |
|
|---|
| 36 |
9) Create the source distributions using the mkgdaldist.sh script. The |
|---|
| 37 |
argument should be the version number (ie. 1.4.1). |
|---|
| 38 |
|
|---|
| 39 |
eg. |
|---|
| 40 |
% mkgdaldist.sh 1.4.1 |
|---|
| 41 |
|
|---|
| 42 |
10) Create a snapshot of the documentation. |
|---|
| 43 |
|
|---|
| 44 |
ie. On www.gdal.org: |
|---|
| 45 |
% cd /osgeo/gdal |
|---|
| 46 |
% ./gdalhtmlupdate.sh |
|---|
| 47 |
% zip -r /osgeo/download/gdal/gdal150doc.zip gdal-web/*.* gdal-web/ogr |
|---|
| 48 |
|
|---|
| 49 |
11) Create a snapshot of gdalautotest (make sure it doesn't include .svn's) |
|---|
| 50 |
|
|---|
| 51 |
12) Publish the resulting files in download.osgeo.org/gdal. |
|---|
| 52 |
|
|---|
| 53 |
13) Announce release to the gdal-dev@lists.maptools.org, |
|---|
| 54 |
gdal-announce@lists.osgeo.org, freegis@freegis.org and news_item@osgeo.org. |
|---|
| 55 |
|
|---|
| 56 |
14) Update the freshmeat.net entry for GDAL. |
|---|
| 57 |
|
|---|
| 58 |
15) Update the freegis.org entry for GDAL. |
|---|
| 59 |
|
|---|
