= 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 [TracProject/DefaultWikiPages#RepeatMerge sync]
 * Verify that [source:trunk/trac/wiki/default-pages]
   contains all pages listed in TracProject/DefaultWikiPages
 * Check all default wikipages for TracLinks to nonexistant pages/resources
 * Update [source:trunk/RELEASE] from wiki ChangeLog
 * Update [source:trunk/ChangeLog] from wiki ChangeLog
 * Update [source:trunk/INSTALL] from wiki TracInstall 
 * Update [source:trunk/UPGRADE] from wiki TracUpgrade

=== Other repository files
 * Check the [source:trunk/THANKS] file
 * Update version number in [source:trunk/setup.py] and 
   [source:trunk/trac/wiki/default-pages/WikiStart]
 * Comment out `tag_build` and `tag_svn_revision` settings in
   [source: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
       {{{
       python.exe setup.py compile_catalog
       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.
       As Babel won't work with Python 2.3, you can't rely on `bdist_wininst`
       to trigger the `compile_catalog` command, so you need to do that 
       beforehand manually, using a different version of Python (>= 2.4).
       //
   * 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