[Python-checkins] r50538 - sandbox/trunk/setuptools/setuptools.txt

[phillip.eby]

Author: phillip.eby
Date: Mon Jul 10 22:45:33 2006
New Revision: 50538

Modified:
   sandbox/trunk/setuptools/setuptools.txt
Log:
Tweak docs for subversion release stuff to make better use of new 
options.


Modified: sandbox/trunk/setuptools/setuptools.txt
==============================================================================
--- sandbox/trunk/setuptools/setuptools.txt	(original)
+++ sandbox/trunk/setuptools/setuptools.txt	Mon Jul 10 22:45:33 2006
@@ -1523,22 +1523,6 @@
 post-release numbering on release branches, and pre-release numbering on the
 trunk.  But you don't have to make things this complex if you don't want to.)
 
-When you make an official release, creating source or binary distributions,
-you will need to override the tag settings from ``setup.cfg``.  This is easy to
-do if you are developing on the trunk and using tags or branches for your
-releases - just make the change after branching or tagging the release, so the
-trunk will still produce development snapshots.
-
-Alternately, you can override the options on the command line, using
-something like::
-
-    python setup.py egg_info -RDb "" sdist bdist_egg register upload
-
-The first part of this command (``egg_info -RDb ""``) will override the
-configured tag information, before creating source and binary eggs, registering
-the project with PyPI, and uploading the files.  (See the section below on the
-`egg_info`_ command for more details on the command line options in use here.)
-
 Commonly, projects releasing code from Subversion will include a PyPI link to
 their checkout URL (as described in the previous section) with an
 ``#egg=projectname-dev`` suffix.  This allows users to request EasyInstall
@@ -1567,6 +1551,41 @@
 in order to keep their checkout completely in sync.
 
 
+Making "Official" (Non-Snapshot) Releases
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When you make an official release, creating source or binary distributions,
+you will need to override the tag settings from ``setup.cfg``, so that you
+don't end up registering versions like ``foobar-0.7a1.dev-r34832``.  This is
+easy to do if you are developing on the trunk and using tags or branches for
+your releases - just make the change to ``setup.cfg`` after branching or
+tagging the release, so the trunk will still produce development snapshots.
+
+Alternately, if you are not branching for releases, you can override the
+default version options on the command line, using something like::
+
+    python setup.py egg_info -RDb "" sdist bdist_egg register upload
+
+The first part of this command (``egg_info -RDb ""``) will override the
+configured tag information, before creating source and binary eggs, registering
+the project with PyPI, and uploading the files.  Thus, these commands will use
+the plain version from your ``setup.py``, without adding the Subversion
+revision number or build designation string.
+
+Of course, if you will be doing this a lot, you may wish to create a personal
+alias for this operation, e.g.::
+
+    python setup.py alias -u release egg_info -RDb ""
+
+You can then use it like this::
+
+    python setup.py release sdist bdist_egg register upload
+
+Or of course you can create more elaborate aliases that do all of the above.
+See the sections below on the `egg_info`_ and `alias`_ commands for more ideas.
+
+
+
 Distributing Extensions compiled with Pyrex
 -------------------------------------------