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. Edit roundup/__init__.py and doc/announcement.txt to reflect the new
  11    version and appropriate announcements.
  12 2. python setup.py clean --all
  13 3. Edit setup.py to ensure that all information therein (version, contact
  14    information etc) is correct.
  15 4. python setup.py sdist --manifest-only
  16 5. Check the MANIFEST to make sure that any new files are included. If
  17    they are not, edit MANIFEST.in to include them. "Documentation" for
  18    MANIFEST.in may be found in disutils.filelist._parse_template_line.
  19 6. python setup.py sdist
  20    (if you find sdist a little verbose, add "--quiet" to the end of the
  21     command)
  22
  23 So, those commands in a nice, cut'n'pasteable form::
  24
  25  python setup.py clean --all
  26  python setup.py sdist --manifest-only
  27  python setup.py sdist --quiet
  28
  29 or, for the sad RedHat users::
  30
  31  python2 setup.py clean --all
  32  python2 setup.py sdist --manifest-only
  33  python2 setup.py sdist --quiet
  34
  35
  36 Distributing Releases
  37 =====================
  38
  39 Once a release is built, follow these steps:
  40
  41 1. FTP the tar.gz from the dist directory to to the "incoming" directory on
  42    "upload.sourceforge.net".
  43 2. Make a quick release at:
  44     http://sourceforge.net/project/admin/qrs.php?package_id=&group_id=31577
  45 3. Add a news item at:
  46     https://sourceforge.net/news/submit.php?group_id=31577
  47    using the top of doc/announcement.txt
  48 4. Send doc/announcement.txt to python-announce@python.org
  49 5. Notify any other news services as appropriate...
  50
  51
  52 Author
  53 ======
  54
  55 richard@users.sourceforge.net
  56