aboutsummaryrefslogtreecommitdiffstats
path: root/README.maintainer
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2008-04-29 14:55:25 +0200
committerJay Berkenbilt <ejb@ql.org>2008-04-29 14:55:25 +0200
commit9a0b88bf7777c153dc46ace22db74ef24d51583a (patch)
treef567ac1cf2bf5071a611eb49323a935b6ac938ff /README.maintainer
downloadqpdf-9a0b88bf7777c153dc46ace22db74ef24d51583a.tar.zst
update release date to actual daterelease-qpdf-2.0
git-svn-id: svn+q:///qpdf/trunk@599 71b93d88-0707-0410-a8cf-f5a4172ac649
Diffstat (limited to 'README.maintainer')
-rw-r--r--README.maintainer69
1 files changed, 69 insertions, 0 deletions
diff --git a/README.maintainer b/README.maintainer
new file mode 100644
index 00000000..49e6a175
--- /dev/null
+++ b/README.maintainer
@@ -0,0 +1,69 @@
+Release Reminders
+=================
+
+ * 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.
+
+ * Make sure version numbers are consistent in the following
+ locations:
+
+ configure.ac
+ qpdf.spec
+ qpdf/qpdf.cc
+ manual/qpdf-manual.xml
+
+ make_dist does this automatically.
+
+ * Each year, update copyright notices. Just search for Copyright.
+ Last updated: 2008.
+
+ * To construct a source distribution from a pristine checkout,
+ make_release does the following.
+
+ autoconf
+ ./configure --enable-doc-maintenance
+ make build_manual
+ make distclean
+
+ * Remember to update documentation in the "files" subdirectory of the
+ website on sourceforge.net.
+
+General Build Stuff
+===================
+
+QPDF supports autoconf and libtool but does not use automake. In
+addition, there is no header file generated by autoconf. The only
+file distributed with the qpdf source distribution that is not a
+controlled file is "configure", and it is generated by just running
+"autoconf". There is no need to run autoreconf, automake, autoheader,
+aclocal, or any other autotools programs beyond autoconf.
+
+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.