~kvilhaugsvik/qbzr/qshelve_all

« back to all changes in this revision

Viewing changes to docs/make_release.txt

  • Committer: Alexander Belchenko
  • Date: 2008-06-19 11:49:54 UTC
  • Revision ID: bialix@ukr.net-20080619114954-i9g6fnebb3t89a2x
make_release.tx: instructions/checklist for release manager.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Short checklist and instructions how to make release
 
2
====================================================
 
3
 
 
4
When you're ready to make release X.Y.Z you need to do
 
5
following steps.
 
6
 
 
7
Prepare code
 
8
------------
 
9
1. Update ./NEWS.txt with descriptions of user-visible changes.
 
10
2. Update version numbers in following places:
 
11
 
 
12
   * ./__init__.py: at the beginning of file::
 
13
   
 
14
        version_info = (X, Y, Z, 'final', 0)
 
15
   
 
16
   * ./setup.py: function setup() at the end of file, argument version::
 
17
   
 
18
        version='X.Y.Z',
 
19
 
 
20
   * ./installer/qbzr-setup.nsi: at the beginning of file::
 
21
   
 
22
        !define PRODUCT_VERSION "X.Y.Z"
 
23
   
 
24
3. Commit this changes and tag the revision with label: release-X.Y.Z
 
25
4. Push the code to Launchpad
 
26
 
 
27
 
 
28
Register release at Launchpad
 
29
-----------------------------
 
30
1. Make corresponding page for new release on Launchpad:
 
31
 
 
32
        https://launchpad.net/qbzr/trunk/+addrelease
 
33
        
 
34
2. Put info about release from ./NEWS.txt to Description section.
 
35
 
 
36
 
 
37
Build distribution files
 
38
------------------------
 
39
1. Make source code tarball::
 
40
 
 
41
        bzr export --root=qbzr qbzr-X.Y.Z.tar.gz
 
42
        
 
43
   The file qbzr-X.Y.Z.tar.gz will be created in tree root directory.
 
44
   Sign this file with your GPG key::
 
45
   
 
46
        gpg -ab qbzr-X.Y.Z.tar.gz
 
47
 
 
48
2. Build binary translations files::
 
49
 
 
50
        python setup.py build_mo -f
 
51
 
 
52
3. Make Windows Python-based installer::
 
53
 
 
54
        python setup.py bdist_wininst -d.
 
55
 
 
56
   This command will produce qbzr-X.Y.Z.win32.exe file in tree root directory.
 
57
   Sign this file with your GPG key::
 
58
   
 
59
        gpg -ab qbzr-X.Y.Z.win32.exe
 
60
 
 
61
4. Make Windows Standalone installer::
 
62
 
 
63
        python setup.py bdist_nsis
 
64
        
 
65
   This command will produce qbzr-setup-X.Y.Z.exe file in 'installer' directory.
 
66
   Sign this file with your GPG key::
 
67
   
 
68
        gpg -ab qbzr-setup-X.Y.Z.exe
 
69
 
 
70
5. Upload tarball and installers with their gpg-signatures to Launchpad:
 
71
 
 
72
        https://launchpad.net/qbzr/trunk/X.Y.Z/+adddownloadfile
 
73
 
 
74
 
 
75
Update QBzr Wiki page
 
76
---------------------
 
77
1. Update QBzr page at Bazaar wiki with corresponding NEWS entry,
 
78
   update links to tarball and installers.
 
79
   
 
80
        http://bazaar-vcs.org/QBzr
 
81
 
 
82
 
 
83
Make announcement
 
84
-----------------
 
85
1. Send short e-mail with announcement to <bazaar-announce@lists.canonical.com>
 
86
   and optionally to main Bazaar ML <bazaar@lists.canonical.com>
 
87
 
 
88
2. Optionally make announcement about release via Launchpad RSS:
 
89
 
 
90
        https://launchpad.net/qbzr/+announce
 
91
 
 
92
 
 
93
Finishing stuff at Launchpad
 
94
----------------------------
 
95
1. Mark all bugs targeted to X.Y.Z milestone as Fix Released.
 
96
 
 
97
2. Mark corresponding milestone X.Y.Z as inactive:
 
98
 
 
99
        https://launchpad.net/qbzr/+milestone/X.Y.Z/+edit
 
100
 
 
101
 
 
102
Create deb packages with Launchpad PPA
 
103
--------------------------------------
 
104
XXX