1
1
=============================
2
2
Docutils_ Release Procedure
3
3
=============================
4
:Author: David Goodger; Felix Wiemann; open to all Docutils developers
5
:Authors: David Goodger; Lea Wiemann; open to all Docutils developers
5
6
:Contact: goodger@python.org
6
:Date: $Date: 2005-11-08 22:48:57 +0100 (Tue, 08 Nov 2005) $
7
:Revision: $Revision: 4020 $
7
:Date: $Date: 2008-06-10 11:56:45 +0200 (Die, 10 Jun 2008) $
8
:Revision: $Revision: 5570 $
8
9
:Copyright: This document has been placed in the public domain.
10
11
.. _Docutils: http://docutils.sourceforge.net/
13
(Steps in boldface text are *not* covered by the release script at
14
sandbox/fwiemann/release.sh. "Not covered" means that you aren't even
15
reminded of them. Note: The release.sh script needs to be updated to
16
reflect the recent move to Subversion!)
18
* **Announce a check-in freeze on Docutils-develop. Post a list of
19
major changes since the last release and ask for additions.**
23
**You may want to save this list of changes in a file
24
(e.g. CHANGES.txt) to have it at hand when you need it for posting
25
announcements or pasting it into forms.**
14
Steps in boldface text are *not* covered by the release script at
15
sandbox/infrastructure/release.sh. "Not covered" means that you aren't even
18
.. Note:: This document does not cover branching and tagging, but the
21
.. Note:: You may want to use ReleaseForge_ instead of using
22
SourceForge's file release system.
24
.. _ReleaseForge: http://releaseforge.sourceforge.net/
27
* **On the Docutils-develop mailing list, announce that the release is
28
going to be made, update the release notes and ask for additions.**
30
* **Announce a check-in freeze on Docutils-develop.**
27
32
* Change ``__version_details__`` in docutils/docutils/__init__.py to
28
33
"release" (from "repository").
68
73
(c) Repeat step b) for all supported Python versions.
70
75
* Run the _`test suite` from the expanded archive directory with all
71
supported Python versions: ``cd test ; python -u alltests.py``.
76
supported Python versions on all available platforms (GNU/Linux, Mac
79
cd test ; python -u alltests.py
73
81
* Add a directory X.Y.Z (where X.Y.Z is the current version number
74
82
of Docutils) in the webroot (i.e. the ``htdocs/`` directory).
119
127
:File Type: Source .gz
120
128
:Processor Type: Platform-Independent
121
129
:Release Notes: <insert README.txt file here>
122
:Change Log: <insert summary from CHANGES.txt_>
130
:Change Log: <insert current release notes here>
124
132
Also check the "Preserve my pre-formatted text" box.
143
151
* **Send announcement email to:**
145
* docutils-develop@lists.sourceforge.net (also announcing the end
146
of the check-in freeze)
153
* docutils-develop@lists.sourceforge.net (also announcing the end of
147
155
* docutils-users@lists.sourceforge.net
148
156
* doc-sig@python.org
149
157
* python-announce@python.org