awesome/docs/doing_a_release.md

How to do a release

• Edit awesomeConfig.cmake and choose a codename that is not already listed in Releases. jd always picked a song title, you should do the same.
• Commit this changes to awesomeConfig.cmake
• Add the release version and date to Releases
• Change the version in Template:Stable-version
• Git sign with git tag -s vX.Y.Z -m 'awesome vX.Y.Z'
• Push with git push and push tag with git push origin vX.Y.Z
• Run make dist to create tarballs.
• Copy tarballs inside awesome.naquadah.org:/var/www/awesome.naquadah.org/download/
• Edit download.mdwn from [http://git.naquadah.org/?p=awesome-www.git;a=summary the awesome www repository] to change the version information, links, etc
• Go into the 'src' submodule, and update it to vX.Y.Z with git checkout vX.Y.Z. This will be used to build and publish the documentation online.
• Commit download.mdwn and src.
• git push this
• Type make push in awesome-www to push changes to the website. Be careful to have ikiwiki, asciidoc and imagemagick for Perl (perlmagick, otherwise images get broken)
• Send a mail to awesome@naquadah.org with any amount of information and jokes inside.
• Change the topic on IRC

For the announcement mail, the following shell script might be handy:

#!/bin/sh
VER=$1
PREV_VER=$2
TAG="v$VER"
PTAG="v$PREV_VER"
REVS="$PTAG..$TAG"

echo "awesome version $VER has been released. It is available from:"

print_file()
{
        EXT="$1"
        URL="http://awesome.naquadah.org/download/awesome-$VER.$EXT"
        FILE="/var/www/awesome.naquadah.org/download/awesome-$VER.$EXT"
        MD5=$(ssh prometheus.naquadah.org "md5sum $FILE" 2>/dev/null | cut -f1 -d ' ')
        SHA1=$(ssh prometheus.naquadah.org "sha1sum $FILE" 2>/dev/null | cut -f 1 -d ' ')

        echo
        echo "$EXT: $URL"
        echo "md5: $MD5"
        echo "sha1: $SHA1"
}

print_headline()
{
        HEAD="$@"
        echo
        echo "$HEAD"
        echo "$HEAD" | sed -e 's/./-/g'
}

print_file "tar.xz"
print_file "tar.bz2"

print_headline "number of changes"
git rev-list "$REVS" | wc -l

print_headline "number of commiters"
git log --format=format:%an "$REVS" | sort -u | wc -l

print_headline "shortlog"
git log "$REVS" | git shortlog --numbered | cat

print_headline "diffstat"
git diff --stat "$REVS" | cat