/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/developers/ppa.txt

  • Committer: John Ferlito
  • Date: 2009-06-03 10:26:06 UTC
  • mto: (4665.4.1 ppa-doc)
  • mto: This revision was merged to the branch mainline in revision 4693.
  • Revision ID: johnf@inodes.org-20090603102606-imezzcfx59wcaxwp
Fix missing bang from first line of script

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/ppa.txt
19
19
    Final released versions.
20
20
 
21
21
<https://launchpad.net/~bzr-beta-ppa/+archive>
22
 
    Releases and release candidates.
 
22
    Releases and release candidates.    
23
23
 
24
24
<https://launchpad.net/~bzr-nightly-ppa/+archive>
25
25
    Automatic nightly builds from trunk.
38
38
versions it is also copied to the main PPA.
39
39
 
40
40
The packaging information is kept in branches of bzr on Launchpad, named
41
 
like
 
41
like 
42
42
<https://code.launchpad.net/~bzr/bzr/packaging-hardy>.
43
43
or
44
44
<lp:~bzr/bzr/packaging-hardy>.  These branches are intended to be used
46
46
 
47
47
Preconditions
48
48
-------------
49
 
 
50
 
* You must have a Launchpad account and be a member of the teams
 
49
  
 
50
* You must have a Launchpad account and be a member of the teams 
51
51
  that own these PPAs (``~bzr``, ``~bzr-beta-ppa``).
52
52
 
53
53
* You must have a GPG key registered to your Launchpad account.
75
75
 
76
76
    [DEFAULT]
77
77
    default_host_main = notspecified
78
 
 
 
78
  
79
79
* Configure ``bzr-builddeb`` to sign the package, which is required for
80
80
  Launchpad to build it.  Put this in ``~/.bazaar/builddeb.conf`` ::
81
81
 
107
107
release packages is as simple as::
108
108
 
109
109
  cd ~/dev/bzr/releases/packaging
110
 
  export VERSION="1.17~rc1-1~bazaar1"
 
110
  export VERSION="1.6~beta3-1~bazaar1"
111
111
  export PACKAGE="bzr"
112
112
  export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
113
113
  ~/dev/bzr/bzr.dev/tools/packaging/update-packaging-branches.sh
114
114
  ~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh
115
 
  ~/dev/bzr/bzr.dev/tools/packaging/update-control.sh 1.16 1.17 1.18
 
115
  ~/dev/bzr/bzr.dev/tools/packaging/update-control.sh 1.5 1.6 1.7
116
116
  ~/dev/bzr/bzr.dev/tools/packaging/build-packages.sh
117
 
  dput bzr-beta-ppa ${PACKAGE}_$VERSION*.changes
 
117
  dput bzr-beta-ppa bzr_$VERSION*.changes
118
118
 
119
119
Rinse and repeat for all the plugins by changing VERSION and PACKAGE.
120
120
 
130
130
 
131
131
#. Decide on the final version number.  It should be of this form::
132
132
 
133
 
     bzr-1.17~rc1-1~bazaar1~hardy1
 
133
     bzr-1.6~beta3-1~bazaar1~hardy1
134
134
 
135
135
   **Note:** There are three hyphen-separated parts: the *package name*,
136
136
   the *upstream version*, and the *packaging version*.
137
137
 
138
138
   **Caution:** Upstream betas or release candidates must insert a tilde
139
139
   to make them sort before the final release, like this:
140
 
   ``bzr-1.17~rc1-1~bazaar1~hardy1``.
 
140
   ``bzr-1.6~beta3-1~bazaar1~hardy1``.
141
141
 
142
142
   Final releases will use a release string of the form:
143
 
   ``bzr-1.17-1~bazaar1~hardy1``
 
143
   ``bzr-1.6-1~bazaar1~hardy1``
144
144
 
145
145
   Set this base of this up as a usable environment variable::
146
146
 
147
 
      export VERSION="1.17~rc1-1~bazaar1"
 
147
      export VERSION="1.6~beta3-1~bazaar1"
148
148
 
149
149
#. Export the distroreleases that you will be packaging for::
150
150
 
170
170
 
171
171
   For bzrtools this is typically::
172
172
 
173
 
      Build-Depends-Indep: bzr (>= 1.17~), rsync
174
 
      Depends: ${python:Depends}, bzr (>= 1.17~), bzr (<< 1.18~), patch
 
173
      Build-Depends-Indep: bzr (>= 1.6~), rsync
 
174
      Depends: ${python:Depends}, bzr (>= 1.6~), bzr (<< 1.7~), patch
175
175
 
176
 
   There is a helper script which will update the control file and commit it
 
176
   There is a helper script which will update the contro file and commit it
177
177
   for all of your ``$UBUNTU_RELEASES``. It is available as::
178
178
 
179
179
    tools/packaging/update-control.sh
180
180
 
181
 
   You must supply the versions as arguments as follows
 
181
   The must supply the versions as arguments as follows
182
182
   OLD_VERSION CURRENT_VERSION NEXT_VERSION, such as::
183
183
 
184
 
    tools/packaging/update-control.sh 1.16 1.17 1.18
 
184
    tools/packaging/update-control.sh 1.5 1.6 1.7
185
185
 
186
186
#. Make a new ``debian/changelog`` entry for the new release,
187
187
   either by using ``dch`` or just editing the file::
188
188
 
189
 
      dch -v '1.17~rc1-1~bazaar1~hardy1' -D hardy
 
189
      dch -v '1.6~beta3-1~bazaar1~hardy1' -D hardy
190
190
 
191
191
   dch will default to the distro you're working in and this isn't checked
192
 
   against the version number (which is just our convention), so make sure
 
192
   against the version number (which is just our convention), so make sure 
193
193
   to specify it.
194
194
 
195
195
   Make sure you have the correct email address for yourself (you may need
196
196
   export DEBEMAIL=`bzr whoami` if it isn't already set), version number, and
197
197
   distribution.  It should look something like this::
198
198
 
199
 
       bzr (1.17~rc1-1~bazaar1~hardy1) hardy; urgency=low
200
 
 
 
199
       bzr (1.6~beta3-1~bazaar1~hardy1) hardy; urgency=low
 
200
     
201
201
        * New upstream release.
202
 
 
 
202
     
203
203
       -- John Sample <sample@example.com>  Mon, 31 Mar 2008 12:36:27 +1100
204
204
 
205
205
   If you need to upload the package again to fix a problem, normally you
233
233
 
234
234
#. Upload into the beta PPA for each release::
235
235
 
236
 
     dput bzr-beta-ppa bzr*1.17-1*.changes
 
236
     dput bzr-beta-ppa bzr*1.6-1*.changes
237
237
 
238
238
#. For final release versions, also copy it into the ``~bzr`` PPA::
239
239
 
240
 
     dput bzr-ppa ../bzr_1.17-1\~bazaar1\~hardy1\_source.changes
 
240
     dput bzr-ppa ../bzr_1.6-1\~bazaar1\~hardy1\_source.changes
241
241
 
242
242
   Alternatively, you can use Launchpad's "copy" feature to copy the
243
243
   packages between repositories.
251
251
Packaging bzr-svn
252
252
~~~~~~~~~~~~~~~~~
253
253
 
254
 
bzr-svn uses a packaging branch that contains both the source
 
254
bzr-svn uses a packaging branch that contains both the source 
255
255
(including any changes against upstream) and the ``debian/`` directory.
256
256
 
257
257
To build bzr-svn:
259
259
#. Get a checkout of ``lp:~bzr/bzr-svn/hardy-ppa/``
260
260
 
261
261
#. Merge from ``http://bzr.debian.org/pkg-bazaar/bzr-svn/unstable/``
262
 
 
 
262
  
263
263
   This should bring in both upstream and packaging changes for the new
264
264
   release, and it's updated as part of the bzr-svn release process.
265
265