Mercurial > p > roundup > code

annotate BUILD.txt @ 4440:7c576a4dea9d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
XML-RPC documentation now linked from the docs/index
author Bernhard Reiter <Bernhard.Reiter@intevation.de>
date Wed, 20 Oct 2010 14:12:08 +0000
parents e35e57ad90f0
children 5e9578d35d03
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1354
f79ed90ccecf cleanup
Richard Jones <richard@users.sourceforge.net>
parents: 518
diff changeset
1 Building Releases
f79ed90ccecf cleanup
Richard Jones <richard@users.sourceforge.net>
parents: 518
diff changeset
2 =================
98
16dcdab5ce70 Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
3
16dcdab5ce70 Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
4 Roundup is currently a source-only release - it has no binary components. I
3106
a574d183b0df *** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents: 3089
diff changeset
5 want it to stay that way, too. This document describes how to build a
a574d183b0df *** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents: 3089
diff changeset
6 source release. Users of Roundup should read the doc/installation.txt file
a574d183b0df *** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents: 3089
diff changeset
7 to find out how to install this software.
98
16dcdab5ce70 Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
8
3588
503d4c10f1f8 pre-release stuff
Richard Jones <richard@users.sourceforge.net>
parents: 3531
diff changeset
9 Building and distributing a release of Roundup is done by running:
98
16dcdab5ce70 Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
10
3089
33e3ba342e93 Typo fixes: [SF#097860] and [SF#097864].
Johannes Gijsbers <jlgijsbers@users.sourceforge.net>
parents: 2237
diff changeset
11 1. Make sure the unit tests run! "./run_tests.py"
4261
d82cd44bea96 update BUILD
Richard Jones <richard@users.sourceforge.net>
parents: 4104
diff changeset
12 2. Edit roundup/__init__.py and doc/announcement.txt to reflect the new
4393
Richard Jones <richard@users.sourceforge.net>
parents: 4353
diff changeset
13 version and appropriate announcements.
4262
e5e4434957c5 reinstate 3 with correct instructions
Richard Jones <richard@users.sourceforge.net>
parents: 4261
diff changeset
14 3. Note the SVN revision in the CHANGES.txt file.
e5e4434957c5 reinstate 3 with correct instructions
Richard Jones <richard@users.sourceforge.net>
parents: 4261
diff changeset
15 4. Clean out all *.orig, *.rej, .#* files from the source.
e5e4434957c5 reinstate 3 with correct instructions
Richard Jones <richard@users.sourceforge.net>
parents: 4261
diff changeset
16 5. python setup.py clean --all
e5e4434957c5 reinstate 3 with correct instructions
Richard Jones <richard@users.sourceforge.net>
parents: 4261
diff changeset
17 6. Edit setup.py to ensure that all information therein (version, contact
1939
1303c208419d some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents: 1875
diff changeset
18 information etc) is correct.
4262
e5e4434957c5 reinstate 3 with correct instructions
Richard Jones <richard@users.sourceforge.net>
parents: 4261
diff changeset
19 7. python setup.py sdist --manifest-only
e5e4434957c5 reinstate 3 with correct instructions
Richard Jones <richard@users.sourceforge.net>
parents: 4261
diff changeset
20 8. Check the MANIFEST to make sure that any new files are included. If
1939
1303c208419d some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents: 1875
diff changeset
21 they are not, edit MANIFEST.in to include them. "Documentation" for
1303c208419d some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents: 1875
diff changeset
22 MANIFEST.in may be found in disutils.filelist._parse_template_line.
4262
e5e4434957c5 reinstate 3 with correct instructions
Richard Jones <richard@users.sourceforge.net>
parents: 4261
diff changeset
23 9. python setup.py sdist
1939
1303c208419d some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents: 1875
diff changeset
24 (if you find sdist a little verbose, add "--quiet" to the end of the
1303c208419d some updates that were sitting on disk
Richard Jones <richard@users.sourceforge.net>
parents: 1875
diff changeset
25 command)
4262
e5e4434957c5 reinstate 3 with correct instructions
Richard Jones <richard@users.sourceforge.net>
parents: 4261
diff changeset
26 10. Unpack the new dist file in /tmp then a) run_test.py and b) demo.py
1947
0e19e99075e3 fix #white in cgitb
Richard Jones <richard@users.sourceforge.net>
parents: 1939
diff changeset
27 with all available Python versions.
4353
7bfbf82ef3ca add tagging info to the release build doc
Richard Jones <richard@users.sourceforge.net>
parents: 4277
diff changeset
28 11. Assuming all is well tag the release in SVN::
7bfbf82ef3ca add tagging info to the release build doc
Richard Jones <richard@users.sourceforge.net>
parents: 4277
diff changeset
29
7bfbf82ef3ca add tagging info to the release build doc
Richard Jones <richard@users.sourceforge.net>
parents: 4277
diff changeset
30 svn cp https://roundup.svn.sourceforge.net/svnroot/roundup/roundup/trunk \
4433
e35e57ad90f0 release stuff
Richard Jones <richard@users.sourceforge.net>
parents: 4393
diff changeset
31 https://roundup.svn.sourceforge.net/svnroot/roundup/roundup/tags/release-1-4-16
4353
7bfbf82ef3ca add tagging info to the release build doc
Richard Jones <richard@users.sourceforge.net>
parents: 4277
diff changeset
32
4272
05600cc5e4af - remove detached pgp signature, the upload will take care of signing
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents: 4271
diff changeset
33 11. python setup.py bdist_rpm
05600cc5e4af - remove detached pgp signature, the upload will take care of signing
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents: 4271
diff changeset
34 12. python setup.py bdist_wininst
05600cc5e4af - remove detached pgp signature, the upload will take care of signing
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents: 4271
diff changeset
35 13. Send doc/announcement.txt to python-announce@python.org and
4277
9e1a91f3cf17 - Add roundup-devel@lists.sourceforge.net to announcement list.
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents: 4272
diff changeset
36 roundup-users@lists.sourceforge.net and
9e1a91f3cf17 - Add roundup-devel@lists.sourceforge.net to announcement list.
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents: 4272
diff changeset
37 roundup-devel@lists.sourceforge.net
98
16dcdab5ce70 Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
38
1354
f79ed90ccecf cleanup
Richard Jones <richard@users.sourceforge.net>
parents: 518
diff changeset
39 So, those commands in a nice, cut'n'pasteable form::
f79ed90ccecf cleanup
Richard Jones <richard@users.sourceforge.net>
parents: 518
diff changeset
40
3531
616244e247f4 *** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents: 3106
diff changeset
41 find . -name '*.orig' -exec rm {} \;
616244e247f4 *** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents: 3106
diff changeset
42 find . -name '*.rej' -exec rm {} \;
616244e247f4 *** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents: 3106
diff changeset
43 find . -name '.#*' -exec rm {} \;
1354
f79ed90ccecf cleanup
Richard Jones <richard@users.sourceforge.net>
parents: 518
diff changeset
44 python setup.py clean --all
f79ed90ccecf cleanup
Richard Jones <richard@users.sourceforge.net>
parents: 518
diff changeset
45 python setup.py sdist --manifest-only
f79ed90ccecf cleanup
Richard Jones <richard@users.sourceforge.net>
parents: 518
diff changeset
46 python setup.py sdist --quiet
2237
f624fc20f8fe added capturing of stats
Richard Jones <richard@users.sourceforge.net>
parents: 2223
diff changeset
47 python setup.py bdist_rpm
f624fc20f8fe added capturing of stats
Richard Jones <richard@users.sourceforge.net>
parents: 2223
diff changeset
48 python setup.py bdist_wininst
3588
503d4c10f1f8 pre-release stuff
Richard Jones <richard@users.sourceforge.net>
parents: 3531
diff changeset
49 python setup.py register
4261
d82cd44bea96 update BUILD
Richard Jones <richard@users.sourceforge.net>
parents: 4104
diff changeset
50 python setup.py sdist upload --sign
d82cd44bea96 update BUILD
Richard Jones <richard@users.sourceforge.net>
parents: 4104
diff changeset
51 python setup.py bdist_wininst upload --sign
98
16dcdab5ce70 Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
52
4261
d82cd44bea96 update BUILD
Richard Jones <richard@users.sourceforge.net>
parents: 4104
diff changeset
53 (if the last two fail make sure you're using python2.5+)
Roundup Issue Tracker: http://roundup-tracker.org/