← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/ppa.txt

  • Committer: John Arbash Meinel
  • Date: 2008-08-28 20:13:31 UTC
  • mfrom: (3658 +trunk)
  • mto: This revision was merged to the branch mainline in revision 3688.
  • Revision ID: john@arbash-meinel.com-20080828201331-dqffxf54l2heokll
Merge bzr.dev 3658

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/ppa.txt
73
73
    [DEFAULT]
74
74
    default_host_main = notspecified
75
75
  
76
 
    [notspecified]
77
 
    fqdn = SPECIFY.A.PPA.NAME 
78
 
 
79
76
* You need a Ubuntu (or probably Debian) machine, and ::
80
77
 
81
78
    sudo apt-get install build-essential devscripts dput quilt patch
91
88
 
92
89
#. Decide on the final version number.  It should be of this form::
93
90
 
94
 
     bzr-1.6~beta3-1~bazaar1
 
91
     bzr-1.6~beta3-1~bazaar1~hardy1
95
92
 
96
93
   There are three hyphen-separated parts: the *package name*, the *upstream
97
94
   version*, and the *packaging version*.
98
95
 
99
96
   **Caution:** Upstream betas or release candidates must insert a tilde
100
97
   to make them sort before the final release, like this:
101
 
   ``bzr-1.4~rc2-1~bazaar1``.
 
98
   ``bzr-1.6~beta3-1~bazaar1~hardy1``.
 
99
 
 
100
#. Create a directory per release::
 
101
 
 
102
     mkdir ~/bzr/Releases/hardy
102
103
 
103
104
#. Copy or hardlink the original tarball into your per-disto directory, under an 
104
105
   appropriate name ending in ``.orig.tar.gz``.  Untar it.  The extracted
105
106
   source directory and ``.orig`` file must match the version number you
106
107
   calculated above.  For example::
107
108
 
108
 
     cp -l ~/bzr/Releases/bzr-1.6b3.tar.gz bzr_1.6~beta3.orig.tar.gz
 
109
     cp -l ~/bzr/Releases/bzr-1.6b3.tar.gz ~/bzr/Releases/hardy/bzr_1.6~beta3.orig.tar.gz
 
110
     cd ~/bzr/Releases/hardy
109
111
     tar xfvz bzr_1.6~beta3.orig.tar.gz
110
112
     mv bzr-1.6b3 bzr-1.6~beta3
111
113
 
121
123
 
122
124
   For bzrtools this is typically::
123
125
 
124
 
      Build-Depends-Indep: bzr (>= 1.3~), rsync
125
 
      Depends: ${python:Depends}, bzr (>= 1.3~), bzr (<< 1.4~), patch
 
126
      Build-Depends-Indep: bzr (>= 1.6~), rsync
 
127
      Depends: ${python:Depends}, bzr (>= 1.6~), bzr (<< 1.7~), patch
126
128
 
127
129
#. Make a new ``debian/changelog`` entry for the new release,
128
130
   either by using ``dch`` or just editing the file::
129
131
 
130
 
     dch -v '1.3-1~bazaar1' -D hardy
 
132
      dch -v '1.6~beta3-1~bazaar1~hardy1' -D hardy
131
133
 
132
134
   dch will default to the distro you're working in and this isn't checked
133
135
   against the version number (which is just our conversion), so make sure 
136
138
   Make sure you have the correct email address for yourself, version
137
139
   number, and distribution.  It should look something like this::
138
140
 
139
 
       bzr (1.3-1~bazaar1) hardy; urgency=low
 
141
       bzr (1.6~beta3-1~bazaar1~hardy1) hardy; urgency=low
140
142
     
141
143
        * New upstream release.
142
144
     
150
152
 
151
153
#. Commit these changes into the packaging branch::
152
154
 
153
 
     bzr ci -m '1.3-1~bazaar1: New upstream release.' debian
 
155
     bzr ci -m '1.6~beta3-1~bazaar1~hardy1: New upstream release.' debian
 
156
 
 
157
#. Remove the .bzr directory from the Debian dir, as this adds unnecessary
 
158
   cruft to the package::
 
159
 
 
160
     rm debian/.bzr -R
154
161
 
155
162
#. Build a source package::
156
163
 
161
168
   Check that file is reasonable: it should be uploading to the intended
162
169
   distribution, have a .orig file included, and the right version number.
163
170
 
164
 
#. Upload into the beta PPA::
165
 
 
166
 
     dput bzr-beta-ppa ../bzr__1.3-1\~bazaar1\_source.changes
167
 
 
168
 
#. Copy the uploaded package over to other Ubuntu releases, taking advantage 
169
 
   of Launchpad's Copy Package feature 
170
 
   <https://launchpad.net/~bzr-beta-ppa/+archive/+copy-packages>
171
 
 
172
 
#. For final release versions, also copy it into the ``~bzr`` PPA.
 
171
#. Upload into the beta PPA for each release::
 
172
 
 
173
     dput bzr-beta-ppa ../bzr__1.6~beta3-1\~bazaar1\~hardy1\_source.changes
 
174
 
 
175
#. For final release versions, also copy it into the ``~bzr`` PPA::
 
176
 
 
177
    dput bzr-ppa ../bzr__1.6-1\~bazaar1\~hardy1\_source.changes
173
178
 
174
179
#. You should soon get an "upload accepted" mail from Launchpad, which
175
180
   means that your package is waiting to be built.  You can then track its