← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/releasing.txt

  • Committer: Tarmac
  • Author(s): Vincent Ladeuil, Patch Queue Manager, Jelmer Vernooij
  • Date: 2017-01-17 16:20:41 UTC
  • mfrom: (6619.1.2 trunk)
  • Revision ID: tarmac-20170117162041-oo62uk1qsmgc9j31
Merge 2.7 into trunk including fixes for bugs #1622039, #1644003, #1579093 and #1645017. [r=vila]

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/releasing.txt
513
513
----------------------------
514
514
 
515
515
#. Post to the ``bazaar@lists.canonical.com`` and
516
 
   ``bzr-packagers@list.launchpad.net`` lists, saying that the source has
 
516
   ``bzr-packagers@lists.launchpad.net`` lists, saying that the source has
517
517
   been frozen. Be extra clear that this is only a *source* release targeted
518
518
   at packagers and installer builders (see
519
519
   <https://bugs.launchpad.net/launchpad/+bug/645084>).  This is the cue for
551
551
   <http://doc.bazaar.canonical.com>.  It should be automatically build when
552
552
   the branch is created, by a cron script ``update-bzr-docs`` on
553
553
   ``escudero``. When the first release is created in a new series, a branch
554
 
   needs to be created on zhongshan::
 
554
   needs to be created on ``escudero``::
555
555
 
556
 
     ssh zhongshan.canonical.com
 
556
     ssh escudero.canonical.com
557
557
     sudo -u bzr-web -s
558
558
     cd /srv/doc.bazaar.canonical.com/
559
 
     bzr branch http://bazaar.launchpad.net/~bzr-pqm/bzr/2.6 bzr/bzr.2.6
 
559
     bzr branch lp:bzr/2.7 bzr/bzr.2.7
560
560
 
561
561
   And the ``bzr/bin/update-bzr-docs`` script needs to refer to it.
562
562
 
640
640
#. Update `<http://en.wikipedia.org/wiki/Bazaar_(software)>`_ -- this should
641
641
   be done for the stable and beta releases.
642
642
 
643
 
#. Update the python package index: <http://pypi.python.org/pypi/bzr> - best
644
 
   done by running ::
645
 
 
646
 
       python setup.py register
 
643
#. Update the python package index: <http://pypi.python.org/pypi/bzr>
 
644
 
 
645
   From the tarball created and tested earlier ::
 
646
 
 
647
     twine upload -s ../bzr-2.7.0.tar.gz
647
648
 
648
649
   Remember to check the results afterward -- this should be done for
649
650
   stable releases but not for beta releases nor SRUs.
650
651
 
651
 
   To be able to register the release you must create an account on
652
 
   <http://pypi.python.org/pypi> and have one of the existing owners of
653
 
   the project add you to the group.
 
652
   The ``twine`` command is provided by the ``twine`` package on Debian and
 
653
   Ubuntu.
 
654
 
 
655
   If in doubt, you can test with <https://testpypi.python.org/pypi> where
 
656
   you can register yourself, register the bzr project and upload (and then
 
657
   remove the upload and delete the project so a new release manager can
 
658
   enjoy the same facilities). If the project already exists, have one of
 
659
   the existing owners of the project add you to the group.
 
660
 
 
661
   To use the pypi test site, you need to record your credentials for an
 
662
   existing user (the registration process is manual and starts at
 
663
   <https://testpypi.python.org/pypi?%3Aaction=register_form>.
 
664
 
 
665
   Once registered, you can record your crdentials in your ``~/pypirc`` file
 
666
   with ::
 
667
 
 
668
     [testpypi]
 
669
     username:<login on testpypi>
 
670
     password:<password on testpypi>
 
671
     repository = https://testpypi.python.org/pypi
 
672
 
 
673
   Registering the bzr project if doesn't exist is achieved with::
 
674
 
 
675
     python setup.py -r https://testpypi.python.org/pypi register
 
676
 
 
677
  Uploading is done with::
 
678
 
 
679
    twine upload -r testpypi -s ../bzr-2.7.0.tar.gz
 
680
 
 
681
   To be able to upload the release you must create an account on
 
682
   <http://pypi.python.org/pypi> and have one of the existing owners of the
 
683
   project add you to the group and update your ``[pypi]`` section in your
 
684
   ``~/pypirc`` file.
654
685
 
655
686
 
656
687
Merging the released code back to trunk