Checklist of things to do before a release

A simple reminder list:

• Verify that wiki-default contains all pages listed in TracProject/DefaultWikiPages
• Check all default wikipages for TracLinks to nonexistant pages/resources
• Check that if code refactoring has been introduced, the peripheral scripts (such as trac-admin) are not broken.
• Update trunk/RELEASE from wiki ( w3m -dump -cols 74 http://... > RELEASE )
• Check the THANKS​ file
• Update the ChangeLog page as well as the ChangeLog​ file
• Update TracInstall and the INSTALL and UPGRADE files
• Update version number (in setup.py​ and wiki-default/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 RPMs: python setup.py bdist_rpm
  • 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