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
|
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
|
|
|
|
|
qpdf/qpdf.cc
|
|
|
|
|
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
|
|
|
|
|
|
|
|
* Each year, update copyright notices. Just search for Copyright.
|
|
|
|
|
Last updated: 2008.
|
|
|
|
|
|
|
|
|
|
* To construct a source distribution from a pristine checkout,
|
2008-05-06 15:32:48 +00:00
|
|
|
make_release does the following:
|
2008-04-29 12:55:25 +00:00
|
|
|
|
|
|
|
|
autoconf
|
2008-05-05 14:29:12 +00:00
|
|
|
autoheader
|
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.
|
|
|
|
|
|
2008-04-29 12:55:25 +00:00
|
|
|
* Remember to update documentation in the "files" subdirectory of the
|
|
|
|
|
website on sourceforge.net.
|
|
|
|
|
|
|
|
|
|
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
|
2008-05-05 14:29:12 +00:00
|
|
|
controlled are "configure", "libqpdf/qpdf/qpdf-config.h.in", 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.
|
|
|
|
|
|
|
|
|
|
* config.guess, config.sub, ltmain.sh: these were created by running
|
|
|
|
|
libtoolize -c. To update, run libtoolize -f -c or remove the files
|
|
|
|
|
and rerun libtoolize.
|
|
|
|
|
|
|
|
|
|
* Other files copied as indicated:
|
|
|
|
|
|
|
|
|
|
cp /usr/share/aclocal/libtool.m4 aclocal.m4
|
|
|
|
|
cp /usr/share/automake-1.10/install-sh .
|
|
|
|
|
cp /usr/share/automake-1.10/mkinstalldirs .
|
|
|
|
|
|
|
|
|
|
The entire contents of aclocal.m4 came from libtool.m4. If we had
|
|
|
|
|
some additional local parts, we could manually combine them or we
|
|
|
|
|
could run aclocal. For now, the simple copy statement above is
|
|
|
|
|
sufficient.
|
|
|
|
|
|
|
|
|
|
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.
|
