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 - update release.sh script with version number
  19 ***the following steps are done automatically by release.sh script***
  20 - checkout the mplayer src tree
  21 - check out FFmpeg subdirs
  22 - remove obsolete DOCS translations, help files
  23 - replace version.sh with this (change version number too...):
  24
  25 ============
  26 #!/bin/sh
  27 echo "#define VERSION \"1.0pre5-$1 \"" > version.h
  28 ============
  29
  30 - build the HTML docs from XML sources, then clean up:
  31     make html-chunked; make releaseclean
  32
  33 release the tree:
  34     cd ..
  35     mv main MPlayer-0.90rc5
  36     tar -cf MPlayer-0.90rc5.tar MPlayer-0.90rc5
  37     bzip2 -9 MPlayer-0.90rc5.tar
  38 ***end of part done by release.sh**
  39
  40 test it (download to your local machine, extract, compile, run)
  41  - compilers: gcc 3, gcc 2.95, mingw, cygwin
  42  - architectures: PPC, AMD64, x86 with MMX[2], SSE[2], 3DNow
  43  - OS: Linux, BSD, Windows, MacOS X
  44
  45 copy to FTP:
  46     cp MPlayer-0.90rc5.tar.bz2 /home/ftp/MPlayer/releases/
  47     cp ChangeLog-0.90rc5 and update ChangeLog symlink
  48     md5sum MPlayer-0.90rc5.tar.bz2 > MPlayer-0.90rc5.tar.bz2.md5
  49
  50 move the older (pre)release(s) (except the last one before the current one)
  51 to ../OLD_stuff/ dir
  52
  53 Somehow get Diego to write a news entry for the release, and update the
  54 source file of dload.html and commit it. Test it, it's sometimes buggy
  55 (broken links etc). Also, update translated versions of dload.html.
  56
  57 Send a message to mplayer-announce mailing list.
  58
  59 Add the new release version to bugzilla page.
  60
  61 Update release version in #mplayer topic
  62
  63 Update project page on Freshmeat
  64
  65 Done.
  66