/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/en/user-reference/hooks.txt

  • Committer: Robert Collins
  • Date: 2007-09-19 05:14:14 UTC
  • mto: (2835.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 2836.
  • Revision ID: robertc@robertcollins.net-20070919051414-2tgjqteg7k3ps4h0
* ``pull``, ``merge`` and ``push`` will no longer silently correct some
  repository index errors that occured as a result of the Weave disk format.
  Instead the ``reconcile`` command needs to be run to correct those
  problems if they exist (and it has been able to fix most such problems
  since bzr 0.8). Some new problems have been identified during this release
  and you should run ``bzr check`` once on every repository to see if you
  need to reconcile. If you cannot ``pull`` or ``merge`` from a remote
  repository due to mismatched parent errors - a symptom of index errors -
  you should simply take a full copy of that remote repository to a clean
  directory outside any local repositories, then run reconcile on it, and
  finally pull from it locally. (And naturally email the repositories owner
  to ask them to upgrade and run reconcile).
  (Robert Collins)

* ``VersionedFile.fix_parents`` has been removed as a harmful API.
  ``VersionedFile.join`` will no longer accept different parents on either
  side of a join - it will either ignore them, or error, depending on the
  implementation. See notes when upgrading for more information.
  (Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-reference/hooks.txt
 
1
###############
 
2
Hooks Reference 
 
3
###############
 
4
 
 
5
post_push
 
6
#########
 
7
 
 
8
Run after ``push`` has completed.
 
9
 
 
10
The hook signature is (push_result), containing the members
 
11
(source, local, master, old_revno, old_revid, new_revno, new_revid)
 
12
where local is the local target branch or None, master is the target 
 
13
master branch, and the rest should be self-explanatory. The source
 
14
is read-locked and the target branches are write-locked. Source will
 
15
be the local low-latency branch.
 
16
 
 
17
 
 
18
post_pull
 
19
#########
 
20
Run after ``pull`` has completed.
 
21
 
 
22
The hook signature is (push_result) containing the members
 
23
(source, local, master, old_revno, old_revid, new_revno, new_revid)
 
24
where local is the local target branch or None, master is the target 
 
25
master branch, and the rest should be self explanatory. The source
 
26
is read-locked and the target branches are write-locked. Source will
 
27
be the local low-latency branch.
 
28
 
 
29
pre_commit
 
30
##########
 
31
Run prefore ``commit`` has completed.
 
32
 
 
33
The hook signature is (local, master, old_revno, old_revid, future_revno,
 
34
future_revid, tree_delta, future_tree) where old_revno is NULL_REVISION for
 
35
the first commit to a branch, tree_delta is a TreeDelta object describing
 
36
changes from the basis revision, and future_tree is an in-memory tree
 
37
obtained from CommitBuilder.revision_tree(). Hooks MUST NOT modify tree_delta
 
38
and future_tree.
 
39
 
 
40
post_commit
 
41
###########
 
42
Run after ``commit`` has completed.
 
43
 
 
44
The hook signature is (local, master, old_revno, old_revid, new_revno,
 
45
new_revid) old_revid is NULL_REVISION for the first commit to a branch.
 
46
 
 
47
post_uncommit
 
48
#############
 
49
Run after ``uncommit`` has completed.
 
50
 
 
51
The api signature is (local, master, old_revno, old_revid, new_revno,
 
52
new_revid) where local is the local branch or None, master is the target
 
53
branch, and an empty branch receives new_revno of 0, new_revid of None.
 
54
 
 
55
set_rh
 
56
######
 
57
Run after the branch's revision history has been modified (push, pull, commit
 
58
and uncommit can all modify the revision history).
 
59
 
 
60
The hook signature is (branch, revision_history), and the branch will be
 
61
write-locked.
 
62
 
 
63
See also `Using Hooks <../user-guide/hooks.html>`_.