2008-04-29 12:55:25 +00:00
|
|
|
Release Reminders
|
|
|
|
=================
|
|
|
|
|
2008-05-07 15:47:43 +00:00
|
|
|
* Increment shared library version information as needed
|
2009-03-09 16:59:37 +00:00
|
|
|
(libqpdf/build.mk)
|
2008-04-29 12:55:25 +00:00
|
|
|
|
2008-05-07 15:47:43 +00:00
|
|
|
* Add a release entry to ChangeLog
|
2008-05-05 14:46:44 +00:00
|
|
|
|
2008-04-29 12:55:25 +00:00
|
|
|
* Make sure version numbers are consistent in the following
|
|
|
|
locations:
|
|
|
|
|
|
|
|
configure.ac
|
|
|
|
qpdf.spec
|
2009-10-24 04:47:17 +00:00
|
|
|
libqpdf/QPDF.cc
|
2008-04-29 12:55:25 +00:00
|
|
|
manual/qpdf-manual.xml
|
|
|
|
|
2008-06-30 14:48:16 +00:00
|
|
|
make_dist verifies this consistency.
|
2008-04-29 12:55:25 +00:00
|
|
|
|
2009-09-27 20:33:17 +00:00
|
|
|
* Update release date in manual/qpdf-manual.xml
|
|
|
|
|
2008-04-29 12:55:25 +00:00
|
|
|
* Each year, update copyright notices. Just search for Copyright.
|
2009-02-15 16:31:12 +00:00
|
|
|
Last updated: 2009.
|
2008-04-29 12:55:25 +00:00
|
|
|
|
|
|
|
* To construct a source distribution from a pristine checkout,
|
2008-06-30 14:48:51 +00:00
|
|
|
make_dist does the following:
|
2008-04-29 12:55:25 +00:00
|
|
|
|
2009-09-26 15:42:39 +00:00
|
|
|
aclocal -I m4
|
2008-05-05 14:29:12 +00:00
|
|
|
autoheader
|
2009-09-26 15:42:39 +00:00
|
|
|
autoconf
|
2008-04-29 12:55:25 +00:00
|
|
|
./configure --enable-doc-maintenance
|
|
|
|
make build_manual
|
|
|
|
make distclean
|
|
|
|
|
2008-05-07 15:47:43 +00:00
|
|
|
* To create a source release, do an export from the version control
|
|
|
|
system to a directory called qpdf-version. From the parent of that
|
|
|
|
directory, run make_dist with the directory as an argument. For
|
|
|
|
internally testing releases, you can run make_dist with the
|
|
|
|
--no-tests option.
|
|
|
|
|
2009-10-23 16:44:13 +00:00
|
|
|
* To create a source release of external libs, do an export from the
|
|
|
|
version control system into a directory called qpdf-external-libs
|
|
|
|
and just make a zip file of the result called
|
|
|
|
qpdf-external-libs-src.zip. See the README.txt file there for
|
|
|
|
information on creating binary external libs releases.
|
|
|
|
|
|
|
|
* To create Windows binary releases, extract the qpdf source
|
|
|
|
distribution in Windows (MSYS + MINGW, MSVC) and run
|
|
|
|
./make_windows_releases from there. You will have to manually
|
|
|
|
create zip files from the install-mingw and install-msys
|
|
|
|
directories; instructions are echoed by the script.
|
|
|
|
|
|
|
|
* Remember to copy README-what-to-download.txt separately onto the
|
|
|
|
download area and make it the default for Windows platforms.
|
|
|
|
|
2008-04-29 12:55:25 +00:00
|
|
|
* Remember to update documentation in the "files" subdirectory of the
|
|
|
|
website on sourceforge.net.
|
|
|
|
|
2009-10-24 04:47:17 +00:00
|
|
|
* Create a tag in the version control system, and make backups of the
|
|
|
|
actual releases.
|
2009-02-15 16:31:12 +00:00
|
|
|
|
2009-10-23 16:44:13 +00:00
|
|
|
* When releasing on source forge, external-libs distributions go in
|
|
|
|
external-libs/yyyymmdd, and qpdf distributions go in qpdf/vvv
|
|
|
|
|
2008-04-29 12:55:25 +00:00
|
|
|
General Build Stuff
|
|
|
|
===================
|
|
|
|
|
2008-05-05 14:46:44 +00:00
|
|
|
QPDF uses autoconf and libtool but does not use automake. The only
|
|
|
|
files distributed with the qpdf source distribution that are not
|
2009-09-26 15:47:45 +00:00
|
|
|
controlled are "configure", "libqpdf/qpdf/qpdf-config.h.in",
|
|
|
|
"aclocal.m4", and some documentation. See above for the steps
|
|
|
|
required to prepare a source distribution.
|
2008-04-29 12:55:25 +00:00
|
|
|
|
|
|
|
A small handful of additional files have been taken from autotools
|
|
|
|
programs. These should probably be updated from time to time.
|
|
|
|
|
2009-09-26 15:42:39 +00:00
|
|
|
* config.guess, config.sub, ltmain.sh, and the m4 directory: these
|
|
|
|
were created by running libtoolize -c. To update, run libtoolize
|
|
|
|
-f -c or remove the files and rerun libtoolize.
|
2008-04-29 12:55:25 +00:00
|
|
|
|
|
|
|
* Other files copied as indicated:
|
|
|
|
|
2009-09-26 15:42:39 +00:00
|
|
|
cp /usr/share/automake-1.11/install-sh .
|
|
|
|
cp /usr/share/automake-1.11/mkinstalldirs .
|
2008-04-29 12:55:25 +00:00
|
|
|
|
2009-09-26 15:42:39 +00:00
|
|
|
The entire contents of the m4 directory came from libtool.m4. If we
|
|
|
|
had some additional local parts, we could also add those to the m4
|
|
|
|
directory. In order for this to work, it is necessary to run "aclocal
|
|
|
|
-I m4" before running autoheader and autoconf.
|
2008-04-29 12:55:25 +00:00
|
|
|
|
|
|
|
If building or editing documentation, configure with
|
|
|
|
--enable-doc-maintenance. This will ensure that all tools or files
|
|
|
|
required to validate and build documentation are available.
|
|
|
|
|
|
|
|
If you want to run make maintainer-clean or make distclean and you
|
|
|
|
haven't run ./configure, you can pass CLEAN=1 to make on the command
|
|
|
|
line to prevent it from complaining about configure not having been
|
|
|
|
run.
|