view DOCS/tech/release-howto.txt @ 30811:50e0f6942e43

Implement Win32 mutexes. Implement Win32 mutexes; they used to just be mapped on top of events, which is not the same thing at all. The implementation is pretty much the obvious one, similar to the current critical section implementation and the semaphore implementation; a single lock count protected by a pthread mutex, and an event lockers can sleep on to know when the mutex is available. Also make CreateMutexA and ReleaseMutex available even if QuickTime codecs support is not configured.

How to make an MPlayer release
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

preparations:
- Announce release target date on dev-eng and #mplayerdev
- Ask the DOCS maintainers to commit their final changes, check if
  all docs are up to date, etc.
- Verify man page, remove obsolete options, mention new ones.
- Ask translation maintainers to update their help_mp*.h file.
- Update the ChangeLog file (according to Subversion log), ask other developers
  to verify their parts, etc. Ask Diego to spellcheck it.
- Consult at -dev-eng about unstable parts of the code which should be
  disabled for the release.
- Find a codename for the release

create the release tree:
- tag Subversion with release name
- Add a VERSION file with the release version to the root of the source tree.
- update release.sh script with version number
***the following steps are done automatically by release.sh script***
- checkout the mplayer src tree
- check out FFmpeg subdirs
- remove obsolete DOCS translations, help files

- build the HTML docs from XML sources, then clean up:
    make html-chunked; make releaseclean

release the tree:
    cd ..
    mv main MPlayer-0.90rc5
    tar -cf MPlayer-0.90rc5.tar MPlayer-0.90rc5
    bzip2 -9 MPlayer-0.90rc5.tar
***end of part done by release.sh**

test it (download to your local machine, extract, compile, run)
 - compilers: gcc 4.x, gcc 3.x, gcc 2.95, MinGW, Cygwin
 - architectures: PPC, AMD64, x86 with MMX[2], SSE[2], 3DNow
 - OS: Linux, BSD, Windows, Mac OS X

copy to FTP:
    cp MPlayer-0.90rc5.tar.bz2 /home/ftp/MPlayer/releases/
    cp ChangeLog-0.90rc5 and update ChangeLog symlink
    md5sum MPlayer-0.90rc5.tar.bz2 > MPlayer-0.90rc5.tar.bz2.md5

move the older (pre)release(s) (except the last one before the current one)
to ../OLD_stuff/ dir

Somehow get Diego to write a news entry for the release, and update the
source file of dload.html and commit it. Test it, it's sometimes buggy
(broken links etc). Also, update translated versions of dload.html.

Send a message to mplayer-announce mailing list.

Add the new release version to bugzilla page.

Update release version in #mplayer topic

Update project page on Freshmeat

Done.