2001-11-13 13:11:27 +01:00
|
|
|
[ Note: this howto is probably useful to core vlc developers only ]
|
|
|
|
|
|
|
|
Release HOWTO
|
2005-11-22 11:02:46 +01:00
|
|
|
-------------
|
|
|
|
|
2008-05-20 22:37:32 +02:00
|
|
|
* Tests: compilation, regression tests ...
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2008-03-31 15:41:17 +02:00
|
|
|
* Changes on the git repository
|
2005-11-22 11:02:46 +01:00
|
|
|
- update the version number everywhere it's needed
|
2007-07-20 17:50:43 +02:00
|
|
|
· configure.ac
|
2008-09-14 23:42:10 +02:00
|
|
|
- update the NEWS files, as well as the Trac database.
|
|
|
|
read all the commits and add important things to the NEWS file
|
2008-05-20 22:37:32 +02:00
|
|
|
- update the milestones info on https://trac.videolan.org/vlc
|
2005-11-21 20:59:32 +01:00
|
|
|
- Add a note about the matching contrib package in INSTALL.win32
|
2008-05-20 20:20:32 +02:00
|
|
|
- Update OpenGPG key embedded in include/vlc_update.h if needed
|
|
|
|
- Increase the libvlccore and libvlc revisions in src/Makefile.am
|
2008-05-20 22:37:32 +02:00
|
|
|
_if_and_only_if_ the ABI number has not been increased instead, in
|
|
|
|
which case the revision goes back to zero.
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2002-04-06 07:54:10 +02:00
|
|
|
* Commit
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2005-11-21 20:47:45 +01:00
|
|
|
* Tarballs (Use a clean tree !!!)
|
2005-11-22 11:02:46 +01:00
|
|
|
- Use 'make distcheck' to make sure all files are exported
|
2005-12-12 19:14:23 +01:00
|
|
|
correctly
|
2008-05-20 20:20:32 +02:00
|
|
|
- copy the tar.bz2 file on ftp.videolan.org in
|
2005-11-22 11:33:45 +01:00
|
|
|
/opt/ftp/pub/videolan/testing/vlc-X.X.X/
|
2008-05-20 22:37:32 +02:00
|
|
|
- generate SHA1 plus md5 hashes and gpg signature of these files
|
2008-05-18 01:39:28 +02:00
|
|
|
(use gpg --sign --detach --armor)
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2005-11-21 20:59:32 +01:00
|
|
|
* Contribs
|
2008-03-31 15:41:17 +02:00
|
|
|
- Put a copy of the libraries or git snapshot in vlc-X.X.X/contrib
|
2005-11-21 20:59:32 +01:00
|
|
|
- Put the relevant win32 contrib package
|
|
|
|
- Update developers.v.o/vlc and www.v.o/vlc/download-sources.html
|
|
|
|
|
2005-11-21 20:47:45 +01:00
|
|
|
* BeOS Packages
|
2005-11-22 11:02:46 +01:00
|
|
|
Information on building: http://developers.videolan.org/vlc/beos-compile.html
|
2007-12-14 18:53:27 +01:00
|
|
|
Configure with --enable-update-check
|
2005-11-22 11:02:46 +01:00
|
|
|
Build in the "buildbeos" chroot on altair.
|
2005-11-22 11:33:45 +01:00
|
|
|
# add the .zip files to /opt/ftp/pub/videolan/testing/vlc-X.X.X/beos/
|
2008-05-20 22:37:32 +02:00
|
|
|
generate md5 plus SHA1 hashes and gpg signature of these files
|
|
|
|
(use gpg --sign --detach --armor)
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2005-11-21 20:47:45 +01:00
|
|
|
* Win32 Packages
|
2008-05-20 22:37:32 +02:00
|
|
|
make the packages using the nightly builds configure/options/... , don't
|
|
|
|
forget --enable-update-check
|
|
|
|
don't forget to test the installer and uninstaller (the first 0.8.4
|
|
|
|
uninstaller was broken ... kind of suxxs)
|
2005-11-22 11:33:45 +01:00
|
|
|
add the .zip and .exe files to /opt/ftp/pub/videolan/testing/vlc-X.X.X/win32/
|
2008-05-20 22:37:32 +02:00
|
|
|
generate md5 plus SHA1 hashes and gpg signature of these files
|
|
|
|
(use gpg --sign --detach --armor)
|
2002-04-06 07:54:10 +02:00
|
|
|
|
2005-11-22 11:02:46 +01:00
|
|
|
* OS X packages
|
2008-05-20 22:37:32 +02:00
|
|
|
Information on compilation: wiki.videolan.org/OSXCompile
|
|
|
|
configure with --enable-update-check
|
|
|
|
compile the source on both a PowerPC and an Intel-based Mac. Don't try to
|
|
|
|
cross-compile for either platform. Don't forget the framework.
|
|
|
|
use extras/package/macosx/ub.sh to create a Universal Binary. Test it on
|
|
|
|
PowerPC and Intel-based Macs.
|
|
|
|
add the .dmg files to /opt/ftp/pub/videolan/testing/vlc-X.X.X/macosx/
|
|
|
|
Nomenclature is vlc-X.X.X-$(PLATFORM).dmg respectively
|
|
|
|
vlc-plugin-X.X.X-$(PLATFORM).dmg and vlckit-X.X.X-$(PLATFORM).dmg.
|
|
|
|
Don't put any platform for the UB package.
|
|
|
|
generate md5 plus SHA1 hashes and gpg signature of these files
|
|
|
|
(use gpg --sign --detach --armor)
|
2005-11-22 11:02:46 +01:00
|
|
|
|
2005-11-21 20:47:45 +01:00
|
|
|
* Commit changes ... it never works the first time
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2005-11-21 20:47:45 +01:00
|
|
|
* "Tag" the release
|
2008-03-31 15:41:17 +02:00
|
|
|
|
2008-03-31 15:52:34 +02:00
|
|
|
git tag -a -m "VLC Release VERSION" <VERSION>
|
2008-03-31 15:41:17 +02:00
|
|
|
(Create an annotated tag, you can skip -a if you used -m)
|
2008-03-31 15:52:34 +02:00
|
|
|
git push origin <VERSION>
|
2008-03-31 15:41:17 +02:00
|
|
|
|
2008-05-20 22:37:32 +02:00
|
|
|
(You are advised to play with it on the sandrox.git if you feel
|
|
|
|
uncomfortable)
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2008-05-20 22:37:32 +02:00
|
|
|
* Move /opt/ftp/pub/videolan/testing/vlc-X.X.X to
|
|
|
|
/opt/ftp/pub/videolan/vlc/X.X.X
|
|
|
|
- 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.
|
2005-12-14 23:57:31 +01:00
|
|
|
- Update the "latest" symlink
|
2005-11-22 11:33:45 +01:00
|
|
|
|
2005-11-21 20:47:45 +01:00
|
|
|
* Update the website
|
|
|
|
- edit the /index.php /vlc/*.php pages
|
|
|
|
- add a news item to news.msg
|
2008-07-07 00:14:18 +02:00
|
|
|
- update the front page OS dependant screenshots if the interface changed.
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2007-04-19 19:36:34 +02:00
|
|
|
* "Check for updates" functionality
|
|
|
|
- add /opt/ftp/pub/videolan/vlc/X.X.X/vlc-X.X.X-announce
|
|
|
|
- edit update.videolan.org/vlc/status.xml
|
|
|
|
|
2007-04-19 19:45:30 +02:00
|
|
|
* Mirrors
|
|
|
|
- Forwarn the mirror admins
|
2008-05-20 22:37:32 +02:00
|
|
|
- Update the list of files for the mirror check
|
|
|
|
(/var/www/local/mirrors.v.o/files)
|
|
|
|
- Disable mirrors which haven't synced yet and possibly ganesh if there are
|
2008-08-26 00:15:59 +02:00
|
|
|
enough other mirrors (see http://mirrors.videolan.org/release.html)
|
2007-04-19 19:45:30 +02:00
|
|
|
|
2008-05-20 22:37:32 +02:00
|
|
|
* Update the wiki
|
2007-05-21 16:43:48 +02:00
|
|
|
- edit http://wiki.videolan.org/Template:VLC:latest_version
|
2008-05-20 22:37:32 +02:00
|
|
|
- put the respective NEWS page to wiki.videolan.org/Changelog/X.X.X
|
|
|
|
- announce the release on the Main Page
|
2007-05-21 16:43:48 +02:00
|
|
|
|
2005-11-21 20:47:45 +01:00
|
|
|
* Announce on www.gnome.org
|
|
|
|
- click on "Get more software"
|
|
|
|
- click on "Edit an existing map entry"
|
|
|
|
- look for the 'vlc' package
|
|
|
|
- update the version number and other info and submit
|
2008-05-20 22:37:32 +02:00
|
|
|
- the change is instantaneous
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2005-11-22 11:02:46 +01:00
|
|
|
* Announce on www.freshmeat.net (let sam do it)
|
2005-11-21 20:47:45 +01:00
|
|
|
- you need a freshmeat account
|
|
|
|
- go to http://www.freshmeat.net/projects/vlc/
|
2008-05-20 22:37:32 +02:00
|
|
|
- click on the release's branch (i.e. Stable)
|
|
|
|
- chose "add release" in the drop-down menu
|
2005-11-21 20:47:45 +01:00
|
|
|
- fill out all the info and submit
|
|
|
|
- the update can take several hours
|
2002-05-24 00:33:44 +02:00
|
|
|
|
2005-11-21 20:47:45 +01:00
|
|
|
* Announce on VersionTracker
|
|
|
|
- ask Meuuh
|
2001-11-13 13:11:27 +01:00
|
|
|
|
2008-08-26 00:15:59 +02:00
|
|
|
* Announce email and forum topic
|
2005-11-21 20:47:45 +01:00
|
|
|
- write something along the lines of previous releases
|
|
|
|
- post in videolan-announce (moderated), vlc et vlc-devel
|
2008-05-20 22:37:32 +02:00
|
|
|
You are advised to add the author list for this version using
|
|
|
|
'git shortlog -s PREVIOUS_VERSION..VERSION'
|
2008-03-31 15:52:34 +02:00
|
|
|
And to add git diff --stat PREVIOUS_VERSION..VERSION if it's relevant.
|
2008-05-20 22:37:32 +02:00
|
|
|
You can play a bit with git to show the piece of information that may be
|
|
|
|
interesting.
|
2005-11-21 20:47:45 +01:00
|
|
|
- add a sticky thread in the "General VLC media player discussion" forum
|
2005-11-22 11:02:46 +01:00
|
|
|
|