~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/formats.txt

  • Committer: Martin Pool
  • Date: 2005-07-16 00:07:40 UTC
  • mfrom: (909.1.5)
  • Revision ID: mbp@sourcefrog.net-20050716000740-f2dcb8894a23fd2d
- merge aaron's bugfix branch
  up to abentley@panoramicfeedback.com-20050715134354-78f2bca607acb415

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-merge-patches``
102
 
  List of foreign patches that have been merged and are waiting to be
103
 
  committed. 
 
101
``pending-merges`` 
 
102
  List (one per line) of non-mainline revisions that
 
103
  have been merged and are waiting to be 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
 
177
181
 
178
182
 
179
183
Revision
191
195
timestamp
192
196
  As floating-point seconds since epoch.
193
197
 
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 wierd when a series of revisions pass through
 
202
  results will be a bit weird 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
 
208
219
merged-branches
209
220
  Revision ids of complete branches merged into this revision.  If a
210
221
  revision is listed, that revision and transitively its predecessor
238
249
need to walk the whole history of the branch to build this list.
239
250
  
240
251
 
 
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?