← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/releasing.txt

  • Committer: Andrew Bennetts
  • Date: 2009-07-27 05:35:00 UTC
  • mfrom: (4570 +trunk)
  • mto: (4634.6.29 2.0)
  • mto: This revision was merged to the branch mainline in revision 4680.
  • Revision ID: andrew.bennetts@canonical.com-20090727053500-q76zsn2dx33jhmj5
Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/releasing.txt
17
17
#. Make a local branch for preparing this release.  (Only for the first 
18
18
   release in a series, otherwise you should already have a branch.) ::
19
19
 
20
 
     bzr branch trunk prepare-1.6
 
20
     bzr branch trunk prepare-1.14
 
21
 
 
22
#. Download the pqm plugin and install it into your ``~/.bazaar/plugins``::
 
23
 
 
24
     bzr branch lp:bzr-pqm ~/.bazaar/plugins/pqm
21
25
 
22
26
#. Configure pqm-submit for this branch, with a section like this in
23
27
   ``~/.bazaar/locations.conf``::
24
28
 
25
 
        [/home/mbp/bzr/prepare-1.4]
 
29
        [/home/mbp/bzr/prepare-1.14]
26
30
        pqm_email = Canonical PQM <pqm@bazaar-vcs.org>
27
 
        submit_branch = http://bazaar-vcs.org/bzr/bzr.1.4
 
31
        submit_branch = http://bazaar-vcs.org/bzr/bzr.1.14
 
32
        public_branch = http://bazaar.your-domain.com/bzr
28
33
        submit_to = bazaar@lists.canonical.com
29
 
 
30
 
#. In the release branch, update  ``version_info`` in
31
 
   ``./bzrlib/__init__.py``.  Check the output of ``bzr --version``.
 
34
        smtp_server = mail.your-domain.com:25
 
35
 
 
36
    Please see <http://doc.bazaar-vcs.org/latest/developers/HACKING.html#an-overview-of-pqm>
 
37
    for more details on PQM
 
38
 
 
39
#. In the release branch, update  ``version_info`` in ``./bzrlib/__init__.py``.
 
40
   Double check that ./bzr ``_script_version`` matches ``version_info``. Check
 
41
   the output of ``bzr --version``. 
32
42
 
33
43
#. Add the date and release number to ``./NEWS``
34
44
 
 
45
#. To check that all bugs mentioned in ``./NEWS`` are actually marked as
 
46
   closed in Launchpad, you can run ``tools/check-newsbugs.py``::
 
47
 
 
48
     ./tools/check-newsbugs.py NEWS
 
49
 
35
50
#. Summarize into one or two paragraphs what's new in this release.
36
51
 
37
52
#. Commit these changes to the release branch, using a command like::
38
53
    
39
 
     bzr commit -m "Release 0.12rc1." 
 
54
     bzr commit -m "Release 1.14." 
40
55
   
41
56
   The diff before you commit will be something like::
42
57
 
76
91
      
77
92
#. Tag the new release::
78
93
 
79
 
     bzr tag bzr-1.12rc1 
 
94
     bzr tag bzr-1.14
80
95
 
81
 
#. Submit those changes to PQM for merge into the appropriate release
82
 
   branch::
 
96
#. Push those changes to a bzr reposistory that is public and accessible on
 
97
   the Internet. PQM will pull from this repository when it attempts to merge
 
98
   your changes. Then submit those changes to PQM for merge into the
 
99
   appropriate release branch::
83
100
 
84
101
     bzr push
85
 
     bzr pqm-submit -m "(mbp) prepare 1.6"
 
102
     bzr pqm-submit -m "(mbp) prepare 1.14"
86
103
 
87
104
#. When PQM succeeds, pull down the master release branch.
88
105
 
110
127
available to the world.
111
128
 
112
129
#. In <https://launchpad.net/bzr/> click the "Release series" for this
113
 
   series, to take you to e.g. <https://launchpad.net/bzr/1.1>.  Then
 
130
   series, to take you to e.g. <https://launchpad.net/bzr/1.14>.  Then
114
131
   click "Register a release", and add information about this release.
115
132
 
116
133
#. Within that release, upload the source tarball and zipfile and the GPG
141
158
   ``Reply-To: bazaar@lists.canonical.com``, so that people who reply to
142
159
   the announcement don't spam other lists.
143
160
 
144
 
   The announce mail will look something like this:
 
161
   The announce mail will look something like this::
145
162
   
146
 
    | Subject: bzr x.yy released!
147
 
    | 
148
 
    | <<Summary paragraph from news>>
149
 
    |
150
 
    | The Bazaar team is happy to announce availability of a new 
151
 
    | release of the bzr adaptive version control system.
152
 
    |
153
 
    | Thanks to everyone who contributed patches, suggestions, and
154
 
    | feedback.
155
 
    | 
156
 
    | Bazaar is now available for download from 
157
 
    | http://bazaar-vcs.org/Download as a source tarball; packages 
158
 
    | for various systems will be available soon.
159
 
    | 
160
 
    | <<NEWS section from this release back to the last major release>>
 
163
      Subject: bzr x.yy released!
 
164
      
 
165
      <<Summary paragraph from news>>
 
166
     
 
167
      The Bazaar team is happy to announce availability of a new 
 
168
      release of the bzr adaptive version control system.
 
169
      Bazaar is part of the GNU system <http://gnu.org/>.
 
170
     
 
171
      Thanks to everyone who contributed patches, suggestions, and
 
172
      feedback.
 
173
      
 
174
      Bazaar is now available for download from 
 
175
      http://bazaar-vcs.org/Download as a source tarball; packages 
 
176
      for various systems will be available soon.
 
177
      
 
178
      <<NEWS section from this release back to the last major release>>
 
179
 
 
180
   Feel free to tweak this to your taste.
161
181
 
162
182
#. Make an announcement through <https://launchpad.net/bzr/+announce>
163
183
 
170
190
   you do not have a Freshmeat account yet, ask one of the existing
171
191
   admins.
172
192
 
173
 
#. Update http://en.wikipedia.org/wiki/Bzr -- this should be done for
174
 
   final releases but not for Release Candidates.
 
193
#. Update `<http://en.wikipedia.org/wiki/Bazaar_(software)>`_ -- this should be done
 
194
for final releases but not for Release Candidates.
175
195
 
176
196
#. Update the python package index: <http://pypi.python.org/pypi/bzr> - best
177
197
   done by running ::
193
213
the version number in ``bzr`` and ``bzrlib/__init__.py``.  Submit this
194
214
back into pqm for bzr.dev.
195
215
 
 
216
You should also merge (not pull) the release branch into
 
217
``lp:~bzr/bzr/current``, so that branch contains the current released code
 
218
at any time.
 
219
 
196
220
 
197
221
See also
198
222
--------
199
223
 
200
 
 * `Packaging into the bzr PPA <ppa.html>`_ to make and publish Ubuntu
201
 
   packages.
202
 
 * `Bazaar Developer Document Catalog <index.html>`_
203
 
 * `Development cycles <cycle.html>`_: things that happen during the cycle
204
 
   before the actual release.
205
 
 
 
224
* `Packaging into the bzr PPA <ppa.html>`_ to make and publish Ubuntu
 
225
  packages.
 
226
* `Bazaar Developer Document Catalog <index.html>`_
 
227
* `Development cycles <cycle.html>`_: things that happen during the cycle
 
228
  before the actual release.
206
229
 
207
230
..
208
231
   vim: filetype=rst textwidth=74 ai shiftwidth=4