2011-11-26 13:15:26 -05:00
|
|
|
How to make a new release of GNU Stow
|
|
|
|
|
=====================================
|
|
|
|
|
|
|
|
|
|
- Ensure NEWS contains the latest changes.
|
|
|
|
|
|
|
|
|
|
- Ensure configure.ac contains the new version number.
|
2015-11-09 05:13:34 -05:00
|
|
|
This should follow Semantic Versioning as described at:
|
|
|
|
|
|
|
|
|
|
http://semver.org/
|
2011-11-26 13:15:26 -05:00
|
|
|
|
|
|
|
|
- Check CPAN distribution will work via Module::Build:
|
|
|
|
|
|
2011-12-07 15:28:28 -05:00
|
|
|
- Generate stow, chkstow, and lib/Stow.pm via:
|
|
|
|
|
|
|
|
|
|
eval `perl -V:siteprefix`
|
2015-11-09 04:28:11 -05:00
|
|
|
automake --add-missing
|
2011-12-07 15:28:28 -05:00
|
|
|
./configure --prefix=$siteprefix && make
|
|
|
|
|
|
2011-12-06 12:22:21 -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
|
|
|
|
|
|
|
|
- Make sure all the following commands all run successfully:
|
|
|
|
|
|
2012-01-09 17:10:19 -05:00
|
|
|
perl Build.PL --prefix=/tmp/stow-test
|
2011-12-07 15:28:28 -05:00
|
|
|
./Build test
|
|
|
|
|
./Build install
|
|
|
|
|
./Build distcheck
|
|
|
|
|
./Build distmeta
|
|
|
|
|
|
|
|
|
|
- Check META.yaml and META.json have the new version number.
|
2011-11-26 13:15:26 -05:00
|
|
|
|
|
|
|
|
- Ensure all changes are committed to git.
|
|
|
|
|
|
|
|
|
|
- Run make distcheck and ensure that everything looks good.
|
|
|
|
|
It should generate the distribution files for you.
|
|
|
|
|
|
|
|
|
|
- Tag the current git HEAD with the new version number:
|
|
|
|
|
|
2015-11-09 05:11:59 -05:00
|
|
|
git tag -s v7.8.9
|
2011-11-26 13:15:26 -05:00
|
|
|
|
2011-12-03 13:13:09 -05:00
|
|
|
- Push HEAD and tag to savannah
|
|
|
|
|
|
|
|
|
|
git push
|
|
|
|
|
git push --tags
|
|
|
|
|
|
|
|
|
|
- Regenerate the documentation for the website:
|
|
|
|
|
|
2015-11-09 05:10:36 -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
|
|
|
|
|
|
|
|
# and stow-web CVS repository via the instructions here:
|
|
|
|
|
# https://savannah.gnu.org/cvs/?group=stow
|
|
|
|
|
|
|
|
|
|
# Set paths:
|
|
|
|
|
stow_repo=/path/to/stow/git/repo
|
|
|
|
|
stow_web_repo=/path/to/stow-web/CVS/working/dir
|
2015-11-09 05:10:36 -05:00
|
|
|
gnulib_repo=/path/to/gnulib/git/repo
|
2011-12-03 13:13:09 -05:00
|
|
|
|
|
|
|
|
cd $stow_repo
|
2015-11-09 05:10:36 -05:00
|
|
|
export GENDOCS_TEMPLATE_DIR=$gnulib_repo/doc
|
|
|
|
|
$gnulib_repo/util/gendocs.sh \
|
2011-12-03 13:13:09 -05:00
|
|
|
-s doc/stow.texi \
|
|
|
|
|
-o $stow_web_repo/manual \
|
|
|
|
|
--email bug-stow@gnu.org \
|
|
|
|
|
stow "GNU Stow manual"
|
|
|
|
|
|
|
|
|
|
cd $stow_web_repo
|
|
|
|
|
# Check that the changes look OK
|
|
|
|
|
cvs diff
|
|
|
|
|
# Then commit
|
2012-02-18 15:43:20 -05:00
|
|
|
cvs commit -m 'Update manual to v7.8.9'
|
2011-12-03 13:13:09 -05:00
|
|
|
|
2011-12-06 12:22:21 -05:00
|
|
|
- Run ./Build dist
|
|
|
|
|
|
|
|
|
|
- Upload the resulting Stow-v7.8.9.tar.gz to CPAN via https://pause.perl.org/
|
|
|
|
|
|
2011-11-26 13:15:26 -05:00
|
|
|
- Upload 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
|
2011-12-03 12:51:44 -05:00
|
|
|
- Run gnupload --to ftp.gnu.org:stow --symlink-regex stow-7.8.9.tar.*
|
2011-11-26 13:15:26 -05:00
|
|
|
|
|
|
|
|
- Send release announcements to
|
|
|
|
|
|
|
|
|
|
- info-stow@gnu.org
|
2011-12-03 12:51:48 -05:00
|
|
|
- stow-devel@gnu.org
|
|
|
|
|
- info-gnu@gnu.org
|
2011-11-26 13:15:26 -05:00
|
|
|
- https://savannah.gnu.org/news/?group=stow
|
|
|
|
|
|
|
|
|
|
See http://www.gnu.org/prep/maintain/html_node/Announcements.html for
|
|
|
|
|
more on making release announcements.
|
