← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/knitpack.txt

  • Committer: Ian Clatworthy
  • Date: 2007-10-25 11:23:58 UTC
  • mto: (2943.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 2944.
  • Revision ID: ian.clatworthy@internode.on.net-20071025112358-7mn6oazh0bv5fqqi
review feedback from lifeless

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/knitpack.txt
7
7
Using KnitPack repositories
8
8
===========================
9
9
 
 
10
Motivation
 
11
----------
 
12
 
 
13
KnitPack is a new repository format for Bazaar, which is expected to be
 
14
faster both locally and over the network, is usually more compact, and
 
15
will work with more FTP servers.
 
16
 
 
17
Our benchmarking results to date have been very promising. We fully expect
 
18
to make a pack-based format the default in the near future.  We would
 
19
therefore like as many people as possible using KnitPack repositories,
 
20
benchmarking the results and telling us where improvements are still needed.
 
21
 
10
22
Preparation
11
23
-----------
12
24
 
56
68
Upgrading an existing branch or repository to knitpack format
57
69
-------------------------------------------------------------
58
70
 
59
 
If you have an existing branch or repository and wish to migrate it to
 
71
If you have an existing branch and wish to migrate it to
60
72
a ``knitpack`` format, use the ``upgrade`` command like this::
61
73
 
62
 
  bzr upgrade path-to-my-repo
 
74
  bzr upgrade path-to-my-branch
63
75
 
64
 
If ``path-to-my-repo`` is not provided, the current repository - and
65
 
all branches within it - will be upgraded.
 
76
If branches are within a shared repository, each branch needs to be
 
77
upgraded separately.
66
78
 
67
79
Starting a new knitpack branch from one in an older format
68
80
----------------------------------------------------------
83
95
 
84
96
    bzr branch my-source-branch my-new-branch
85
97
    cd my-new-branch
86
 
    bzr upgrade --knitpack-experimental
 
98
    bzr upgrade --knitpack-experimental .
87
99
 
88
100
Here are the commands for the shared repository approach::
89
101