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.
|
|
|
|
|
|
|
|
|
|
- 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`
|
|
|
|
|
./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 bin/stow does not contain a "use lib" line. This
|
|
|
|
|
should only happen if the installation directory for Perl
|
|
|
|
|
modules (--with-pmdir's default value) is not in Perl's
|
|
|
|
|
built-in @INC, which would be caused by ./configure's default
|
|
|
|
|
prefix (/usr/local) not matching your Perl's siteprefix, but
|
|
|
|
|
the above --prefix should prevent that, as would:
|
|
|
|
|
|
|
|
|
|
./configure --with-pmdir=`perl -le 'print $INC[0]'`
|
|
|
|
|
|
|
|
|
|
- Make sure all the following commands all run successfully:
|
|
|
|
|
|
|
|
|
|
perl Build.PL
|
|
|
|
|
./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:
|
|
|
|
|
|
|
|
|
|
git tag v7.8.9
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
# First check out texinfo CVS repository via:
|
|
|
|
|
# cvs -z3 -d:pserver:anonymous@cvs.savannah.gnu.org:/sources/texinfo co texinfo
|
|
|
|
|
|
|
|
|
|
# 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
|
|
|
|
|
texinfo_repo=/path/to/texinfo/git/repo
|
|
|
|
|
|
|
|
|
|
cd $stow_repo
|
|
|
|
|
export GENDOCS_TEMPLATE_DIR=$texinfo_repo/util
|
|
|
|
|
$texinfo_repo/util/gendocs.sh \
|
|
|
|
|
-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
|
|
|
|
|
cvs commit
|
|
|
|
|
|
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.
|
