← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/packrepo.txt

  • Committer: Robert Collins
  • Date: 2008-02-13 03:30:01 UTC
  • mfrom: (3221 +trunk)
  • mto: This revision was merged to the branch mainline in revision 3224.
  • Revision ID: robertc@robertcollins.net-20080213033001-rw70ul0zb02ph856
Merge to fix conflicts.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/packrepo.txt
42
42
``knitpack`` one. Here's how::
43
43
 
44
44
  cd my-stuff
45
 
  bzr init --knitpack-experimental
 
45
  bzr init --pack-0.92
46
46
  bzr add
47
47
  bzr commit -m "initial import"
48
48
 
49
49
In other words, use the normal sequence of commands but add the
50
 
``--knitpack-experimental`` option to the ``init`` command.
 
50
``--pack-0.92`` option to the ``init`` command.
 
51
 
 
52
**Note:** In bzr 0.92, this format was called ``knitpack-experimental``.
51
53
 
52
54
Creating a new knitpack repository
53
55
----------------------------------
56
58
for branches, you can make it a ``knitpack`` repository like this::
57
59
 
58
60
  cd my-repo
59
 
  bzr init-repo --knitpack-experimental .
 
61
  bzr init-repo --pack-0.92 .
60
62
  cd my-stuff
61
63
  bzr init
62
64
  bzr add
63
65
  bzr commit -m "initial import"
64
66
 
65
67
In other words, use the normal sequence of commands but add the
66
 
``--knitpack-experimental`` option to the ``init-repo`` command.
 
68
``--pack-0.92`` option to the ``init-repo`` command.
67
69
 
68
70
Upgrading an existing branch or repository to knitpack format
69
71
-------------------------------------------------------------
71
73
If you have an existing branch and wish to migrate it to
72
74
a ``knitpack`` format, use the ``upgrade`` command like this::
73
75
 
74
 
  bzr upgrade --knitpack-experimental path-to-my-branch
 
76
  bzr upgrade --pack-0.92 path-to-my-branch
75
77
 
76
78
If you are using a shared repository, run::
77
79
 
78
 
  bzr upgrade --knitpack-experimental ROOT_OF_REPOSITORY
 
80
  bzr upgrade --pack-0.92 ROOT_OF_REPOSITORY
79
81
 
80
82
to upgrade the history database. Note that this will not
81
83
alter the branch format of each branch, so
95
97
 
96
98
Here are the commands for using the ``pull`` approach::
97
99
 
98
 
    bzr init --knitpack-experimental my-new-branch
 
100
    bzr init --pack-0.92 my-new-branch
99
101
    cd my-new-branch
100
102
    bzr pull my-source-branch
101
103
 
103
105
 
104
106
    bzr branch my-source-branch my-new-branch
105
107
    cd my-new-branch
106
 
    bzr upgrade --knitpack-experimental .
 
108
    bzr upgrade --pack-0.92 .
107
109
 
108
110
Here are the commands for the shared repository approach::
109
111
 
110
112
  cd my-repo
111
 
  bzr init-repo --knitpack-experimental .
 
113
  bzr init-repo --pack-0.92 .
112
114
  bzr branch my-source-branch my-new-branch
113
115
  cd my-new-branch
114
116
 
281
283
However, in some circumstances we may want to garbage-collect or prune
282
284
existing data, or reconcile indexes.
283
285
 
284
 
  vim: tw=72 ft=rest expandtab
 
286
..
 
287
   vim: tw=72 ft=rst expandtab