/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/revision-properties.txt

  • Committer: Vincent Ladeuil
  • Date: 2012-01-18 14:09:19 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120118140919-rlvdrhpc0nq1lbwi
Change set/remove to require a lock for the branch config files.

This means that tests (or any plugin for that matter) do not requires an
explicit lock on the branch anymore to change a single option. This also
means the optimisation becomes "opt-in" and as such won't be as
spectacular as it may be and/or harder to get right (nothing fails
anymore).

This reduces the diff by ~300 lines.

Code/tests that were updating more than one config option is still taking
a lock to at least avoid some IOs and demonstrate the benefits through
the decreased number of hpss calls.

The duplication between BranchStack and BranchOnlyStack will be removed
once the same sharing is in place for local config files, at which point
the Stack class itself may be able to host the changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/revision-properties.txt
28
28
At the moment, three standardized revision properties are recognized and used
29
29
by bzrlib:
30
30
 
31
 
 * ``authors`` - Authors of the change. This value is a "\n" separated set
 
31
 * ``authors`` - Authors of the change. This value is a "\\n" separated set
32
32
   of values in the same format as the committer-id. This property can be
33
33
   set by passing a list to the keyword argument ``authors`` of the function
34
34
   ``MutableTree.commit``.
39
39
   or manually set by ``bzr nick``. The value is set automatically in
40
40
   ``MutableTree.commit``.
41
41
 * ``bugs`` - A list of bug URLs and their statuses. The list is separated
42
 
   by the new-line character (\n) and each entry is in format
 
42
   by the new-line character (\\n) and each entry is in format
43
43
   '<URL> <status>'. Currently, bzrlib uses only status 'fixed'. See
44
44
   `Bug Trackers`_ for more details about using this feature.
45
45