release-howto

To Release
----------

Prerequisities:
libdevel-cover-perl libtemplate-perl libtest-pod-coverage-perl libppi-html-perl

(Notes.)

Commit all changes.

Run tests:
for t in t/*.t; do
  PERL5LIB=.. perl "$t"
done

Bump version in:
	Writer.pm
	Makefile.PL
	META.yml

Update changelog.

git commit -a

xwver=A.BCD
git tag -s xml-writer-$xwver

git push origin master xml-writer-$xwver

Locally,

# Create a distribution from the tag
mkdir /tmp/xml-writer-release
git archive xml-writer-$xwver | tar -x -C /tmp/xml-writer-release
cd /tmp/xml-writer-release/XML

perl Makefile.PL
make dist

# Generate coverage report for the new release
tar -xf XML-Writer-$xwver.tar.gz -C /tmp
cd /tmp/XML-Writer-$xwver
perl Makefile.PL
cover -test -report Html_basic -outputdir coverage

Upload to CPAN.

Update web page:
./gen-index.pl >generated-index.html

mkdir temp-website
cp style.css temp-website/
cp -pr /tmp/XML-Writer-$xwver/coverage temp-website/
cp generated-index.html temp-website/index.html

cd temp-website
git init
git add .
git commit -m 'Generated website.'

git push -f git@github.com:josephw/xml-writer-perl.git master:refs/heads/gh-pages