2001-08-22 18:43:42 -04:00
|
|
|
|
PEP: 101
|
|
|
|
|
Title: Doing Python Releases 101
|
|
|
|
|
Version: $Revision$
|
|
|
|
|
Last-Modified: $Date$
|
2008-01-17 19:31:21 -05:00
|
|
|
|
Author: barry@python.org (Barry A. Warsaw), guido@python.org (Guido van Rossum)
|
2001-08-22 18:43:42 -04:00
|
|
|
|
Status: Active
|
|
|
|
|
Type: Informational
|
|
|
|
|
Created: 22-Aug-2001
|
|
|
|
|
Post-History:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Abstract
|
|
|
|
|
|
2003-07-31 11:12:25 -04:00
|
|
|
|
Making a Python release is an arduous process that takes a
|
2001-08-22 18:43:42 -04:00
|
|
|
|
minimum of half a day's work even for an experienced releaser.
|
|
|
|
|
Until recently, most -- if not all -- of that burden was borne by
|
|
|
|
|
Guido himself. But several recent releases have been performed by
|
|
|
|
|
other folks, so this PEP attempts to collect, in one place, all
|
2001-10-24 19:18:46 -04:00
|
|
|
|
the steps needed to make a Python release. It is organized as a
|
|
|
|
|
recipe and you can actually print this out and check items off as
|
|
|
|
|
you complete them.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
How to Make A Release
|
|
|
|
|
|
|
|
|
|
Here are the steps taken to make a Python release. Some steps are
|
|
|
|
|
more fuzzy than others because there's little that can be
|
|
|
|
|
automated (e.g. writing the NEWS entries). Where a step is
|
2008-01-17 19:31:21 -05:00
|
|
|
|
usually performed by An Expert, the role of that expert is given.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
Otherwise, assume the step is done by the Release Manager (RM),
|
2008-01-17 19:31:21 -05:00
|
|
|
|
the designated person performing the release. The roles and their
|
|
|
|
|
current experts are:
|
|
|
|
|
|
|
|
|
|
* WE = Windows: Martin von Loewis
|
|
|
|
|
* ME = Mac: Ronald Oussoren
|
|
|
|
|
* DE = Documentation: Fred Drake
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
|
|
|
|
XXX: We should include a dependency graph to illustrate the steps
|
|
|
|
|
that can be taken in parallel, or those that depend on other
|
|
|
|
|
steps.
|
|
|
|
|
|
|
|
|
|
We use the following conventions in the examples below. Where a
|
2008-01-17 19:31:21 -05:00
|
|
|
|
release number is given, it is of the form X.YaZ, e.g. 2.6a3 for
|
|
|
|
|
Python 2.6 alpha 3, where "a" == alpha, "b" == beta, "c" ==
|
2003-07-31 10:21:07 -04:00
|
|
|
|
release candidate.
|
|
|
|
|
|
|
|
|
|
Final releases are named "releaseXY". The branch tag is
|
|
|
|
|
"releaseXY-maint" because this will point to the long lived
|
|
|
|
|
maintenance branch. The fork tag on the trunk is
|
2001-12-21 15:47:12 -05:00
|
|
|
|
"releaseXY-fork". If a micro release number is used, then we'll
|
|
|
|
|
say X.Y.MaZ.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2003-07-24 22:34:02 -04:00
|
|
|
|
Note: This document has been updated to reflect the more
|
2008-01-17 19:31:21 -05:00
|
|
|
|
streamlined procedures used to release Python 2.6 (including the
|
2003-07-24 22:34:02 -04:00
|
|
|
|
alphas and betas).
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2008-02-21 07:00:38 -05:00
|
|
|
|
We recommend that you use the welease tool, from
|
|
|
|
|
|
|
|
|
|
http://svn.python.org/projects/sandbox/trunk/welease/
|
|
|
|
|
|
|
|
|
|
It helps verifying that certain (not yet all) mechanic editing
|
|
|
|
|
has not been forgotten, and invokes svn and tar commands
|
|
|
|
|
automatically. This guide will indicate which steps are supported
|
|
|
|
|
by welease.
|
|
|
|
|
|
2003-07-24 22:34:02 -04:00
|
|
|
|
___ Impose a check-in freeze. Send a message to
|
|
|
|
|
python-dev@python.org telling people not to make any check-ins
|
|
|
|
|
on the tree until further notice.
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
At this point, nobody except the RM or his duly assigned agents
|
|
|
|
|
should make any commits to the branch. The assigned agents are
|
|
|
|
|
either from the list above or by coordination as necessary. If
|
|
|
|
|
a checkin needs to made, make sure to state in the checkin
|
|
|
|
|
comment that the change was approved. If the RM screwed up and
|
|
|
|
|
some desperate last minute change to the branch is necessary, it
|
|
|
|
|
can mean extra work for others. So try to avoid this!
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
|
|
|
|
___ Log into irc.freenode.net and join the #python-dev channel.
|
|
|
|
|
|
|
|
|
|
You probably need to coordinate with other people around the
|
|
|
|
|
world. This IRC channel is where we've arranged to meet.
|
|
|
|
|
|
|
|
|
|
___ The most important thing to do is to update the Misc/NEWS file.
|
2008-01-17 19:31:21 -05:00
|
|
|
|
This step can be pretty tedious, so it's best to get to it
|
|
|
|
|
immediately after making the branch, or even before you've made
|
|
|
|
|
the branch.
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
Add high level items new to this release. E.g. if we're releasing
|
|
|
|
|
2.6a3, there must be a section at the top of the file explaining
|
|
|
|
|
"What's new in Python 2.6 alpha 3". It will be followed by a
|
|
|
|
|
section entitled "What's new in Python 2.6 alpha 2".
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
|
|
|
|
Note that you /hope/ that as developers add new features to the
|
|
|
|
|
trunk, they've updated the NEWS file accordingly. You can't be
|
2008-01-17 19:31:21 -05:00
|
|
|
|
positive, so double check. It helps to verify with the Windows
|
|
|
|
|
and Mac experts.
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
|
|
|
|
This command should help you:
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% svn log -r '{YYYY-MM-DD}:HEAD' > /tmp/news.txt
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
IOW, you're printing out all the svn log entries from the
|
|
|
|
|
previous release date until now. You can then troll through the
|
2003-07-24 22:34:02 -04:00
|
|
|
|
news.txt file looking for interesting things to add to NEWS.
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ For major releases (e.g. 2.6 final), move any historical "what's
|
2003-07-29 19:10:41 -04:00
|
|
|
|
new" entries from Misc/NEWS to Misc/HISTORY.
|
|
|
|
|
|
2003-12-04 19:45:14 -05:00
|
|
|
|
___ Check with the IDLE maintainer to be sure that
|
|
|
|
|
Lib/idlelib/NEWS.txt has been similarly updated.
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ Make sure the release date is fully spelled out in
|
2008-03-01 13:36:30 -05:00
|
|
|
|
Doc/commontex/boilerplate.tex (welease). BROKEN
|
2005-09-28 00:21:36 -04:00
|
|
|
|
|
2008-02-21 07:00:38 -05:00
|
|
|
|
___ Tag and/or branch the tree for release X.YaZ (welease does tagging)
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
|
|
|
|
If you're releasing an alpha/beta/release candidate, you will
|
2008-02-21 07:00:38 -05:00
|
|
|
|
just tag the tree, AFTER you made the edits below. If you are
|
|
|
|
|
releasing a final release, you will both tag the trunk and
|
|
|
|
|
create the long-lived maintenance branch.
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
|
|
|
|
All Python development happens on the trunk. While it's
|
|
|
|
|
sometimes challenging to keep people from checking things in
|
|
|
|
|
while you're making a release, it's still preferred to creating
|
|
|
|
|
a short-lived release branch.
|
|
|
|
|
|
|
|
|
|
Practically speaking, we tag and branch just before making the
|
2008-01-17 19:31:21 -05:00
|
|
|
|
release. Branching too early causes too much merging work.
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
When making a major release (e.g., for 2.6), you should branch.
|
|
|
|
|
To create a _branch_ (e.g., release26-maint), do the following:
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ svn copy \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/trunk \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/branches/release26-maint
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
When making a minor release (e.g., for 2.6a1 or 2.6.1), you should tag.
|
|
|
|
|
To create a _tag_ (e.g., r26a1), do the following:
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
DO NOT TAG UNTIL YOU"VE MADE THE NECESSARY EDITS BELOW
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ svn copy \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/branches/release26-maint \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/tags/r26a1
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Check out a clean version of the branch into a new directory.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
You'll be doing a lot of work in this directory and you want
|
|
|
|
|
to keep it straight from your trunk working directory. E.g.
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% svn co \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/branches/release26-maint
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
___ cd release26-maint # cd into the branch directory.
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2003-07-24 22:34:02 -04:00
|
|
|
|
___ Change Include/patchlevel.h in two places, to
|
2001-09-07 14:58:47 -04:00
|
|
|
|
reflect the new version number you've just created. You'll want
|
|
|
|
|
to change the PY_VERSION macro, and one or several of the
|
|
|
|
|
version subpart macros just above PY_VERSION, as appropriate.
|
2008-02-21 07:00:38 -05:00
|
|
|
|
(checked by welease)
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2003-12-04 19:45:14 -05:00
|
|
|
|
___ IDLE maintains its own versioning and NEWS file (Lib/idlelib/NEWS.txt).
|
|
|
|
|
There should be a number of entries reflecting new development, under a
|
|
|
|
|
temporary header. Update that header to reflect IDLE's new version and
|
|
|
|
|
release date. Then update Lib/idlelib/idlever.py to show a matching
|
2008-02-21 07:00:38 -05:00
|
|
|
|
version. (checked by welease)
|
2003-12-04 19:45:14 -05:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ distutils also maintains its own versioning file
|
|
|
|
|
(Lib/distutils/__init__.py). Update this file with the Python version.
|
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
___ Change the "%define version" line of Misc/RPM/python-X.Y.spec to
|
2003-09-21 21:11:35 -04:00
|
|
|
|
the same string as PY_VERSION was changed to above. E.g.
|
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
%define version 2.6a1
|
2003-09-21 21:11:35 -04:00
|
|
|
|
|
|
|
|
|
The following line, "%define libvers", should reflect the
|
|
|
|
|
major/minor number as one would usually see in the
|
|
|
|
|
"/usr/lib/python<libvers>" directory name. E.g.
|
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
%define libvers 2.6
|
2003-09-21 21:11:35 -04:00
|
|
|
|
|
2004-05-27 01:55:55 -04:00
|
|
|
|
You also probably want to reset the %define release line
|
|
|
|
|
to '1pydotorg' if it's not already that.
|
|
|
|
|
|
2003-09-21 21:11:35 -04:00
|
|
|
|
If the new release uses a major/minor version which is
|
|
|
|
|
different than is in the name of the current
|
|
|
|
|
"Misc/RPM/python-*.spec" file, rename the file:
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% svn rename python-2.5.spec python-2.6.spec
|
|
|
|
|
% svn commit
|
2003-09-21 21:11:35 -04:00
|
|
|
|
|
|
|
|
|
___ If this is a release candidate, mail Sean <jafo@tummy.com>
|
|
|
|
|
noting the impending release, so that RPMs can be built and
|
|
|
|
|
tested.
|
|
|
|
|
|
2003-07-24 22:34:02 -04:00
|
|
|
|
___ Update the README file, which has a big banner at the top
|
|
|
|
|
proclaiming its identity.
|
2002-01-10 10:41:21 -05:00
|
|
|
|
|
2002-12-30 20:30:28 -05:00
|
|
|
|
___ If the major (first) or minor (middle) digit of the version
|
|
|
|
|
number changes, also update the LICENSE file.
|
|
|
|
|
|
|
|
|
|
___ There's a copy of the license in
|
2008-03-01 13:36:30 -05:00
|
|
|
|
Doc/commontex/license.tex; the DE usually takes care of that. BROKEN
|
2008-01-17 19:31:21 -05:00
|
|
|
|
|
|
|
|
|
___ If the minor (middle) digit of the version number changes, update:
|
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
___ Doc/tut/tut.tex (4 references to [Pp]ython26) BROKEN
|
2002-12-30 20:30:28 -05:00
|
|
|
|
|
2003-01-02 11:33:18 -05:00
|
|
|
|
___ Check the years on the copyright notice. If the last release
|
|
|
|
|
was some time last year, add the current year to the copyright
|
|
|
|
|
notice in several places:
|
|
|
|
|
|
|
|
|
|
___ README
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ LICENSE (make sure to change on trunk and the branch)
|
2003-01-02 11:33:18 -05:00
|
|
|
|
|
|
|
|
|
___ Python/getcopyright.c
|
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
___ Doc/README (at the end)
|
2006-02-11 13:28:49 -05:00
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
___ Doc/commontex/copyright.tex BROKEN
|
2003-01-02 11:33:18 -05:00
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
___ Doc/commontex/license.tex BROKEN
|
2006-02-11 13:28:49 -05:00
|
|
|
|
|
2003-01-02 12:24:01 -05:00
|
|
|
|
___ PC/python_nt.rc sets up the DLL version resource for Windows
|
|
|
|
|
(displayed when you right-click on the DLL and select
|
|
|
|
|
Properties).
|
|
|
|
|
|
|
|
|
|
___ The license.ht file for the distribution on the website
|
|
|
|
|
contains what purports to be an HTML-ized copy of the LICENSE
|
2008-03-01 13:36:30 -05:00
|
|
|
|
file from the distribution. BROKEN
|
2003-01-02 11:33:18 -05:00
|
|
|
|
|
2003-09-21 21:11:35 -04:00
|
|
|
|
___ For a final release, edit the first paragraph of
|
2003-07-21 13:34:07 -04:00
|
|
|
|
Doc/whatsnew/whatsnewXX.tex to include the actual release date;
|
2006-09-10 13:00:30 -04:00
|
|
|
|
e.g. "Python 2.5 was released on August 1, 2003."
|
2003-07-24 22:34:02 -04:00
|
|
|
|
There's no need to edit this for alpha or beta releases. Note
|
2008-01-17 19:31:21 -05:00
|
|
|
|
that Andrew Kuchling often takes care of this.
|
2001-10-24 19:18:46 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ At this point, the DE will create the formatted versions of the
|
2003-09-29 23:46:52 -04:00
|
|
|
|
documentation and push the appropriate files out to their FTP
|
|
|
|
|
locations on www.python.org. The HTML format is used to build
|
|
|
|
|
the HTML Help format for the Windows installer, but the RM
|
|
|
|
|
doesn't need this to build the source distribution. The HTML
|
|
|
|
|
Help format will typically be generated by whoever builds the
|
|
|
|
|
Windows installer.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
Once the DE is done, there can be no further checkins on the
|
2003-09-29 23:46:52 -04:00
|
|
|
|
branch in the Doc/ directory -- not even by the RM.
|
2001-11-16 16:30:25 -05:00
|
|
|
|
|
2003-09-30 00:35:01 -04:00
|
|
|
|
Building the documentation is done using the Makefile in the
|
|
|
|
|
Doc/ directory. Once all the external tools are installed (see
|
|
|
|
|
the "Documenting Python" manual for information on the required
|
|
|
|
|
tools), use these commands to build the formatted documentation
|
|
|
|
|
packages::
|
|
|
|
|
|
|
|
|
|
$ make clobber
|
|
|
|
|
...
|
|
|
|
|
$ make PAPER=a4 paperdist
|
|
|
|
|
...
|
|
|
|
|
$ make distfiles
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
The packages can be installed on the FTP server using commands
|
|
|
|
|
like these:
|
|
|
|
|
|
|
|
|
|
$ VERSION=`tools/getversioninfo`
|
2006-03-29 01:59:43 -05:00
|
|
|
|
$ TARGET=/data/python-releases/doc/$VERSION
|
|
|
|
|
$ rm *-$VERSION.tar
|
|
|
|
|
$ ssh dinsdale.python.org mkdir $TARGET
|
|
|
|
|
$ scp *-$VERSION.* dinsdale.python.org:$TARGET
|
2003-09-30 00:35:01 -04:00
|
|
|
|
|
2003-10-02 11:39:21 -04:00
|
|
|
|
___ For final releases, publish the documentation on python.org.
|
2006-10-25 00:15:39 -04:00
|
|
|
|
This must be done by someone with write access to the pydotorg
|
|
|
|
|
repository.
|
2003-10-02 11:39:21 -04:00
|
|
|
|
|
|
|
|
|
Start by creating a new directory and filling it with the
|
|
|
|
|
standard boilerplate. $VERSION is the same as for uploading the
|
|
|
|
|
documentation, above; $OLDVERSION is the most recently published
|
|
|
|
|
version on the site.
|
|
|
|
|
|
|
|
|
|
$ cd .../pydotorg/doc/
|
2006-10-25 00:15:39 -04:00
|
|
|
|
$ svn mkdir $VERSION $VERSION/download
|
2003-10-02 11:39:21 -04:00
|
|
|
|
$ cd $OLDVERSION
|
2006-10-25 00:15:39 -04:00
|
|
|
|
$ svn cp content.{html,rst,yml} index.yml nav.yml ../$VERSION
|
|
|
|
|
$ cd download
|
|
|
|
|
$ svn cp content.{html,rst,yml} index.yml nav.yml ../$VERSION/download
|
|
|
|
|
$ cd ../../$VERSION
|
|
|
|
|
|
|
|
|
|
In $VERSION/content.rst and $VERSION/download/content.rst, change:
|
|
|
|
|
|
|
|
|
|
- in the header at the top of the page, update to reflect
|
|
|
|
|
the version number and release date
|
|
|
|
|
- if the minor release number changed (for example, from 2.5
|
|
|
|
|
to 2.6), the title and link to the "What's New" document
|
|
|
|
|
(search for "whatsnew")
|
|
|
|
|
- make sure all the documents included in the package are listed
|
|
|
|
|
|
|
|
|
|
In $VERSION/index.yml and $VERSION/download/index.yml, change
|
|
|
|
|
the version number in the title.
|
|
|
|
|
|
|
|
|
|
In versions/content.rst, add an entry for the new version near
|
|
|
|
|
the top.
|
|
|
|
|
|
|
|
|
|
Use the "rst2html" command (commonly installed with docutils) to
|
|
|
|
|
ensure that the .rst files can be formatted without errors.
|
2003-10-02 11:39:21 -04:00
|
|
|
|
|
2006-09-22 00:54:25 -04:00
|
|
|
|
Log into dinsdale.python.org using SSH and unpack a copy of the
|
2003-10-02 11:39:21 -04:00
|
|
|
|
documentation into place:
|
|
|
|
|
|
2006-09-22 00:54:25 -04:00
|
|
|
|
# on dinsdale:
|
|
|
|
|
$ cd /data/ftp.python.org/pub/www.python.org/doc
|
|
|
|
|
$ bzip2 -dc /data/python-releases/doc/$VERSION/html-$VERSION.tar.bz2 \
|
|
|
|
|
| tar xf -
|
2003-10-02 11:39:21 -04:00
|
|
|
|
$ mv Python-Docs-$VERSION $VERSION
|
2003-10-06 11:24:25 -04:00
|
|
|
|
$ find $VERSION -type d | xargs chmod g+s
|
2003-10-02 11:39:21 -04:00
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
Now head back to your pydotorg checkout and commit the changes
|
|
|
|
|
so the site will be updated:
|
2003-10-02 11:39:21 -04:00
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
$ svn commit -m \
|
|
|
|
|
"Add website content for Python $VERSION documentation."
|
2003-10-02 11:39:21 -04:00
|
|
|
|
|
|
|
|
|
Point your browser at this URL and check it out:
|
|
|
|
|
|
|
|
|
|
http://www.python.org/doc/$VERSION/
|
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
There is one more change that may need to happen in the
|
|
|
|
|
top-level doc/ directory of the website content. This should
|
|
|
|
|
happen as soon as the release announcement has been made. The
|
|
|
|
|
required actions are described in a separate step of this
|
|
|
|
|
checklist.
|
2003-09-30 00:35:01 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ Ping Neal Norwitz (or anyone else with access to the PSF box
|
|
|
|
|
which runs the automated builds) to fix conflicts that arise
|
|
|
|
|
in the checked out working areas.
|
|
|
|
|
|
|
|
|
|
___ The WE grabs the HTML to build the Windows helpfile.
|
2003-09-30 00:49:33 -04:00
|
|
|
|
The HTML files are unpacked into a new src/html directory, and
|
|
|
|
|
runs this command to create the project files for MS HTML
|
|
|
|
|
Workshop:
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% python ..\Doc\tools\prechm.py -v 2.6 python26
|
2003-09-30 00:49:33 -04:00
|
|
|
|
|
2006-09-10 13:00:30 -04:00
|
|
|
|
HTML Workshop is then fired up on the created python25.hhp file,
|
2008-01-17 19:31:21 -05:00
|
|
|
|
finally resulting in an python26.chm file. He then copies the
|
2006-09-10 12:56:11 -04:00
|
|
|
|
file into the Doc directories of the build trees (once for
|
|
|
|
|
each target architecture).
|
2001-10-24 19:18:46 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ The WE then generates Windows installer files for each Windows
|
|
|
|
|
target architecture (for Python 2.6, this means x86
|
2006-09-10 12:56:11 -04:00
|
|
|
|
and AMD64). He has one checkout tree per target architecture,
|
|
|
|
|
and builds the pcbuild.sln project for the appropriate
|
|
|
|
|
architecture. He then edits Tools/msi/config.py to update
|
2006-09-10 13:00:30 -04:00
|
|
|
|
full_current_version, and runs msi.py with ActivePython 2.5.
|
2006-09-10 12:56:11 -04:00
|
|
|
|
For that to work, the following prerequisites must be met:
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
- PC\icons.mak must have been run with nmake.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2006-09-10 12:56:11 -04:00
|
|
|
|
- The cmd.exe window in which this is run must have Cygwin/bin
|
|
|
|
|
in its path (atleast for x86).
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2006-09-10 12:56:11 -04:00
|
|
|
|
- The cmd.exe window must have MS compiler tools for the target
|
|
|
|
|
architecture in its path (VS 2003 for x86, the platform
|
2008-01-17 19:31:21 -05:00
|
|
|
|
SDK for AMD64).
|
2006-09-10 12:56:11 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
The WE checksums the files (*.msi and *.chm), uploads them to
|
2006-10-25 00:15:39 -04:00
|
|
|
|
some place in the net, and emails you the location and md5sums.
|
2001-10-24 19:18:46 -04:00
|
|
|
|
|
2003-09-21 21:01:46 -04:00
|
|
|
|
___ Sean Reifschneider grabs the HTML and uses this to build the
|
|
|
|
|
Linux RPMs. Sean performs his Red Hat magic, generating a set
|
|
|
|
|
of RPMs. He uploads these files to python.org. He then sends
|
|
|
|
|
the RM a notice which includes the location and MD5 checksum of
|
|
|
|
|
the RPMs.
|
|
|
|
|
|
2003-07-24 22:34:02 -04:00
|
|
|
|
___ Time to build the source tarball. If you created a branch, be
|
|
|
|
|
sure to cd to your working directory for the branch. E.g.
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% cd .../python-26a3
|
2008-02-21 07:00:38 -05:00
|
|
|
|
(supported by welease)
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ Do a "svn update ; svn status" in this directory.
|
2001-10-24 19:18:46 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
You should not see any files. I.e. you better not have any
|
|
|
|
|
uncommitted changes in your working directory, but you may pick
|
|
|
|
|
up some of the expert's last minute changes.
|
2008-02-21 07:00:38 -05:00
|
|
|
|
(checked by welease)
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ If you've seen updates to existing files, update the svn tag:
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% svn copy \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/trunk \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/tags/r26a3
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2003-07-29 19:10:41 -04:00
|
|
|
|
If you created a maintenance branch and you've changed any files
|
|
|
|
|
since you branched, tag the tree -- in the branch -- now with
|
|
|
|
|
something like
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% svn copy \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/trunk \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/tags/r26
|
2003-07-29 19:10:41 -04:00
|
|
|
|
|
|
|
|
|
This is the tag you will use below.
|
2008-02-21 07:00:38 -05:00
|
|
|
|
(supported by welease)
|
2003-07-29 19:10:41 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Change to a neutral directory, i.e. one in which you can do a
|
2008-01-17 19:31:21 -05:00
|
|
|
|
fresh, virgin, svn export of the branch. You will be creating a
|
|
|
|
|
new directory at this location, to be named "Python-X.YaZ". Export
|
|
|
|
|
the tagged branch.
|
2001-10-24 19:18:46 -04:00
|
|
|
|
|
2001-08-22 18:43:42 -04:00
|
|
|
|
% cd ~
|
2008-03-01 13:36:30 -05:00
|
|
|
|
% svn export svn+ssh://pythondev@svn.python.org/python/tags/r26a1 Python-2.6c2
|
2008-02-21 07:00:38 -05:00
|
|
|
|
(supported by welease)
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ Generate the tarballs. Note that we're not using the `z' option
|
2001-08-22 18:43:42 -04:00
|
|
|
|
on the tar command because 1) that's only supported by GNU tar
|
2001-10-19 13:10:22 -04:00
|
|
|
|
as far as we know, and 2) we're going to max out the compression
|
2001-08-22 18:43:42 -04:00
|
|
|
|
level, which isn't a supported option.
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% tar cf - Python-2.6c2 | gzip -9 > Python-2.6c2.tgz
|
|
|
|
|
% tar cf - Python-2.6c2 | bzip2 -9 > Python-2.6c2.tar.bz2
|
2008-02-21 07:00:38 -05:00
|
|
|
|
(supported by welease)
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ Calculate the MD5 checksums of the files you just created
|
2003-07-24 22:34:02 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% md5sum Python-2.6c2.tgz
|
|
|
|
|
% md5sum Python-2.6c2.tar.bz2
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
|
|
|
|
Note that if you don't have the md5sum program, there is a
|
|
|
|
|
Python replacement in the Tools/scripts/md5sum.py file.
|
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Now you want to perform the very important step of checking the
|
2001-08-22 18:43:42 -04:00
|
|
|
|
tarball you just created, to make sure a completely clean,
|
|
|
|
|
virgin build passes the regression test. Here are the best
|
|
|
|
|
steps to take:
|
|
|
|
|
|
|
|
|
|
% cd /tmp
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% tar zxvf ~/Python-2.6c2.tgz # tar xjvf ~/Python-2.6c2.tar.bz2
|
|
|
|
|
% cd Python-2.6c2
|
2001-08-22 18:43:42 -04:00
|
|
|
|
% ls
|
|
|
|
|
(Do things look reasonable?)
|
|
|
|
|
% ./configure
|
|
|
|
|
(Loads of configure output)
|
|
|
|
|
% make test
|
|
|
|
|
(Do all the expected tests pass?)
|
|
|
|
|
|
2003-07-29 19:31:14 -04:00
|
|
|
|
If you're feeling lucky and have some time to kill, run the full
|
|
|
|
|
test suite:
|
|
|
|
|
|
|
|
|
|
% make TESTOPTS='-u all' test
|
|
|
|
|
|
2001-08-22 18:43:42 -04:00
|
|
|
|
If the tests pass, then you can feel good that the tarball is
|
2001-10-24 19:18:46 -04:00
|
|
|
|
fine. If some of the tests fail, or anything else about the
|
2001-08-22 18:43:42 -04:00
|
|
|
|
freshly unpacked directory looks weird, you better stop now and
|
|
|
|
|
figure out what the problem is.
|
|
|
|
|
|
2008-03-01 13:36:30 -05:00
|
|
|
|
___ Upload the tar files to dinsdale.python.org using scp.
|
2003-07-29 19:31:14 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
# XXX(nnorwitz): this entire section dealing with the website is outdated.
|
|
|
|
|
# The website uses SVN and the build process has changed.
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ While you're waiting, you can start twiddling the web pages to
|
2001-08-22 18:43:42 -04:00
|
|
|
|
include the announcement.
|
|
|
|
|
|
2002-01-10 11:22:46 -05:00
|
|
|
|
___ If necessary, and if you have the right permissions (the
|
|
|
|
|
python.org sysadmins must set this up for you), check out the
|
2008-01-17 19:31:21 -05:00
|
|
|
|
web site tree by doing:
|
2002-01-10 11:22:46 -05:00
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
% cvs -d :ext:<you>@dinsdale.python.org:/usr/local/cvsroot co pydotorg
|
2002-01-10 11:22:46 -05:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
XXX: what's the svn equivalent?
|
|
|
|
|
|
|
|
|
|
___ In the python.org web site SVN tree, cd to the X.Y
|
2001-12-14 23:00:17 -05:00
|
|
|
|
subdirectory, and copy index.ht to new-index.ht. Be sure to
|
2008-01-17 19:31:21 -05:00
|
|
|
|
do a "svn update" first!
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2001-12-14 23:00:17 -05:00
|
|
|
|
% cd .../pydotorg
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% svn up
|
|
|
|
|
% cd 2.6
|
2001-09-07 14:58:47 -04:00
|
|
|
|
% cp index.ht new-index.ht
|
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Edit the file for content: usually you can globally replace
|
2001-09-07 14:58:47 -04:00
|
|
|
|
X.Ya(Z-1) with X.YaZ. However, you'll need to think about the
|
2002-04-11 10:30:51 -04:00
|
|
|
|
"What's New?" section.
|
|
|
|
|
|
|
|
|
|
___ Copy the Misc/NEWS file to NEWS.txt in the X.Y directory for
|
|
|
|
|
python.org; this contains the "full scoop" of changes to
|
|
|
|
|
Python since the previous release for this version of Python.
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Also, update the MD5 checksums.
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Preview the web page by doing a "make" -- NOT a "make install".
|
2001-09-07 14:58:47 -04:00
|
|
|
|
View the page via a file: url.
|
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Similarly, edit the ../index.ht file, i.e. the python.org home
|
2001-09-07 14:58:47 -04:00
|
|
|
|
page. In the Big Blue Announcement Block, move the paragraph
|
|
|
|
|
for the new version up to the top and boldify the phrase
|
|
|
|
|
"Python X.YaZ is out". Edit for content, and preview as
|
|
|
|
|
above. Do NOT do a "make install" yet!
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2003-07-25 09:54:43 -04:00
|
|
|
|
___ Also on the ../index.ht file (still the python.org home page),
|
|
|
|
|
update the link information so that the release status is
|
2003-10-03 11:31:36 -04:00
|
|
|
|
correct. Update the links in the left-hand navigation
|
|
|
|
|
sidebar. Still do NOT do a "make install"!
|
2003-07-25 09:54:43 -04:00
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
___ Now we're waiting for the scp to dinsdale to finish. Da de da,
|
2002-04-11 10:30:51 -04:00
|
|
|
|
da de dum, hmm, hmm, dum de dum.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
___ Now you need to go to dinsdale.python.org and move all the files
|
2001-08-22 18:43:42 -04:00
|
|
|
|
in place over there. Our policy is that every Python version
|
|
|
|
|
gets its own directory, but each directory may contain several
|
|
|
|
|
releases. We keep all old releases, moving them into a "prev"
|
|
|
|
|
subdirectory when we have a new release.
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
So, there's a directory called "2.6" which contains
|
|
|
|
|
Python-2.5a2.exe and Python-2.6a2.tgz, along with a "prev"
|
|
|
|
|
subdirectory containing Python-2.6a1.msi, Python-2.6a1.tgz,
|
|
|
|
|
Python-2.6a1.tar.bz2, etc.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
|
|
|
|
So...
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ On dinsdale, cd /data/ftp.python.org/pub/python/X.Y[.Z]
|
|
|
|
|
creating it if necessary.
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Move the previous release files to a directory called "prev"
|
2001-08-22 18:43:42 -04:00
|
|
|
|
creating the directory if necessary (make sure the directory
|
|
|
|
|
has g+ws bits on). If this is the first alpha release of a
|
|
|
|
|
new Python version, skip this step.
|
2001-09-07 14:58:47 -04:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ Move the .tgz, tar.bz2, and .msi files to this directory. Make
|
2001-08-22 18:43:42 -04:00
|
|
|
|
sure they are world readable. They should also be group
|
2001-09-07 14:58:47 -04:00
|
|
|
|
writable, and group-owned by webmaster.
|
|
|
|
|
|
2001-12-14 23:00:17 -05:00
|
|
|
|
___ md5sum the files and make sure they got uploaded intact.
|
|
|
|
|
|
2001-12-21 15:47:12 -05:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ Update the X.Y/bugs.ht file if necessary.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Now preview the new-index.ht file once more. IMPORTANT: follow
|
2001-08-22 18:43:42 -04:00
|
|
|
|
every link on the page to make sure it goes where you expect it
|
|
|
|
|
to go, and that what you expect to be there is there.
|
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ If everything looks good, move new-index.ht to index.ht and do a
|
2001-08-22 18:43:42 -04:00
|
|
|
|
"make install" in this directory. Go up to the parent directory
|
|
|
|
|
(i.e. the root of the web page hierarchy) and do a "make
|
|
|
|
|
install" there too. You're release is now live!
|
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Now it's time to write the announcement for the mailing lists.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
This is the fuzzy bit because not much can be automated. You
|
2008-01-17 19:31:21 -05:00
|
|
|
|
can use an earlier announcement as a template, but edit it for content!
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
|
|
|
|
Once the announcement is ready, send it to the following
|
|
|
|
|
addresses:
|
|
|
|
|
|
|
|
|
|
python-list@python.org
|
|
|
|
|
python-announce@python.org
|
|
|
|
|
python-dev@python.org
|
|
|
|
|
|
2006-02-04 05:34:32 -05:00
|
|
|
|
___ Mention the release as the most recent stable one in
|
|
|
|
|
pydotorg:doc/faq/general.ht (section "How stable is
|
|
|
|
|
Python?")
|
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
___ Make the last change to the documentation area on
|
2003-10-02 11:39:21 -04:00
|
|
|
|
python.org. (Remember those from the documentation items above?
|
|
|
|
|
It's time now.)
|
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
The "current" symlink needs to be updated if this release is the
|
|
|
|
|
highest-versioned release. Log in to dinsdale.python.org, and
|
|
|
|
|
update a symlink in the doc/ tree:
|
2003-10-02 11:39:21 -04:00
|
|
|
|
|
2006-10-25 00:15:39 -04:00
|
|
|
|
# on dinsdale:
|
|
|
|
|
$ cd /data/ftp.python.org/pub/www.python.org/doc/
|
2003-10-02 11:39:21 -04:00
|
|
|
|
$ rm current && ln -s $VERSION current
|
|
|
|
|
|
2003-07-24 23:14:24 -04:00
|
|
|
|
Now it's time to do some cleaning up. These steps are very important!
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2003-07-29 20:09:36 -04:00
|
|
|
|
___ If you made a non-maintenance branch, be sure to merge it into
|
|
|
|
|
the trunk! Now that we've released this branch, we don't need
|
|
|
|
|
it any more. We've already tagged it so we can always reproduce
|
|
|
|
|
it. Note that merging branches is a bit of a black art, but
|
|
|
|
|
here's what's worked for us.
|
|
|
|
|
|
|
|
|
|
NOTE: If this was an X.Y major release, we will be using this as
|
|
|
|
|
the maintenance branch for a long time to come.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Check out a completely clean, virgin working directory of the
|
2001-08-22 18:43:42 -04:00
|
|
|
|
trunk, by doing this in the directory that is the parent of
|
|
|
|
|
your branch working directory python-XYaZ:
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% svn co \
|
|
|
|
|
svn+ssh://pythondev@svn.python.org/python/trunk python-clean
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Run a diff against your branch by doing this in the common
|
2001-08-22 18:43:42 -04:00
|
|
|
|
parent directory containing both python-clean and python-XYaZ:
|
2008-01-17 19:31:21 -05:00
|
|
|
|
% diff -r python-clean python-26a2 | grep ^diff | grep -v /.svn/ \
|
2001-11-16 16:30:25 -05:00
|
|
|
|
> /tmp/diffcmd.sh
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Edit diffcmd.sh to get rid of files that you know don't have
|
2001-08-22 18:43:42 -04:00
|
|
|
|
important changes. You're looking for files that have updates
|
2001-12-14 23:00:17 -05:00
|
|
|
|
in the branch that haven't made it to the trunk.
|
|
|
|
|
|
|
|
|
|
Generally you can ignore any changes to the Doc or Mac
|
|
|
|
|
subdirectories, or any changes to Windows related files. The
|
|
|
|
|
sub-RMs for those parts will take care of any necessary merges
|
|
|
|
|
from the branch to the trunk.
|
|
|
|
|
|
|
|
|
|
If you've been diligent about merging changes from the trunk
|
|
|
|
|
into the branch, there shouldn't be many of these files.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Edit /tmp/diffcmd.sh, changing all the -r's into -u's. Run
|
2001-08-22 18:43:42 -04:00
|
|
|
|
the /tmp/diffcmd.sh command like so:
|
|
|
|
|
% sh /tmp/diffcmd.sh > /tmp/pydiff.txt
|
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Attempt to patch your python-clean working directory. Do this
|
2001-08-22 18:43:42 -04:00
|
|
|
|
first, noting that --dry-run does not actually apply any
|
|
|
|
|
patches, it just makes sure that the patch command runs
|
|
|
|
|
successfully to completion:
|
|
|
|
|
% patch -p1 --dry-run < /tmp/pydiff.txt
|
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ If this goes well, run it again, taking out the --dry-run
|
2001-08-22 18:43:42 -04:00
|
|
|
|
option. If this fails, or if it prompts you for a file to
|
|
|
|
|
patch, try using -p0 instead of -p1. Otherwise, your diff
|
|
|
|
|
command was messed up, so try again.
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ cd to python-clean and do a "svn commit". Use as your log
|
2003-07-31 10:21:07 -04:00
|
|
|
|
message something like "Merging the rXYaZ-maint tag back into
|
2001-08-22 18:43:42 -04:00
|
|
|
|
the trunk".
|
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ Edit the file Include/patchlevel.h so that the PY_VERSION
|
2001-08-22 18:43:42 -04:00
|
|
|
|
string says something like "X.YaZ+". Note the trailing `+'
|
|
|
|
|
indicating that the trunk is going to be moving forward with
|
|
|
|
|
development. E.g. the line should look like:
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
#define PY_VERSION "2.6a2+"
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-09-28 13:16:35 -04:00
|
|
|
|
Make sure that the other PY_ version macros contain the
|
|
|
|
|
correct values. Commit this change.
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-10-24 19:18:46 -04:00
|
|
|
|
___ For the extra paranoid, do a completely clean test of the
|
2002-04-11 10:30:51 -04:00
|
|
|
|
release. This includes downloading the tarball from
|
|
|
|
|
www.python.org.
|
2001-10-24 19:18:46 -04:00
|
|
|
|
|
|
|
|
|
___ Make sure the md5 checksums match. Then unpack the tarball,
|
|
|
|
|
and do a clean make test.
|
|
|
|
|
|
2001-08-22 18:43:42 -04:00
|
|
|
|
% make distclean
|
|
|
|
|
% ./configure
|
|
|
|
|
% make test
|
|
|
|
|
|
|
|
|
|
To ensure that the regression test suite passes. If not, you
|
|
|
|
|
screwed up somewhere!
|
|
|
|
|
|
2001-09-08 01:17:56 -04:00
|
|
|
|
Step 5 ...
|
|
|
|
|
|
|
|
|
|
Verify! This can be interleaved with Step 4. Pretend you're a
|
2002-04-11 10:30:51 -04:00
|
|
|
|
user: download the files from python.org, and make Python from it.
|
|
|
|
|
This step is too easy to overlook, and on several occasions we've
|
|
|
|
|
had useless release files. Once a general server problem caused
|
|
|
|
|
mysterious corruption of all files; once the source tarball got
|
|
|
|
|
built incorrectly; more than once the file upload process on SF
|
|
|
|
|
truncated files; and so on.
|
2001-09-08 01:17:56 -04:00
|
|
|
|
|
|
|
|
|
|
2001-08-22 18:43:42 -04:00
|
|
|
|
What Next?
|
|
|
|
|
|
|
|
|
|
Rejoice. Drink. Be Merry. Write a PEP like this one. Or be
|
|
|
|
|
like unto Guido and take A Vacation.
|
|
|
|
|
|
|
|
|
|
You've just made a Python release!
|
|
|
|
|
|
2001-10-29 10:53:04 -05:00
|
|
|
|
|
|
|
|
|
Final Release Notes
|
|
|
|
|
|
2006-09-10 13:16:23 -04:00
|
|
|
|
The Final release of any major release, e.g. Python 2.5 final, has
|
2001-10-29 10:53:04 -05:00
|
|
|
|
special requirements, specifically because it will be one of the
|
|
|
|
|
longest lived releases (i.e. betas don't last more than a couple
|
|
|
|
|
of weeks, but final releases can last for years!).
|
|
|
|
|
|
|
|
|
|
For this reason we want to have a higher coordination between the
|
2008-01-17 19:31:21 -05:00
|
|
|
|
three major releases: Windows, Mac, and source. So we add this
|
|
|
|
|
extra step to the release process for a final release:
|
2001-10-29 10:53:04 -05:00
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
___ Hold up the final release until the WE and ME approve, or until we
|
2001-10-29 10:53:04 -05:00
|
|
|
|
lose patience <wink>.
|
2001-10-24 19:18:46 -04:00
|
|
|
|
|
2001-08-22 18:43:42 -04:00
|
|
|
|
|
2001-09-08 01:17:56 -04:00
|
|
|
|
Windows Notes
|
|
|
|
|
|
2006-09-10 13:07:43 -04:00
|
|
|
|
Windows has a MSI installer, various flavors of Windows have
|
2001-10-25 01:19:19 -04:00
|
|
|
|
"special limitations", and the Windows installer also packs
|
|
|
|
|
precompiled "foreign" binaries (Tcl/Tk, expat, etc). So Windows
|
|
|
|
|
testing is tiresome but very necessary.
|
|
|
|
|
|
2008-01-17 19:31:21 -05:00
|
|
|
|
Concurrent with uploading the installer, the WE installs Python
|
2006-09-10 13:07:43 -04:00
|
|
|
|
from it twice: once into the default directory suggested by the
|
2001-10-25 01:19:19 -04:00
|
|
|
|
installer, and later into a directory with embedded spaces in its
|
|
|
|
|
name. For each installation, he runs the full regression suite
|
2006-09-10 13:07:43 -04:00
|
|
|
|
from a DOS box, and both with and without -0. For maintenance
|
|
|
|
|
release, he also tests whether upgrade installations succeed.
|
2001-10-25 01:19:19 -04:00
|
|
|
|
|
|
|
|
|
He also tries *every* shortcut created under Start -> Menu -> the
|
|
|
|
|
Python group. When trying IDLE this way, you need to verify that
|
|
|
|
|
Help -> Python Documentation works. When trying pydoc this way
|
|
|
|
|
(the "Module Docs" Start menu entry), make sure the "Start
|
|
|
|
|
Browser" button works, and make sure you can search for a random
|
2008-01-17 19:31:21 -05:00
|
|
|
|
module (like "random" <wink>) and then that the "go to selected"
|
|
|
|
|
button works.
|
2001-10-25 01:19:19 -04:00
|
|
|
|
|
|
|
|
|
It's amazing how much can go wrong here -- and even more amazing
|
|
|
|
|
how often last-second checkins break one of these things. If
|
|
|
|
|
you're "the Windows geek", keep in mind that you're likely the
|
|
|
|
|
only person routinely testing on Windows, and that Windows is
|
|
|
|
|
simply a mess.
|
|
|
|
|
|
2006-09-10 13:07:43 -04:00
|
|
|
|
Repeat the testing for each target architecture. On XP/2003, try
|
|
|
|
|
both an Admin and a plain User (not Power User) account. If you
|
|
|
|
|
can, also test the installer on Windows 9x.
|
2001-10-25 01:19:19 -04:00
|
|
|
|
|
|
|
|
|
WRT Step 5 above (verify the release media), since by the time
|
2008-01-17 19:31:21 -05:00
|
|
|
|
release files are ready to download the WE has generally run many
|
2001-10-25 01:19:19 -04:00
|
|
|
|
Windows tests on the installer he uploaded, he usually doesn't do
|
|
|
|
|
anything for Step 5 except a full byte-comparison ("fc /b" if
|
|
|
|
|
using a Windows shell) of the downloaded file against the file he
|
|
|
|
|
uploaded.
|
2001-09-08 01:17:56 -04:00
|
|
|
|
|
|
|
|
|
|
2001-08-22 18:43:42 -04:00
|
|
|
|
Copyright
|
|
|
|
|
|
|
|
|
|
This document has been placed in the public domain.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Local Variables:
|
|
|
|
|
mode: indented-text
|
|
|
|
|
indent-tabs-mode: nil
|
|
|
|
|
End:
|