Tasque

1. Making a Release of Tasque

If you're used to doing this, it'll probably take about an hour to make a Tasque release. If you hit a glitch, who knows how long it will take, so plan accordingly.

• Announce in #tasque that you're about to make a release so they'll stop pushing commits to master (although you may get someone who begs you for a few more minutes for a last-minute-super-risky change)

• Update to the latest code git pull --rebase

• Update the NEWS file

  • This is one occasion where git log is your friend.

  • Keep the NEWS file mostly non-technical in nature. You don't have to add every single thing from git log, only the things that would mean the most to end-users. Serious technical issues should be omitted from the NEWS file. Bugs (with the number), are useful however.

• Build a test tarball

  • Run: make distcheck

  • make distcheck must succeed. Do not make a release if this step fails. Take the time to fix any problems that arise. You'll thank yourself later.

• Test the tasque-x.y.z.tar.gz file that is generated

  • tar xzvf tasque-x.y.z
    cd tasque-x.y.z
    ./configure --prefix=/tmp/tasque-x.y.z
    make
    make install
    /tmp/tasque-x.y.z/bin/tasque  (this should run tasque w/o issues)

• If everything worked in the test tarball, commit the NEWS news file.
• Tag the code in git

  • git tag -a TASQUE_X_Y_Z

  • For a comment, use "Tagging the X.Y.Z release"
  • The tag should be in the following format: TASQUE_{MAJOR}_{MINOR}_{RELEASE}

    • e.g., TASQUE_0_1_0

  • Good idea to double-check that the tag is in the right place in gitk

• Bump the version one revision in configure.ac and commit it

  • e.g., 0.1.0 -> 0.1.1

  • This allows others to start developing in master again
• Push these commits to git.gnome.org

  • git push origin HEAD TASQUE_X_Y_Z

• Install the tarball on master.gnome.org

  • md5sum tasque-x.y.z    (note the value, you'll use it later)
    scp tasque-x.y.z {your-GNOME-username}@master.gnome.org:.
    ssh {your-GNOME-username}@master.gnome.org
    md5sum tasque-x.y.z    (make sure it matches with the MD5 on your machine)
    install-module tasque-x.y.z    (follow instructions, usually just answer Y)

  • If this step is successful, you should see the tar.gz and tar.bz2 appear here (after a few minutes): http://ftp.gnome.org/pub/GNOME/sources/tasque/

• Update the Download web page

• Make sure you're subscribed to tasque-list@gnome.org, gnome-announce-list@gnome.org and mono-announce-list@lists.ximian.com

• Send an ANNOUNCE email:
  • Subject: ANNOUNCE: Tasque X.Y.Z Released!

  • Cc: tasque-list@gnome.org, gnome-announce-list@gnome.org, mono-announce-list@lists.ximian.com

  • Grab the content from a previous announcement and adjust accordingly
  • Make sure to mention changes that would affect packagers
• You're done! WHEW!