DOCS/tech/release-howto.txt

   1 How to make an MPlayer release
   2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   3
   4 preparations:
   5 - Announce release target date on dev-eng and #mplayerdev
   6 - Ask the DOCS maintainers to commit their final changes, check if
   7   all docs are up to date, etc.
   8 - Verify man page, remove obsolete options, mention new ones.
   9 - Ask translation maintainers to update their help_mp*.h file.
  10 - Update the ChangeLog file (according to Subversion log), ask other developers
  11   to verify their parts, etc. Ask Diego to spellcheck it.
  12 - Consult at -dev-eng about unstable parts of the code which should be
  13   disabled for the release.
  14 - Find a codename for the release
  15
  16 create the release tree:
  17 - tag Subversion with release name
  18 - Add a VERSION file with the release version to the root of the source tree.
  19 - update release.sh script with version number
  20 ***the following steps are done automatically by release.sh script***
  21 - checkout the mplayer src tree
  22 - check out FFmpeg subdirs
  23 - remove obsolete DOCS translations, help files
  24
  25 - build the HTML docs from XML sources, then clean up:
  26     make html-chunked; make releaseclean
  27
  28 release the tree:
  29     cd ..
  30     mv main MPlayer-0.90rc5
  31     tar -cf MPlayer-0.90rc5.tar MPlayer-0.90rc5
  32     bzip2 -9 MPlayer-0.90rc5.tar
  33 ***end of part done by release.sh**
  34
  35 test it (download to your local machine, extract, compile, run)
  36  - compilers: gcc 4.x, gcc 3.x, gcc 2.95, MinGW, Cygwin
  37  - architectures: PPC, AMD64, x86 with MMX[2], SSE[2], 3DNow
  38  - OS: Linux, BSD, Windows, Mac OS X
  39
  40 copy to FTP:
  41     cp MPlayer-0.90rc5.tar.bz2 /home/ftp/MPlayer/releases/
  42     cp ChangeLog-0.90rc5 and update ChangeLog symlink
  43     md5sum MPlayer-0.90rc5.tar.bz2 > MPlayer-0.90rc5.tar.bz2.md5
  44
  45 move the older (pre)release(s) (except the last one before the current one)
  46 to ../OLD_stuff/ dir
  47
  48 Somehow get Diego to write a news entry for the release, and update the
  49 source file of dload.html and commit it. Test it, it's sometimes buggy
  50 (broken links etc). Also, update translated versions of dload.html.
  51
  52 Send a message to mplayer-announce mailing list.
  53
  54 Add the new release version to bugzilla page.
  55
  56 Update release version in #mplayer topic
  57
  58 Update project page on Freshmeat
  59
  60 Done.
  61