2011-11-26 13:15:26 -05:00
|
|
|
How to make a new release of GNU Stow
|
|
|
|
=====================================
|
|
|
|
|
2015-11-09 06:04:21 -05:00
|
|
|
Prerequisite reading
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
First read the official information for maintainers of GNU software:
|
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
https://www.gnu.org/prep/maintain/
|
2015-11-09 06:04:21 -05:00
|
|
|
|
|
|
|
Release procedure
|
|
|
|
-----------------
|
|
|
|
|
2019-06-25 15:04:11 -04:00
|
|
|
- Ensure configure.ac contains the number of the new unreleased
|
|
|
|
version. This should follow Semantic Versioning as described at:
|
2016-11-20 16:58:31 -05:00
|
|
|
|
2019-06-25 15:04:11 -04:00
|
|
|
http://semver.org/
|
2016-11-20 16:58:31 -05:00
|
|
|
|
2019-06-25 15:04:11 -04:00
|
|
|
- To make the following steps easier, set the $version shell variable
|
|
|
|
to the same version number as above, e.g.
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2019-06-25 15:04:11 -04:00
|
|
|
version=$( tools/get-version ) && echo $version
|
2016-11-20 16:58:31 -05:00
|
|
|
|
2019-06-25 15:04:11 -04:00
|
|
|
- Ensure NEWS contains the latest changes, and that any new
|
|
|
|
contributors have been added to THANKS. If necessary, commit
|
|
|
|
any additions:
|
2015-11-09 05:13:34 -05:00
|
|
|
|
2019-06-25 15:04:11 -04:00
|
|
|
git commit -m "Prepare NEWS and THANKS for $version release"
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
- Check CPAN distribution will work via Module::Build:
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2019-07-28 08:15:11 -04:00
|
|
|
- Start from a clean slate:
|
|
|
|
|
2020-11-01 12:19:18 -05:00
|
|
|
make maintainer-clean
|
2019-07-28 08:15:11 -04:00
|
|
|
autoreconf -iv
|
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
- Generate stow, chkstow, and lib/Stow.pm via:
|
2011-12-07 15:28:28 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
eval `perl -V:siteprefix`
|
|
|
|
automake --add-missing
|
|
|
|
./configure --prefix=$siteprefix && make
|
2011-12-07 15:28:28 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
(N.B. the CPAN distribution will contain these files, whereas
|
|
|
|
the GNU distribution will not.)
|
2011-12-07 15:28:28 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
- Make sure all the following commands all run successfully:
|
2011-12-07 15:28:28 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
perl Build.PL --prefix=/tmp/stow-test
|
|
|
|
./Build test
|
|
|
|
./Build install
|
|
|
|
./Build distcheck
|
|
|
|
./Build distmeta
|
2019-07-28 08:28:46 -04:00
|
|
|
./Build dist
|
2011-12-07 15:28:28 -05:00
|
|
|
|
2019-07-28 09:52:16 -04:00
|
|
|
- Check META.yml and META.json have the new version number.
|
2016-11-20 16:58:31 -05:00
|
|
|
They already should if the final step of this document was
|
2019-07-28 09:52:16 -04:00
|
|
|
carried out after the previous release was publised, but
|
2016-11-20 16:58:31 -05:00
|
|
|
if not:
|
|
|
|
|
2019-06-25 15:04:11 -04:00
|
|
|
git commit -m "Bump version to $version"
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
- Ensure all changes are committed to git.
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
- Run make distcheck and ensure that everything looks good.
|
|
|
|
It should generate the distribution files for you.
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2016-11-20 17:16:43 -05:00
|
|
|
- Run the tests on various Perl versions via Docker:
|
|
|
|
|
|
|
|
./build-docker.sh
|
|
|
|
./test-docker.sh
|
|
|
|
|
2019-06-25 15:04:11 -04:00
|
|
|
Obviously if there are any failures, they will need to be fixed
|
|
|
|
first, and then repeat the above steps.
|
|
|
|
|
|
|
|
- At this point we have a release candidate. Tag the current git HEAD
|
|
|
|
with the new version number:
|
|
|
|
|
2019-06-28 19:36:00 -04:00
|
|
|
git tag -s v$version -m "Release $version"
|
2019-06-25 15:04:11 -04:00
|
|
|
|
2016-11-20 17:02:00 -05:00
|
|
|
- Upload the resulting Stow-v7.8.9.tar.gz to CPAN via https://pause.perl.org/
|
|
|
|
|
2019-07-28 08:58:00 -04:00
|
|
|
- Wait until PAUSE has accepted the upload as a valid module. If you
|
|
|
|
are the maintainer of the module, you should receive two email
|
|
|
|
notifications: a CPAN upload confirmation, and a PAUSE indexer
|
|
|
|
report. This provides some valuable final validation, as learnt the
|
|
|
|
hard way during the non-release of 2.2.1.
|
2016-11-20 17:02:00 -05:00
|
|
|
|
2016-11-20 17:00:46 -05:00
|
|
|
- Push HEAD and tag to savannah and GitHub:
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2019-07-28 09:54:36 -04:00
|
|
|
git push savannah master
|
2016-11-20 17:00:46 -05:00
|
|
|
git push --tags savannah
|
2019-07-28 09:54:36 -04:00
|
|
|
git push github master
|
2016-11-20 17:00:46 -05:00
|
|
|
git push --tags github
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2019-07-16 14:21:04 -04:00
|
|
|
- Upload the new release to ftp.gnu.org. This is easiest using gnupload:
|
|
|
|
|
|
|
|
- git clone git://git.savannah.gnu.org/gnulib.git
|
|
|
|
- Copy gnulib/build-aux/gnupload to somewhere on your $PATH
|
|
|
|
- Run gnupload --to ftp.gnu.org:stow --symlink-regex stow-7.8.9.tar.*
|
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
- Regenerate the documentation for the website:
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
# First check out gnulib repository via:
|
|
|
|
# git clone git://git.savannah.gnu.org/gnulib.git
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
# and stow-web CVS repository via the instructions here:
|
|
|
|
# https://savannah.gnu.org/cvs/?group=stow
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
# Set paths:
|
|
|
|
stow_repo=/path/to/stow/git/repo
|
|
|
|
stow_web_repo=/path/to/stow-web/CVS/working/dir
|
|
|
|
gnulib_repo=/path/to/gnulib/git/repo
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
cd $stow_repo
|
|
|
|
export GENDOCS_TEMPLATE_DIR=$gnulib_repo/doc
|
|
|
|
$gnulib_repo/util/gendocs.sh \
|
|
|
|
-s doc/stow.texi \
|
|
|
|
-o $stow_web_repo/manual \
|
|
|
|
--email bug-stow@gnu.org \
|
|
|
|
stow "GNU Stow manual"
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
cd $stow_web_repo
|
|
|
|
# Check that the changes look OK
|
|
|
|
cvs diff
|
|
|
|
# Then commit
|
2019-06-28 19:55:51 -04:00
|
|
|
cvs commit -m "Update manual to v$version"
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2019-07-16 14:24:19 -04:00
|
|
|
- Update the news section of stow.html in the stow-web CVS repository
|
|
|
|
to mention the new release.
|
|
|
|
|
2019-07-28 07:55:22 -04:00
|
|
|
cd $stow_web_repo
|
|
|
|
# Check that the changes look OK
|
|
|
|
cvs diff
|
|
|
|
# Then commit
|
|
|
|
cvs commit -m "Update home page to v$version"
|
|
|
|
|
2016-11-20 16:51:41 -05:00
|
|
|
- Send release announcements to
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
- info-stow@gnu.org
|
|
|
|
- stow-devel@gnu.org
|
|
|
|
- info-gnu@gnu.org
|
|
|
|
- https://savannah.gnu.org/news/?group=stow
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2015-11-09 06:05:00 -05:00
|
|
|
See http://www.gnu.org/prep/maintain/html_node/Announcements.html for
|
|
|
|
more on making release announcements.
|
2016-11-20 16:58:31 -05:00
|
|
|
|
2019-06-28 20:12:36 -04:00
|
|
|
Excerpts of NEWS can be formatted for inclusion in the email by
|
|
|
|
selecting the relevant version subtree via M-x org-mark-element,
|
|
|
|
minus the "* Changes in version x.y.z", running M-x
|
|
|
|
org-export-dispatch, and exporting as plain text.
|
|
|
|
|
2016-11-20 16:58:31 -05:00
|
|
|
- Update the git repositories to the next expected version, so that anyone
|
|
|
|
who builds from git gets a version of Stow which is higher than the release
|
|
|
|
which was just cut:
|
|
|
|
|
|
|
|
- Increment the patchlevel of the version number in configure.ac.
|
|
|
|
|
2019-06-29 08:40:45 -04:00
|
|
|
- Run this again:
|
|
|
|
|
|
|
|
version=$( tools/get-version ) && echo $version
|
|
|
|
|
2019-07-28 09:52:16 -04:00
|
|
|
- In order to update META.yml and META.json, repeat the same
|
|
|
|
procedure listed above, starting at "make distclean" and
|
|
|
|
finishing after "./Build distmeta".
|
|
|
|
|
|
|
|
- Check META.yml and META.json now have the new versions.
|
|
|
|
|
|
|
|
- git add configure.ac META.{yml,json}
|
2016-11-20 16:58:31 -05:00
|
|
|
|
2019-06-29 08:40:45 -04:00
|
|
|
- git commit -m "Bump version to $version for development of next release"
|
2016-11-20 16:58:31 -05:00
|
|
|
|
2019-07-28 09:54:36 -04:00
|
|
|
- git push savannah master
|
2016-11-20 16:58:31 -05:00
|
|
|
|
2019-07-28 09:54:36 -04:00
|
|
|
- git push github master
|