BUILD.txt

   1 Building Releases
   2 =================
   3
   4 Roundup is currently a source-only release - it has no binary components. I
   5 want it to stay that way, too.
   6
   7 This means that we only need to ever build source releases. This is done by
   8 running:
   9
  10 1. Make sure the unit tests run! "python run_tests.py"
  11 2. Edit roundup/__init__.py and doc/announcement.txt to reflect the new
  12    version and appropriate announcements. Add truncated announcement to
  13    setup.py description field.
  14 3. Tag the CVS with a release tag (ie. 'release-N-N-N')
  15 4. python setup.py clean --all
  16 5. Edit setup.py to ensure that all information therein (version, contact
  17    information etc) is correct.
  18 6. python setup.py sdist --manifest-only
  19 7. Check the MANIFEST to make sure that any new files are included. If
  20    they are not, edit MANIFEST.in to include them. "Documentation" for
  21    MANIFEST.in may be found in disutils.filelist._parse_template_line.
  22 8. python setup.py sdist
  23    (if you find sdist a little verbose, add "--quiet" to the end of the
  24     command)
  25
  26 So, those commands in a nice, cut'n'pasteable form::
  27
  28  python setup.py clean --all
  29  python setup.py sdist --manifest-only
  30  python setup.py sdist --quiet
  31  python2.3 setup.py register
  32
  33
  34 Distributing Releases
  35 =====================
  36
  37 Once a release is built, follow these steps:
  38
  39 1. FTP the tar.gz from the dist directory to to the "incoming" directory on
  40    "upload.sourceforge.net".
  41 2. Make a quick release at:
  42     http://sourceforge.net/project/admin/qrs.php?package_id=&group_id=31577
  43 3. Add a news item at:
  44     https://sourceforge.net/news/submit.php?group_id=31577
  45    using the top of doc/announcement.txt
  46 4. Send doc/announcement.txt to python-announce@python.org
  47 5. Notify any other news services as appropriate...
  48
  49
  50 Author
  51 ======
  52
  53 richard@users.sourceforge.net
  54