Commit 4839c1c5 authored by Jean-Baptiste Kempf's avatar Jean-Baptiste Kempf

Update the release Howto

parent 5e61e248
[ Note: this howto is probably useful to core vlc developers only ] Release HOWTO
-------------
Release HOWTO [ Note: this howto is probably useful to core vlc developers only ]
-------------
* Tests: compilation, regression tests ... * Tests: compilation, regression tests ...
...@@ -17,42 +17,36 @@ ...@@ -17,42 +17,36 @@
which case the revision goes back to zero. which case the revision goes back to zero.
* Commit * Commit
* Tag the commit * "Tag" the release
git tag -a -m "VLC Release VERSION" <VERSION>
(Create an annotated tag, you can skip -a if you used -m)
git push origin <VERSION>
* Tarballs (Use a clean tree !!!) * Tarballs (Use a clean tree !!!)
- Use 'make distcheck' to make sure all files are exported correctly - Use 'make distcheck' to make sure all files are exported correctly
- copy the tar.xz file on altair.videolan.org - copy the tar.xz file on ganesh.videolan.org
- copy the binaries files on altair.videolan.org, if possible
- generate SHA, MD5 hashes and OpenPGP signature of these files - generate SHA, MD5 hashes and OpenPGP signature of these files
(use sha*sum --binary, md5sum --binary, gpg --sign --detach --armor) (use sha*sum --binary, md5sum --binary, gpg --sign --detach --armor)
Use the ~/bin/sumandsign.sh script Use the sumandsign.sh script
* Contribs * Contribs
- Put a copy of the libraries or git snapshot in vlc-X.X.X/contrib - Put a copy of the libraries or git snapshot in ftp://ftp.videolan.org/pub/contrib/
- Put the relevant win32 contrib package - Put the relevant win32 and Mac OS contrib package
- Update developers.v.o/vlc and www.v.o/vlc/download-sources.html - Update s.v.o/vlc and www.v.o/vlc/download-sources.html
* Win32 Packages * Win32 Packages
- configure using the extras/package/win32/configure.sh script - configure using the extras/package/win32/configure.sh script
- move to altair and generate md5 plus SHA1 hashes and gpg signature of these files - copy the packages files on ganesh.videolan.org
(c.f. Tarballs) - copy the vlc-2.0.4 and symbols-2.0.4 to balthazar for stacktraces
* OS X packages * Mac OS X packages
- configure using ./configure --enable-macosx - configure using the extras/package/macosx/configure.sh script
- compile the source on both a PowerPC and an Intel-based Mac. Don't try to - compile the source on both a PowerPC and an Intel-based Mac.
cross-compile for either platform. Don't forget the framework.
- use extras/package/macosx/ub.sh to create a Universal Binary. - use extras/package/macosx/ub.sh to create a Universal Binary.
- move to altair and generate md5 plus SHA1 hashes and gpg signature of these files - use extras/package/macosx/codesign.sh to sign it.
(c.f. Tarballs) - copy the packages files on ganesh.videolan.org
* Commit changes ... it never works the first time
* "Tag" the release * Sign all the files and move the signed files on /opt/ftp/pub/videolan/vlc/X.X.X
git tag -a -m "VLC Release VERSION" <VERSION>
(Create an annotated tag, you can skip -a if you used -m)
git push origin <VERSION>
* Move the signed files from altair to ganesh, on /opt/ftp/pub/videolan/vlc/X.X.X
- At first block access to this directory by http or ftp. Only authorize rsync. - At first block access to this directory by http or ftp. Only authorize rsync.
This is to avoid leak as some journalists and forums seem to watch the ftp. This is to avoid leak as some journalists and forums seem to watch the ftp.
- Update the "last" symlink - Update the "last" symlink
...@@ -62,6 +56,7 @@ ...@@ -62,6 +56,7 @@
- create a /vlc/release/X.X.X page - create a /vlc/release/X.X.X page
- add a news item to news.msg - add a news item to news.msg
- update the front page OS dependant screenshots if the interface changed. - update the front page OS dependant screenshots if the interface changed.
- update the md5
* "Check for updates" functionality * "Check for updates" functionality
- edit update.videolan.org/vlc/status - edit update.videolan.org/vlc/status
...@@ -77,26 +72,21 @@ ...@@ -77,26 +72,21 @@
* Update the wiki * Update the wiki
- edit http://wiki.videolan.org/Template:VLC:latest_version - edit http://wiki.videolan.org/Template:VLC:latest_version
* Announce on www.freshmeat.net (let jb or sam do it) * Announce on www.freecode.com (let jb or sam do it, if you lack the account)
- you need a freshmeat account - go to https://freecode.com/projects/vlc/
- go to http://www.freshmeat.net/projects/vlc/ - chose "Submit a release" in the right menu, in "Administration"
- chose "Submit a release" in the right menu - Do the steps and wait (the update can take several hours)
- fill out all the info and submit
- the update can take several hours
* Announce on VersionTracker
- ask Meuuh
* Announce on twitter and facebook... * Announce on Twitter, Facebook and G+
Unfortunately, those are more followed than the other means Unfortunately, those are more followed than the all other mediums combined
* Announce email and forum topic * Announce email and forum topic
- write something along the lines of previous releases - Write something along the lines of previous releases
- post in videolan-announce (moderated), vlc et vlc-devel - Post in videolan-announce (moderated), vlc et vlc-devel
You are advised to add the author list for this version using You are advised to add the author list for this version using
'git shortlog -s PREVIOUS_VERSION..VERSION' 'git shortlog -s PREVIOUS_VERSION..VERSION'
And to add git diff --stat PREVIOUS_VERSION..VERSION if it's relevant. And to add git diff --stat PREVIOUS_VERSION..VERSION if it's relevant.
You can play a bit with git to show the piece of information that may be You can play a bit with git to show the piece of information that may be
interesting. interesting.
- add a sticky thread in the "General VLC media player discussion" forum - Add a sticky thread in the "General VLC media player discussion" forum
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment