diff options
| -rw-r--r-- | HOWTO-RELEASE | 25 | ||||
| -rw-r--r-- | docs/source/conf.py | 37 | ||||
| -rwxr-xr-x | scripts/update_man.sh | 7 |
3 files changed, 58 insertions, 11 deletions
diff --git a/HOWTO-RELEASE b/HOWTO-RELEASE index d862c8ab..3053523b 100644 --- a/HOWTO-RELEASE +++ b/HOWTO-RELEASE @@ -34,38 +34,45 @@ 4.5) Run "autogen.sh" (hopefully on the same machine it was last run on) -5) Add a note to the ChangeLog that a new release is being issued, and what +5) Update man pages: + + ./scripts/update_man.sh + + The script builds man pages from Sphinx docs, copies them to man/ and commits + them to git. + +6) Add a note to the ChangeLog that a new release is being issued, and what the release number is. -6) Update NEWS file with summary of release changes. +7) Update NEWS file with summary of release changes. -7) Update the proj.spec file for the new version: +8) Update the proj.spec file for the new version: - PACKAGE_VERSION - Source0 - %setup line - rm -rf line -8) If this is a major release, prepare a branch. +9) If this is a major release, prepare a branch. git checkout -b 5.0 -9) Tag the release +10) Tag the release git tag 5.0.0 -10) Do a "make dist-all" in the proj root directory. After some grinding +11) Do a "make dist-all" in the proj root directory. After some grinding this should result in files like proj-4.4.3.tar.gz and proj-4.4.3.zip being created. These are full source distributions. -11) Put these in the proj ftp area on /osgeo/download/proj on +12) Put these in the proj ftp area on /osgeo/download/proj on download.osgeo.org. This can be done via scp using a command like the following. scp proj-4.4.3.{tar.gz,zip} warmerdam@download.osgeo.org:/osgeo/download/proj -12) Announce the new release on the PROJ.4 and MetaCRS mailing lists. +13) Announce the new release on the PROJ.4 and MetaCRS mailing lists. -13) Issue a new release report on GitHub: +14) Issue a new release report on GitHub: https://github.com/OSGeo/proj.4/releases/new diff --git a/docs/source/conf.py b/docs/source/conf.py index af9d24da..a269a7d9 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -268,8 +268,41 @@ latex_documents = [ # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ - (master_doc, 'proj4', u'PROJ.4 Documentation', - [author], 1) + ( + 'apps/proj', + 'proj', + u'Cartographic projection filter', + ['Gerald I. Evenden'], + 1 + ), + ( + 'apps/cs2cs', + 'cs2cs', + u'Cartographic coordinate system filter', + ['Frank Warmerdam'], + 1 + ), + ( + 'apps/cct', + 'cct', + u'Coordinate Conversion and Transformation', + ['Thomas Knudsen'], + 1 + ), + ( + 'apps/geod', + 'geod', + u'Geodesic computations', + ['Charles Karney'], + 1 + ), + ( + 'apps/gie', + 'gie', + u'The Geospatial Integrity Investigation Environment', + ['Thomas Knudsen'], + 1 + ), ] # If true, show URL addresses after external links. diff --git a/scripts/update_man.sh b/scripts/update_man.sh new file mode 100755 index 00000000..1a67f535 --- /dev/null +++ b/scripts/update_man.sh @@ -0,0 +1,7 @@ +# run from root of repo +cd docs +make man +cd .. +cp -r docs/build/man/*.1 man/man1 +git add man/man1/*.1 +git commit -m "Update man-pages from Sphinx-docs" |