How to make a release

Stable releases of the OHRRPGCE have often happen rather chaotically. This article is an attempt to plan a cleaner process for future releases.

• Announce the approach of a release on the mailing list and the forums
• Declare the current nightlies to be 'release candidates
  • Wait for the testers have had enough time to find bugs in the release candidates and the developers have had time to fix them in the wip. (1-2 weeks?)
• Create the stable branch
  • First make sure to run docs/update-html.sh on the wip trunk. We frequently branch without doing this.
  • First make sure that whatsnew.txt is updated with all the appropriate info.
  • Actually create the branch. (For cleanest results it may help do do this in a brand new clean working copy)
  • change the release codename in codename.txt
  • Test compiling in the branch.
  • Test the windows distrib.bat script in the branch.
  • Test the linux distrib.sh script in the branch.
  • Test the mac distrib-mac.sh script in the branch
    • note that the debian packaging scripts for wandering hamster will need a path adjusted.
• Declare the release stable.
  • Update dates in whatsnew.txt README-game.txt and README-custom.txt (don't forget to update whatsnew.txt on the wip trunk also!)
  • Run the distrib scripts and upload the results (upload-release.bat and upload-release.sh help with this)
  • (James Only!) run script/ohrstable.sh to update the web server symlinks to point to the newest files.
  • Update the wiki
• Double check for any fixes on the branch that still need to be copied over to the wip trunk.
• Any further fixes on the branch can go in a +1 release at some later date