X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=BUILD.txt;h=27e3479735832cfe9110f1fb0be468e8d38179bb;hb=56e200d63c6098917037aee2587915a26afd1f8f;hp=4ee93d194c64e3761d726b5c5b26823eea98cb8b;hpb=5dcf47abe5e546ef0ac00a99371541fded489eb3;p=roundup.git diff --git a/BUILD.txt b/BUILD.txt index 4ee93d1..27e3479 100644 --- a/BUILD.txt +++ b/BUILD.txt @@ -2,53 +2,52 @@ Building Releases ================= Roundup is currently a source-only release - it has no binary components. I -want it to stay that way, too. - -This means that we only need to ever build source releases. This is done by -running: - -1. Make sure the unit tests run! "./run_tests" -2. Edit roundup/__init__.py and doc/announcement.txt to reflect the new - version and appropriate announcements. Add truncated announcement to - setup.py description field. -3. Tag the CVS with a release tag (ie. 'release-N-N-N') -4. python setup.py clean --all -5. Edit setup.py to ensure that all information therein (version, contact - information etc) is correct. -6. python setup.py sdist --manifest-only -7. Check the MANIFEST to make sure that any new files are included. If - they are not, edit MANIFEST.in to include them. "Documentation" for - MANIFEST.in may be found in disutils.filelist._parse_template_line. -8. python setup.py sdist - (if you find sdist a little verbose, add "--quiet" to the end of the - command) +want it to stay that way, too. This document describes how to build a +source release. Users of Roundup should read the doc/installation.txt file +to find out how to install this software. + +Building and distributing a release of Roundup is done by running: + +1. Make sure the unit tests run! "./run_tests.py" +2. Edit roundup/__init__.py and doc/announcement.txt to reflect the new + version and appropriate announcements. +3. Note the SVN revision in the CHANGES.txt file. +4. Clean out all *.orig, *.rej, .#* files from the source. +5. python setup.py clean --all +6. Edit setup.py to ensure that all information therein (version, contact + information etc) is correct. +7. python setup.py sdist --manifest-only +8. Check the MANIFEST to make sure that any new files are included. If + they are not, edit MANIFEST.in to include them. "Documentation" for + MANIFEST.in may be found in disutils.filelist._parse_template_line. +9. python setup.py sdist + (if you find sdist a little verbose, add "--quiet" to the end of the + command) +10. Unpack the new dist file in /tmp then a) run_test.py and b) demo.py + with all available Python versions. +11. Assuming all is well tag the release in SVN:: + + svn cp https://roundup.svn.sourceforge.net/svnroot/roundup/roundup/trunk \ + https://roundup.svn.sourceforge.net/svnroot/roundup/roundup/tags/release-1-4-16 + +11. python setup.py bdist_rpm +12. python setup.py bdist_wininst +13. Send doc/announcement.txt to python-announce@python.org and + roundup-users@lists.sourceforge.net and + roundup-devel@lists.sourceforge.net So, those commands in a nice, cut'n'pasteable form:: + find . -name '*.orig' -exec rm {} \; + find . -name '*.rej' -exec rm {} \; + find . -name '.#*' -exec rm {} \; python setup.py clean --all python setup.py sdist --manifest-only python setup.py sdist --quiet - python2.3 setup.py register - - -Distributing Releases -===================== - -Once a release is built, follow these steps: - -1. FTP the tar.gz from the dist directory to to the "incoming" directory on - "upload.sourceforge.net". -2. Make a quick release at: - http://sourceforge.net/project/admin/qrs.php?package_id=&group_id=31577 -3. Add a news item at: - https://sourceforge.net/news/submit.php?group_id=31577 - using the top of doc/announcement.txt -4. Send doc/announcement.txt to python-announce@python.org -5. Notify any other news services as appropriate... - - -Author -====== - -richard@users.sourceforge.net + python setup.py bdist_rpm + python setup.py bdist_wininst + python setup.py register + python setup.py sdist upload --sign + python setup.py bdist_wininst upload --sign +(if the last two fail make sure you're using python2.5+)