release_scripts/RELEASE_HOWTO

   1 SECTION 1: Preparation
   2
   3  * Check the README file is still relevant
   4  * Run the "fixuifiles" script from the source-root
   5  * Run the "bump_plugin_version.rb" script from the folder amarok/
   6  * Commit the source to SVN
   7 --------------------------------------------------------------------------------
   8
   9 SECTION 2: Creating and Testing the Tarball
  10
  11  * Run the release_amarok.rb script; OR
  12    Follow the guide lines in appendix A
  13  * Test the following:
  14
  15      $ ./configure && make
  16      $ ./configure --enable-final --disable-debug && make
  17
  18  * Check it works OK without any amarok files in ~/.kde
  19 --------------------------------------------------------------------------------
  20
  21 SECTION 3: Once Happy with the Tarball
  22
  23  * SFtp the tarball to ftpamarok@ktown.kde.org/stable/amarok/VERSION/src
  24    (If you don't have access, mail sysadmin@kde.org)
  25  * Update the amarok.kde.org front-page before anything else!
  26  * Update kde-apps.org and freshmeat.net
  27  * Send a witty, intelligent and diligently crafted email to the following:
  28
  29      To:  kde-announce@kde.org
  30      CC:  amarok@kde.org, amarok-promo@kde.org
  31      BCC: kde-extra-gear@kde.org, libvisual-devel@lists.sourceforge.net,
  32           kde-multimedia@kde.org, nmm-dev@graphics.cs.uni-sb.de,
  33 --------------------------------------------------------------------------------
  34
  35 SECTION 4: After the Release
  36
  37  If you must change anything about the tarball you need to email binner@kde.org
  38  because otherwise he gets annoyed that the md5 has changed.
  39  Generally it is not wise to change the tarball, it could annoy the entire
  40  open-source world!
  41 --------------------------------------------------------------------------------
  42
  43 APPENDIX A
  44
  45 This is what the release_amarok script does:
  46
  47  1. Checkout a fresh copy of amarok, its docs and po; cd into the root
  48  2. Update APP_VERSION in amarok/src/amarok.h
  49  3. $ `find -name .svn -exec rm {} \;`
  50  4. $ export WANT_AUTOMAKE=1.6
  51  5. $ make -f Makefile.cvs
  52  6. $ rm -rf autom4te.cache config.h config.log
  53  7. $ pushd amarok; mv README TODO INSTALL ChangeLog AUTHORS COPYING amarok.lsm ..; popd
  54  8. $ mv ../multimedia ../amarok-VERSION
  55  9. $ tar cjf ../amarok-VERSION.tar.bz2 ../amarok-VERSION
  56
  57 APPENDIX B
  58
  59 To create a changelog in html format for updating the various articles and websites, run generate_changelog.rb.  It will output a file called ChangeLog.html.