/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/development-repo.txt

  • Committer: Richard Wilbur
  • Date: 2016-02-04 19:07:28 UTC
  • mto: This revision was merged to the branch mainline in revision 6618.
  • Revision ID: richard.wilbur@gmail.com-20160204190728-p0zvfii6zase0fw7
Update COPYING.txt from the original http://www.gnu.org/licenses/gpl-2.0.txt  (Only differences were in whitespace.)  Thanks to Petr Stodulka for pointing out the discrepancy.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/development-repo.txt
44
44
   development version available before pulling in bzr.dev changes
45
45
   around release time, as that is when old format cleanups will occur.
46
46
 
47
 
We cannot guarantee backwards compatibility though, because some of the
 
47
We cannot guarantee backwards compatability though, because some of the
48
48
planned work may be 'upgrade only'. Please see ``bzr help formats`` for
49
49
the text of the 'development' format which will indicate its
50
 
compatibility with other formats if you need to interoperate with
 
50
compatability with other formats if you need to interoperate with
51
51
users or services that do not have bzr.dev.
52
52
 
53
53
Before converting to a development format
89
89
for branches, you can make it a ``development`` repository like this::
90
90
 
91
91
  cd my-repo
92
 
  bzr init-shared-repo --development .
 
92
  bzr init-repo --development .
93
93
  cd my-stuff
94
94
  bzr init
95
95
  bzr add
96
96
  bzr commit -m "initial import"
97
97
 
98
98
In other words, use the normal sequence of commands but add the
99
 
``--development`` option to the ``init-shared-repo`` command.
 
99
``--development`` option to the ``init-repo`` command.
100
100
 
101
101
Upgrading an existing branch or repository to development
102
102
---------------------------------------------------------
141
141
Here are the commands for the shared repository approach::
142
142
 
143
143
  cd my-repo
144
 
  bzr init-shared-repo --development .
 
144
  bzr init-repo --development .
145
145
  bzr branch my-source-branch my-new-branch
146
146
  cd my-new-branch
147
147
 
171
171
 
172
172
If you need any help or encounter any problems, please contact the developers
173
173
via the usual ways, i.e. chat to us on IRC or send a message to our mailing
174
 
list. See https://www.breezy-vcs.org/pages/support.html for contact details.
 
174
list. See http://wiki.bazaar.canonical.com/BzrSupport for contact details.
175
175
 
176
176
 
177
177
Technical notes
200
200
   ``development`` and ``development-subtree`` formats to point to the
201
201
   new class you are creating.
202
202
3. Add a new development format (and tests!). Repository formats are in
203
 
   ``breezy.repofmt``. You probably want to reproduce the current
204
 
   development format from ``breezy.repofmt.pack_repo`` with just new
 
203
   ``bzrlib.repofmt``. You probably want to reproduce the current
 
204
   development format from ``bzrlib.repofmt.pack_repo`` with just new
205
205
   disk format strings, ``_get_matching_bzrdir`` and help.
206
206
4. Register your development format with the various registries. At the
207
207
   moment you need to update:
208
208
 
209
 
    1. ``breezy/bzrdir.py`` to register the WT/Branch/Repository
 
209
    1. ``bzrlib/bzrdir.py`` to register the WT/Branch/Repository
210
210
       collection.
211
211
 
212
 
    2. ``breezy/workingtree.py``, ``breezy/branch.py``,
213
 
       ``breezy/repository.py``, each one maintains a direct list of
 
212
    2. ``bzrlib/workingtree.py``, ``bzrlib/branch.py``,
 
213
       ``bzrlib/repository.py``, each one maintains a direct list of
214
214
       their respective formats.
215
215
 
216
216
    3. For repositories, you also need to update the InterKnit1and2
218
218
       non-rich-root repositories.
219
219
 
220
220
    4. For repositories based on KnitPackRepository, you need to update
221
 
       ``breezy/tests/test_pack_repository.py`` to add the class to the
 
221
       ``bzrlib/tests/test_pack_repository.py`` to add the class to the
222
222
       tested permutations.
223
223
 
224
224
5. Alter any other things that do class based tests. The easiest way
225
 
   to find these is a grep for Development in breezy - and please
 
225
   to find these is a grep for Development in bzrlib - and please
226
226
   refactor as you find these to reduce the relevance this step has,
227
227
   as it should not need to exist.
228
228
6. Now subclass/create from scratch/whatever the live object code you