src/3rdparty/libtiff/HOWTO-RELEASE
changeset 30 5dc02b23752f
parent 0 1918ee327afb
--- a/src/3rdparty/libtiff/HOWTO-RELEASE	Wed Jun 23 19:07:03 2010 +0300
+++ b/src/3rdparty/libtiff/HOWTO-RELEASE	Tue Jul 06 15:10:48 2010 +0300
@@ -1,57 +1,105 @@
 HOWTO-RELEASE: 
 
-Notes on releasing. You will need appropriate autoconf, automake and libtool
-utilities to release a package.
+Notes on releasing.
+
+0. Make sure that you have current FSF releases of autoconf, automake,
+   and libtool packages installed under a common installation prefix
+   and that these tools are in your executable search path prior to
+   any other installed versions.  Versions delivered with Linux may be
+   altered so it is best to install official FSF releases. GNU 'm4'
+   1.4.6 or later is needed in order to avoid bugs in m4. These
+   packages may be downloaded from the following ftp locations:
+
+     autoconf - ftp://ftp.gnu.org/pub/gnu/autoconf
+     automake - ftp://ftp.gnu.org/pub/gnu/automake
+     libtool  - ftp://ftp.gnu.org/pub/gnu/libtool
+
+   Release builds should only be done on a system with a functioning
+   and correctly set system clock and on a filesystem which accurately
+   records file update times.  Use of GNU make is recommended.
 
 1. Commit any unsaved changes. 
 
-2. "make clean"
-
-3. Create html/vX.X.html.  Take ChangeLog entries and html-ify in there. 
+2. Create html/vX.X.html.  Take ChangeLog entries and html-ify in there. 
    Easist thing to do is take html/vX.(X-1).html and use it as a template.
    Add that file to the list of EXTRA_DIST files in the html/Makefile.am.
 
-3.5. Update html/index.html to refer to this new page as the current release.
-
-4. Increment version in configure.ac.  Put 'alpha' or 'beta' after
-   the version, if applicable. 
+3. Update html/index.html to refer to this new page as the current release.
 
-   eg.
-   3.5.7
-    or
-   3.5.8beta
+4. Increment the release version in configure.ac.  Put 'alpha' or
+   'beta' after the version, if applicable.  For example:
+
+     3.9.1
+      or
+     3.9.1beta
 
    Version should be updated in two places: in the second argument of the
    AC_INIT macro and in LIBTIFF_xxx_VERSION variables.
 
-5. autoconf
+5. Add an entry to Changelog similar to:
+
+     * libtiff 3.9.1 released.
+
+6. In the source tree do
 
-6. sh configure
+     ./autogen.sh
 
-7. make release -- this will update "RELEASE-DATE" and "VERSION" in the top
-   level dir, and libtiff/tiffvers.h.  
+   This step may be skipped if you have already been using a
+   maintainer build with current autoconf, automake, and libtool
+   packages.  It is only needed when updating tool versions.
 
-8. Please verify that the version info in RELEASE-DATE, VERSION and
-   libtiff/tiffvers.h is right.
+7. It is recommended (but not required) to build outside of the source
+   tree so that the source tree is kept in a pristine state.  This
+   also allows sharing the source directory on several networked
+   systems.  For example:
+
+     mkdir libtiff-build
+     cd libtiff-build
+     /path/to/libtiff/configure --enable-maintainer-mode
 
-9. make; make distcheck (to test). 
+   otherwise do
+
+     ./configure --enable-maintainer-mode
 
-10. make distclean
+8. In the build tree do
+
+     make release
+
+   This will update "RELEASE-DATE", "VERSION", and libtiff/tiffvers.h
+   in the source tree.
 
-11. cvs commit
+9. In the source tree, verify that the version info in RELEASE-DATE,
+   VERSION and libtiff/tiffvers.h is right.
 
-12. cvs tag Release-v3-5-7 (or the appropriate name for the release)
+10. In the build tree do
+
+      make
+      make distcheck
 
-13. configure; make dist
+    If 'make distcheck' fails, then correct any issues until it
+    succeeds.
+
     Two files with names tiff-version.tar.gz and tiff-version.zip will
-    be created in the top level package directory.
+    be created in the top level build directory.
+
+11. In the source tree do
 
-14. Copy to ftp.remotesensing.org ftp site. 
-    scp tiff-*.tar.gz ftp.remotesensing.org:/var/ftp/libtiff/
-    scp tiff-*.zip ftp.remotesensing.org:/var/ftp/libtiff/
+      'cvs commit'.
+
+12. In the source tree do
+
+      cvs tag Release-v3-9-1
+
+    (or the appropriate name for the release)
 
-15. Announce to list, tiff@lists.maptools.org
+13. Copy release packages from the build tree to the
+    ftp.remotesensing.org ftp site.
 
-16. Update libtiff page on freshmeat with new version announcement.
+      scp tiff-*.tar.gz tiff-*.zip \
+    	 frankw@upload.osgeo.org:/osgeo/download/libtiff
+
+14. Announce to list, tiff@lists.maptools.org
+
+15. Update libtiff page on freshmeat with new version announcement.