extras/README.releasing

   1 To make a release:
   2
   3 Pre-release:
   4 * If it's a stable release, check this first:
   5 https://wiki.gnome.org/Apps/Banshee/StableReleasesPolicy
   6 * Update src/Core/Banshee.Core/Resources/contributors.xml
   7   + This needs to be done manually, but there's a handy command
   8     that can help you a lot:
   9   `git log 2.9.0..HEAD --no-merges "$@" | grep ^Author: | sed 's/ <.*//; s/^Author: //' | sort | uniq -c | sort -nr`
  10   (if the previous release was 2.9.0)
  11 * Update AUTHORS (cd extras/ && ./create-authors > ../AUTHORS)
  12 * Update NEWS
  13 * Update copyright years if needed, in the following paths:
  14   + src/Core/Banshee.ThickClient/Banshee.Gui.Dialogs/AboutDialog.cs
  15   + src/AssemblyInfo.cs.in
  16   + COPYING
  17 * Check version in configure.ac (don't forget the display version)
  18 * Update banshee.doap, build/windows/Installer*
  19 * Run `make distcheck`
  20 * Commit everything
  21
  22 Release:
  23 * Specifying your gnome username with the env var GNOME_FTP_USER,
  24   run this script: `./extras/make-release`
  25   + Note that this makes the tag, adds the version to bugzilla,
  26     and uploads the tarballs. You will be asked to ssh to
  27     master.gnome.org to install the tarballs on ftp.gnome.org.
  28
  29 Post-release:
  30 * In the master.gnome.org session, do:
  31   `cp release-data/banshee-<full_version>.news /ftp/pub/gnome/sources/banshee/<two_digit_version>/ && signal-ftp-sync`
  32 * Update the website (http://banshee.fm/wp-admin/)
  33   + Add download/archives/$version page
  34     - Use `cd extras && ./create-release-notes > foo` script
  35       + By hand modify 'the previous major release notes...' section
  36     - Set sort order (negative file of full version, i.e.: -290), parent (Archives), and permalink (i.e.: http://banshee.fm/download/archives/2-9-0/)
  37   + Update Downloads/Archives page, adding entry for this release
  38   + Add a new blog post, uncategorized, tag 'news'
  39 * For stable releases, ssh banshee@banshee.fm, update web/download.banshee.fm/release-info/banshee
  40   + This is used by the website to know what the latest release is
  41 * Send announce e-mail
  42   + To: banshee-list@gnome.org, gnome-announce-list@gnome.org, mono-announce-list@lists.ximian.com
  43 * Bump version in configure.ac (don't forget the display version) and commit.