~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/formats.txt

  • Committer: mbp at sourcefrog
  • Date: 2005-03-09 06:49:00 UTC
  • Revision ID: mbp@sourcefrog.net-20050309064900-74935ffb7350b24b
import more files from baz

Show diffs side-by-side

added added

removed removed

Lines of Context:
98
98
  include merges add to this file; lines are never removed or
99
99
  reordered.
100
100
 
101
 
``pending-merges`` 
102
 
  List (one per line) of non-mainline revisions that
103
 
  have been merged and are waiting to be committed.
 
101
``pending-merge-patches``
 
102
  List of foreign patches that have been merged and are waiting to be
 
103
  committed. 
104
104
 
105
105
``branch-name``
106
106
  User-qualified name of the branch, for the purpose of describing the
174
174
An inventory is stored for recorded revisions, also a
175
175
``pending-inventory`` for a working directory.
176
176
 
177
 
Inventories always have the same id as the revision they correspond
178
 
to.  bzr up to 0.0.5 explicitly stores an inventory-id; in future
179
 
versions this may be implied.
180
 
 
181
177
 
182
178
 
183
179
Revision
195
191
timestamp
196
192
  As floating-point seconds since epoch.
197
193
 
 
194
precursor
 
195
  ID of the previous revision on this branch.  May be absent (null) if
 
196
  this is the start of a new branch.
 
197
 
198
198
branch name
199
199
  Name of the branch to which this was originally committed.    
200
200
 
201
201
  (I'm not totally satisfied that this is the right way to do it; the
202
 
  results will be a bit weird when a series of revisions pass through
 
202
  results will be a bit wierd when a series of revisions pass through
203
203
  variously named branches.)
204
204
 
205
205
inventory_hash
206
206
  Acts as a pointer to the inventory for this revision.
207
207
 
208
 
parents
209
 
  Zero, one, or more references to parent revisions.   For each 
210
 
  the revision-id and the revision file's hash are given.  The first
211
 
  parent is by convention the revision in whose working tree the
212
 
  new revision was created.
213
 
 
214
 
precursor
215
 
  Must be equal to the first parent, if any are given.  For
216
 
  compatibility with bzr 0.0.5 and earlier; eventually will be
217
 
  removed. 
218
 
 
219
208
merged-branches
220
209
  Revision ids of complete branches merged into this revision.  If a
221
210
  revision is listed, that revision and transitively its predecessor
249
238
need to walk the whole history of the branch to build this list.
250
239
  
251
240
 
252
 
----
253
 
 
254
 
Proposed changes
255
 
****************
256
 
 
257
 
* Don't store parent-id in all revisions, but rather have <DIRECTORY>
258
 
  nodes that contain entries for children?
259
 
 
260
 
* Assign an id to the root of the tree, perhaps listed in the top of
261
 
  the inventory?