diff --git a/pep-0101.txt b/pep-0101.txt index 3d0118327..b1ab0a3b0 100644 --- a/pep-0101.txt +++ b/pep-0101.txt @@ -145,7 +145,7 @@ How to Make A Release ___ There's a copy of the license in Doc/license.rst - ___ Doc/tutorial/interpreter.rst (3 references to '[Pp]ython26', one + ___ Doc/tutorial/interpreter.rst (2 references to '[Pp]ython26', one to 'Python 2.6'). ___ Doc/tutorial/stdlib.rst and Doc/tutorial/stdlib2.rst, which have @@ -221,6 +221,8 @@ How to Make A Release python26.chm file. He then copies the file into the Doc directories of the build trees (once for each target architecture). + XXX The CHM file should also be scp'd to the docs download location. + ___ XXX The WE then generates Windows installer files for each Windows target architecture (for Python 2.6, this means x86 and AMD64). He has one checkout tree per target architecture, @@ -293,6 +295,11 @@ How to Make A Release % cd Python-2.6c2 % ls (Do things look reasonable?) + % ls Lib + (Are there stray .pyc files?) + % ls Doc/tools + (Make sure it doesn't contain "docutils", "sphinx", "jinja" or + "pygments" directories.) % ./configure (Loads of configure output) % make test @@ -351,6 +358,10 @@ How to Make A Release ___ md5sum the files and make sure they got uploaded intact. + ___ If this is a final release: Move the built docs to + /data/ftp.python.org/pub/python/doc/X.Y[.Z], and adapt the + "current" symlink in that directory. + Now it's time to twiddle the web site. To do these steps, you must have the permission to edit the website. If you @@ -402,22 +413,9 @@ How to Make A Release ___ update `doc/content.ht` to indicate the new current documentation version, and remove the current version from any 'in development' - section. + section. Update the version in the "What's New" link. - ___ add the new version to `doc/version/content.ht` - - ___ Make the last change to the documentation area on python.org. - - 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: - - # on dinsdale: - $ cd /data/ftp.python.org/pub/www.python.org/doc/ - $ rm current && ln -s $VERSION current - - XXX This does not seem complete. I still don't really understand - how all the documentation stuff hangs together. + ___ Add the new version to `doc/version/content.ht`. ___ Edit download/releases/content.ht to update the version numbers for this release. There are a bunch of places you need to touch: