= Checklist of things to do before a release =

A simple reminder list:

 * Verify that [source:trunk/wiki-default/ 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 [source:trunk/RELEASE] from wiki ({{{ w3m -dump -cols 74 http://... > RELEASE}}} )
 * Check the [source:trunk/THANKS#latest THANKS] file
 * Update the ChangeLog page as well as the [source:trunk/ChangeLog#latest ChangeLog] file
 * Update TracInstall and the [source:trunk/INSTALL#latest INSTALL] and [source:trunk/UPGRADE#latest UPGRADE] files
 * Update version number (in [source:trunk/setup.py#latest setup.py] and [source:trunk/wiki-default/WikiStart#latest 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; [[br]]
       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