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​
• Comment out tag_build and tag_svn_revision settings in trunk/setup.cfg​

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 a .tar.gz, with the proper LF line endings.
  • On Windows:

    python setup.py egg_info sdist
    

    in order to get the files in a .zip, with the proper CRLF line endings. Verify with zipinfo that the content is OK as once the templates were missing…
    Note: egg_info before sdist, as otherwise data files will be missing; whether this is needed or not depends 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.
• Build Windows installer
  • .exe win32 installer

    python23.exe setup.py bdist_wininst
    

    Note: It is important to 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.
• Smoke test:
  • create an environment with trac-admin, test it with tracd
  • upgrade an environment created with the previous release' trac-admin, test it with tracd

Finalize the release

• Tag/copy version in subversion
• Upload to ​http://ftp.edgewall.org/pub/trac
• Post on Trac-users, Trac-dev (all releases) and Trac-announce (only for non-beta releases)
• Update TracDownload
• Test easy_install Trac

• Update Freshmeat entry(?)
• Update PyPi entry(?)

---

See also: TracDev