''This is work in progress and needs to be completed!''
* Update the lists of files below, adding new engine data files and such
=== Branching for
1.4.x ===* Create a branch for the 1. 4.x releases from master, named branch-1- 4** <code>git checkout -b branch-1- 4 master</code>* Increase version on branch-1- 4 to 1. 4.0pre (using <code>devtools/update-version.pl</code>; see below), and commit** <code>devtools/update-version.pl 1 4 0 pre</code>** <code>git commit -m "RELEASE: This is 1. 4.0pre" -a</code>* Create annotated tag desc/1. 4.0pre on that commit and push** <code>git tag -m "Mark 1. 4.0pre" desc/1. 4.0pre</code>** <code>git push origin tag desc/1. 4.0pre branch-1- 4:branch-1- 4</code>* Increase version on master to 1. 5.0git, and commit
** <code>git checkout master</code>
** <code>devtools/update-version.pl 1
5 0 git</code>** <code>git commit -m "RELEASE: This is 1. 5.0git" -a</code>* Create annotated tag desc/1. 5.0git on that commit and push** <code>git tag -m "Mark 1. 5.0git" desc/1. 5.0git</code>** <code>git push origin tag desc/1. 5.0git master</code>
=== Testing ===
* Identify release critical (show stopper) bugs and get people to fix them.
* Identify other important bugs and get people to fix them.
=== Preparing the source ===
* You have to update the versions in all relevant files. There is a script, <code>devtools/update-version.pl</code> meant to help you with this. It will generate/update the following files:
* Review the following port specific files for version updates:
gp2x/build/README-GP2X ** backends/platform/gp2x/build/README -GP2X.html ** backends/platform/ps2/READ_PS2. TXT
* Review the release dates in the following port specific files:
* Make sure package descriptions are up-to-date:
* Create MSVC project files in the release branch (for example branch-1-
4-0, where the tarballs are created from)
** make ideprojects
** git commit -m "DISTS: Generated Code::Blocks and MSVC project files"
** And last but not least don't forget to push the results to our github repo via "git push"
* Make source tarballs,
post them in the SF.net FRS.** There is a script <code>devtools/dist-scummvm.sh</code>, which does this automatically.
** Make sure that porters have write access to the release folder on FRS: <code>chmod 775 <folder></code>
=== Branching for
1.4.0 ===* Create a branch for 1. 4.0 from branch-1- 4, named branch-1- 4-0** <code>git checkout -b branch-1- 4-0 branch-1- 4</code>* Increase version on branch-1- 4-0 to 1. 4.0 and commit, push** <code>devtools/update-version.pl 1 4 0</code>** Manually edit backends/platform/maemo/debian/changelog to reflect correct release date for 1. 4.0 entry** <code>git commit -m "RELEASE: This is 1. 4.0" -a</code>** <code>git push origin branch-1- 4-0:branch-1- 4-0</code>
=== Binaries ===
* Get porters to make binaries.
** Porter must follow our filename convention, which goes like this: "scummvm-VERSION-PORT.EXTENSION". For example: "scummvm-1.1.0-macosx.dmg". Do '''not''' use special names like "EScummVM" or "ScummVMDS". The only exclusion from this requirement is Debian.
** Porters should pass "--enable-release" to configure in case their port is using the configure/make based build system. If their port is not using the configure/make based build system they should make sure they properly define RELEASE_BUILD when compiling their release binary.
** Here is a list of files porters should include in their release archives:
*** README (generic ScummVM one)
*** scummmodern.zip (from gui/themes directory) (if your port uses new GUI)
*** scummclassic.zip (from gui/themes directory) (if your port uses new GUI)
*** translations.dat (from gui/themes directory)
*** pred.dic (from dists directory)
*** kyra.dat (from dists/engine-data)
*** queen.tbl (from dists/engine-data)
*** sky.cpt (from dists/engine-data)
*** lure.dat (from dists/engine-data)
*** drascula.dat (from dists/engine-data)
*** teenagent.dat (from dists/engine-data)
hugo.dat (from dists/engine-data)
*** toon.dat (from dists/engine-data)
*** your build binary
*** your build-specific README (optional)
can upload binaries via SCP or SFTP: <code>scp FILENAME SFNET_USERNAME,email@example.com:/home/frs/project/s/sc/scummvm/scummvm/X.Y.Z/</code> ** More details on the upload process and the file release system in general: https://sourceforge. net/apps/trac/sourceforge/wiki/Release%20files%20for%20download
* Update the website internally (i.e. update the version in the repository), but do not yet put these changes online.
** Edit <code>include/config.inc.php</code> to update the global version.
** Update <code>data/downloads.xml</code>.
** Add a news item.
default platform packages on sf. net FRS* Set the OS for the newly uploaded binaries (click on the (i) next to each binary).** -win32.exe as Windows binary** -macosx.dmg as Mac binary** .tar.bz2 as Linux, FreeBSD and Other binary** -solaris-x86.tar.gz as Solaris binary
=== Tagging 1. 4.0 === * When 1. 4. 0 is ready to be announced, make a permanent v1.4.0 tag in git to mark the release, and delete the 1.4.0 branch ** <code>git checkout branch-1 -4-0</code> ** <code>git tag -m "Tag v1. 4.0 " v1. 4. 0</code> ** <code>git push origin tag v1.4.0</code> * Also increase the version number on the 1.4.x branch to 1.4.1pre ** <code>git checkout branch-1-4</code> ** <code>devtools/update- version.pl 1 4 1 pre</code> ** <code>git commit -m "RELEASE: This is 1. 4. 1pre" -a</code> * Create annotated tag desc/1. 4. 1pre on that commit and push ** <code>git tag - m "Mark 1. 4. 1pre" desc/1. 4. 1pre</code> ** <code>git push origin tag desc/1.4. 1pre branch-1-4:branch-1-4</code>
=== News & Notification ===
** ... more ?
* Put the updated web site online
=== Updating the wiki ===
* Add the first release field on the info box of the newly supported engines.
* Update [[Platforms]] page if status changed for some of the platforms (e.g. no release for the latest stable version). For these platforms the latest stable version info will also need to be changed if it was using the StableVersion template.
* Update the support field on the info box of the newly supported games. Also change these games from ''Unsupported Games'' category to ''Supported Games'' category.