Checklist of things to do before a release

A simple reminder list:

Check the t.e.o wiki

• Update the ChangeLog page
• Verify TracInstall and TracUpgrade

Check the source

(replace trunk below with the corresponding branches/0.1X-stable when preparing a minor releases)

Wiki related files

• If needed, do a last sync
• Verify that trunk/trac/wiki/default-pages contains all pages listed in TracProject/DefaultWikiPages
• Check all default wikipages for TracLinks to nonexistant pages/resources
• Update trunk/RELEASE from wiki ChangeLog
• Update trunk/ChangeLog​ from wiki ChangeLog
• Update trunk/INSTALL from wiki TracInstall
• Update trunk/UPGRADE from wiki TracUpgrade

Other repository files

• Check the trunk/THANKS​ file
• Update version number in trunk/setup.py​ and trunk/trac/wiki/default-pages/WikiStart​

Create dist packages

• Check out trunk (or the release branch) to a clean sandbox
• Build source tarballs:
  • On Unix: python setup.py sdist in order to get the files in the .tar.gz with the proper LF line endings
  • On Windows:
    • python setup.py egg_info, otherwise data files will be missing; whether this is really needed or not seems to be highly depending on the version of Python. With 2.4.4 it's not needed, with 2.5.4 sdist won't work even with this step (!), with 2.6.1 it is needed.
    • python setup.py sdist, in order to get the files in the .zip with the proper CRLF line endings;
      verify with zipinfo that the content is OK (once the templates were missing!)
• Build windows installer
  • python setup.py bdist_wininst — .exe win32 installer
  • use Python 2.3 to build the installer, in order to avoid dependency on MSVCR71.dll, not always available.

• Test installation on all target platforms
  • Install on a clean system. Remove any old Trac installation before testing
  • Test easy_install Trac

• Tag/copy version in subversion
• Upload to ​http://ftp.edgewall.com/
• Update TracDownload
• Post on trac and trac-announce (only trac for non-beta releases)
• Update freshmeat entry

---

See also: TracDev