annotate DOCS/tech/release-howto.txt @ 34234:4ec96d5d2e4c

build: drop releaseclean target The target is supposed to remove files that are created during the XML build process without removing the generated documentation. Unfortunately, it does not work as expected and is not worth the extra complication.
author diego
date Mon, 07 Nov 2011 19:54:38 +0000
parents e3247c8716f8
children d8ab83aa014b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12781
a12a9e749438 updates, corrections, wording, spelling
diego
parents: 10389
diff changeset
1 How to make an MPlayer release
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
3
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
4 preparations:
32473
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
5 - Announce the intent to create a release branch on mailing lists and IRC.
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
6 - Ask translators to get their languages synchronized.
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
7 - Update the Changelog.
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
8 - Identify regressions or other serious issues, fix or revert (on the branch)
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
9 as needed so the release is of good quality.
15203
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
10 - Find a codename for the release
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
11
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
12 create the release tree:
28167
4c9698666a4c Remove/fix ancient CVS references.
diego
parents: 15231
diff changeset
13 - tag Subversion with release name
29035
dc02213118a4 misc updates
diego
parents: 28167
diff changeset
14 - Add a VERSION file with the release version to the root of the source tree.
15203
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
15 - update release.sh script with version number
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
16 ***the following steps are done automatically by release.sh script***
28167
4c9698666a4c Remove/fix ancient CVS references.
diego
parents: 15231
diff changeset
17 - checkout the mplayer src tree
4c9698666a4c Remove/fix ancient CVS references.
diego
parents: 15231
diff changeset
18 - check out FFmpeg subdirs
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
19 - remove obsolete DOCS translations, help files
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
20
34234
4ec96d5d2e4c build: drop releaseclean target
diego
parents: 32473
diff changeset
21 - build the HTML docs from XML sources, then clean up
15203
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
22
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
23 release the tree:
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
24 cd ..
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
25 mv main MPlayer-0.90rc5
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
26 tar -cf MPlayer-0.90rc5.tar MPlayer-0.90rc5
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
27 bzip2 -9 MPlayer-0.90rc5.tar
15203
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
28 ***end of part done by release.sh**
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
29
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
30 test it (download to your local machine, extract, compile, run)
29035
dc02213118a4 misc updates
diego
parents: 28167
diff changeset
31 - compilers: gcc 4.x, gcc 3.x, gcc 2.95, MinGW, Cygwin
15203
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
32 - architectures: PPC, AMD64, x86 with MMX[2], SSE[2], 3DNow
29035
dc02213118a4 misc updates
diego
parents: 28167
diff changeset
33 - OS: Linux, BSD, Windows, Mac OS X
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
34
12781
a12a9e749438 updates, corrections, wording, spelling
diego
parents: 10389
diff changeset
35 copy to FTP:
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
36 cp MPlayer-0.90rc5.tar.bz2 /home/ftp/MPlayer/releases/
32473
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
37 cp Changelog-0.90rc5 and update Changelog symlink
15203
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
38 md5sum MPlayer-0.90rc5.tar.bz2 > MPlayer-0.90rc5.tar.bz2.md5
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
39
32473
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
40 Write a news entry for the release, update the links in dload.html. Test it,
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
41 sometimes links are broken. Do not forget the translations.
10389
5e2cc92a4170 to make alex happy
arpi
parents:
diff changeset
42
32473
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
43 Send the release notes as a mail to the mplayer-announce mailing list.
14271
1cc5c037e28a Updated with a reminder for mplayer-announce
rtognimp
parents: 12850
diff changeset
44
15203
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
45 Add the new release version to bugzilla page.
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
46
32473
e3247c8716f8 Update release instructions to be more in line with current practice.
diego
parents: 30633
diff changeset
47 Update release version in #mplayer and #mplayerdev topics.
15203
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
48
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
49 Update project page on Freshmeat
72bde716c1b8 First attempt to bring this howto closer to reality
rtognimp
parents: 14271
diff changeset
50
12781
a12a9e749438 updates, corrections, wording, spelling
diego
parents: 10389
diff changeset
51 Done.