/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/packrepo.txt

  • Committer: Robert Collins
  • Date: 2010-05-06 11:08:10 UTC
  • mto: This revision was merged to the branch mainline in revision 5223.
  • Revision ID: robertc@robertcollins.net-20100506110810-h3j07fh5gmw54s25
Cleaner matcher matching revised unlocking protocol.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/packrepo.txt
10
10
Motivation
11
11
----------
12
12
 
13
 
KnitPack is a new repository format for Breezy, which is expected to be
 
13
KnitPack is a new repository format for Bazaar, which is expected to be
14
14
faster both locally and over the network, is usually more compact, and
15
15
will work with more FTP servers.
16
16
 
58
58
for branches, you can make it a ``knitpack`` repository like this::
59
59
 
60
60
  cd my-repo
61
 
  bzr init-shared-repo --pack-0.92 .
 
61
  bzr init-repo --pack-0.92 .
62
62
  cd my-stuff
63
63
  bzr init
64
64
  bzr add
65
65
  bzr commit -m "initial import"
66
66
 
67
67
In other words, use the normal sequence of commands but add the
68
 
``--pack-0.92`` option to the ``init-shared-repo`` command.
 
68
``--pack-0.92`` option to the ``init-repo`` command.
69
69
 
70
70
Upgrading an existing branch or repository to knitpack format
71
71
-------------------------------------------------------------
110
110
Here are the commands for the shared repository approach::
111
111
 
112
112
  cd my-repo
113
 
  bzr init-shared-repo --pack-0.92 .
 
113
  bzr init-repo --pack-0.92 .
114
114
  bzr branch my-source-branch my-new-branch
115
115
  cd my-new-branch
116
116
 
138
138
 
139
139
If you need any help or encounter any problems, please contact the developers
140
140
via the usual ways, i.e. chat to us on IRC or send a message to our mailing
141
 
list. See https://www.breezy-vcs.org/pages/support.html for contact details.
 
141
list. See http://bazaar-vcs.org/BzrSupport for contact details.
142
142
 
143
143
 
144
144
Technical notes
145
145
===============
146
146
 
147
147
Bazaar 0.92 adds a new format (experimental at first) implemented in
148
 
``breezy.repofmt.pack_repo.py``.
 
148
``bzrlib.repofmt.pack_repo.py``.
149
149
 
150
150
This format provides a knit-like interface which is quite compatible
151
151
with knit format repositories: you can get a VersionedFile for a
186
186
                                             compression base
187
187
======== ========== ======================== ==========================
188
188
 
189
 
Indices are accessed through the ``breezy.index.GraphIndex`` class.
 
189
Indices are accessed through the ``bzrlib.index.GraphIndex`` class.
190
190
Indices are stored as sorted files on disk.  Each line is one record,
191
191
and contains:
192
192
 
250
250
 
251
251
The ``pack-names`` file gives the list of all finished non-obsolete
252
252
packs.  (This should always be the same as the list of files in the
253
 
``packs/`` directory, but the file is needed for read-only HTTP clients
 
253
``packs/`` directory, but the file is needed for readonly http clients
254
254
that can't easily list directories, and it includes other information.)
255
255
The constraint on the ``pack-names`` list is that every file mentioned
256
256
must exist in the ``packs/`` directory.