/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/developers/releasing.txt

• browse files at revision 3453.2.8
• compare with another revision
• compare with revision 5200.2.3
• download diff
• download tarball
• view history from revision 3453.2.8

Show diffs side-by-side

added

removed

doc/developers/releasing.txt

23

23

#. Add a new "series" in Launchpad at <https://launchpad.net/bzr/+addseries>.  There is one 

24

24

   series for every *x.y* release.

25

25

 

 

26

 

26

27

Weekly Status Updates

27

28

---------------------

28

29

 

61

62

 

62

63

#. In the release branch, update  ``version_info`` in ``./bzrlib/__init__.py``

63

64

 

64

 

#. Add the date and release number to ``./NEWS``.

 

65

#. Add the date and release number to ``./NEWS``, and a one-paragraph

 

66

   summary of changes in this release.

65

67

 

66

68

#. Commit these changes to the release branch, using a command like::

67

69

    

100

102

Making the source tarball

101

103

-------------------------

102

104

 

103

 

#. Change into the source directory and run

 

105

#. Change into the source directory and run ::

104

106

  

105

107

     make dist

106

108

 

107

 

#. Unpack the tarball into a temporary directory and run ``make check`` in

108

 

   that directory, to check for packaging problems.

 

109

#. Now we'll try expanding this tarball and running the test suite

 

110

   to check for packaging problems::

 

111

 

 

112

     make check-dist-tarball

109

113

 

110

114

 

111

115

Publishing the release

188

192

 

189

193

   Remember to check the results afterwards.

190

194

 

 

195

   To be able to register the release you must create an account on

 

196

   <http://pypi.python.org/pypi> and have one of the existing owners of

 

197

   the project add you to the group.

 

198

 

191

199

 

192

200

Merging the released code back to trunk

193

201

---------------------------------------

214

222

 

215

223

The ``debian/`` directory containing the packaging information is kept in

216

224

branches on Launchpad, named like 

217

 

<https://code.launchpad.net/~bzr/bzrtools/packaging-dapper>.

 

225

<https://code.launchpad.net/~bzr/bzr/packaging-hardy>.

218

226

 

219

227

Preconditions for building these packages:

220

228

  

236

244

 

237

245

* You need a Ubuntu (or probably Debian) machine, and ::

238

246

 

239

 

    sudo apt-get install build-essential devscripts dput

 

247

    sudo apt-get install build-essential devscripts dput quilt patch

240

248

 

241

249

Here is the process; there are some steps which should be automated in

242

250

future:

243

251

 

244

252

#. You will need a working directory for each supported release, such as

245

 

   ``~/bzr/Packaging/dapper``

 

253

   ``~/bzr/Packaging/hardy``

246

254

 

247

255

#. Download the official tarball of the release to e.g. ``~/bzr/Releases``

248

256

 

249

257

#. Copy the original tarball into your per-disto directory, then untar it 

250

258

   and if necessary rename it::

251

259

 

252

 

     cp -l ~/bzr/Releases/bzrtools-1.3.0.tar.gz bzrtools_1.3.0.orig.tar.gz

253

 

     tar xfvz bzrtools_1.3.0.orig.tar.gz

254

 

     mv bzrtools bzrtools-1.3.0

 

260

     cp -l ~/bzr/Releases/bzr-1.3.tar.gz bzr_1.3.orig.tar.gz

 

261

     tar xfvz bzr_1.3.orig.tar.gz

 

262

     mv bzr bzr-1.3

255

263

 

256

264

#. Change into that directory and check out the packaging branch::

257

265

 

258

 

     cd bzrtools

 

266

     cd bzr

259

267

     bzr checkout \

260

 

       bzr+ssh://bazaar.launchpad.net/~bzr/bzrtools/packaging-dapper \

 

268

       bzr+ssh://bazaar.launchpad.net/~bzr/bzr/packaging-hardy \

261

269

       debian

262

270

 

263

271

#. For Bazaar plugins, change the ``debian/control`` file to express a

271

279

#. Make a new ``debian/changelog`` entry for the new release,

272

280

   either by using ``dch`` or just editing the file::

273

281

 

274

 

     dch -v '1.3.0-1~bazaar1~dapper1' -D dapper

 

282

     dch -v '1.3-1~bazaar1' -D hardy

275

283

 

276

284

   dch will default to the distro you're working in and this isn't checked

277

285

   against the version number (which is just our conversion), so make sure 

278

286

   to specify it.

279

287

 

280

 

   **Caution:** Release candidates must insert a tilde to make them sort before the

281

 

   final release, like this: ``bzr-1.4~rc2-1~bazaar1~dapper1``.

 

288

   **Caution:** Release candidates must insert a tilde to make them sort 

 

289

   before the final release, like this: ``bzr-1.4~rc2-1~bazaar1``.

282

290

 

283

291

   Make sure you have the correct email address for yourself, version

284

292

   number, and distribution.  It should look something like this::

285

293

 

286

 

       bzrtools (1.3.0-1~bazaar1~dapper1) dapper; urgency=low

 

294

       bzr (1.3-1~bazaar1) hardy; urgency=low

287

295

     

288

296

        * New upstream release.

289

297

     

297

305

 

298

306

#. Commit these changes into the packaging branch::

299

307

 

300

 

     bzr ci -m '1.3.0-1~bazaar1~dapper1: New upstream release.' debian

 

308

     bzr ci -m '1.3-1~bazaar1: New upstream release.' debian

301

309

 

302

310

#. Build a source package::

303

311

 

304

 

     debuild -S -sa -i

 

312

     debuild -S -sa -i -D

305

313

 

306

314

   This will create a ``.changes`` file in the per-distro directory,

307

315

   and should invoke gpg to sign it with your key.

310

318

 

311

319

#. Upload into the PPA::

312

320

 

313

 

     dput bzr-ppa ../bzrtools__1.3.0-1\~bazaar1\~dapper1_source.changes

 

321

     dput bzr-ppa ../bzr__1.3-1\~bazaar1\_source.changes

314

322

 

315

323

   Don't forget the ``bzr-ppa`` component or dput will try to upload into

316

324

   the main archive by default.  You can disable this by adding this

319

327

     [ubuntu]

320

328

     fqdn = SPECIFY.A.PPA.NAME

321

329

 

 

330

#. Copy the uploaded package over to other Ubuntu releases, taking advantage 

 

331

   of Launchpad's Copy Package feature <https://launchpad.net/~bzr/+archive/+copy-packages>

 

332

 

 

333

   **Caution:** Make sure the dependencies are the same between Ubuntu releases,

 

334

   Dapper has different dependencies, but others might change in time.

 

335

   If you upload a release-specific version, you should add a ~release1 to

 

336

   the package version, for example:: bzr.1.3-1~bazaar1~dapper1

 

337

 

322

338

#. You should soon get an "upload accepted" mail from Launchpad, which

323

339

   means that your package is waiting to be built.  You can then track its

324

340

   progress in <https://launchpad.net/~bzr/+archive> and

325

341

   <https://launchpad.net/~bzr/+archive/+builds>.

326

342

 

 

343

If you add all the bzr PPAs to your ``sources.list`` then you can see a

 

344

summary of current package versions with::

327

345

 

 

346

  apt-cache madison bzr

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0