← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/specifying_revisions.txt

  • Committer: James Blackwell
  • Date: 2006-03-14 16:22:52 UTC
  • mto: This revision was merged to the branch mainline in revision 1700.
  • Revision ID: jblack@merconline.com-20060314162252-57b09902e2985779
Copied in docs for wiki & First round cleanup

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/specifying_revisions.txt
 
1
= Revision specs and ranges =
 
2
 
 
3
`bzr` has a very expressive way to specify a revision, or a range of revisions.
 
4
We'll take the example of the `log` command.
 
5
 
 
6
To specify a range of revisions, use for example::
 
7
 
 
8
    $ bzr log -r 1..4
 
9
 
 
10
You can omit one bound like::
 
11
 
 
12
    $ bzr log -r 1..
 
13
    $ bzr log -r ..4
 
14
 
 
15
Note::
 
16
    Omitting the lower bound doesn't work on currently released versions.
 
17
 
 
18
Other commands, like ```bzr cat``` take only one revision, not a range, like::
 
19
 
 
20
    $ bzr cat -r 42 foo.c
 
21
 
 
22
= Available revision specs =
 
23
 
 
24
The revision, or the bounds of the range, can be one of::
 
25
 
 
26
 +--------------------+------------------------------------+
 
27
 |  argument type     | description                        |
 
28
 +--------------------+------------------------------------+
 
29
 | ''number''         | revision number                    |
 
30
 +--------------------+------------------------------------+
 
31
 | `revno:`''number'' | positive revision number           |
 
32
 +--------------------+------------------------------------+
 
33
 | `last:`''number''  | negative revision number           |
 
34
 +--------------------+------------------------------------+
 
35
 | `revid:`''guid''   | globally unique revision id        |
 
36
 +--------------------+------------------------------------+
 
37
 | `before:`''rev''   | leftmost parent of ''rev''         |
 
38
 +--------------------+------------------------------------+
 
39
 | `date:`''value''   | first entry after a given date     |
 
40
 +--------------------+------------------------------------+
 
41
 | `ancestor:`''path''| last merged revision from a branch |
 
42
 +--------------------+------------------------------------+
 
43
 | `branch:`''path''  | latest revision on another branch  |
 
44
 +--------------------+------------------------------------+
 
45
 
 
46
Numbers
 
47
-------
 
48
 
 
49
Positive numbers denote revision numbers in the current branch. Revision
 
50
numbers are labelled as "revno" in the output of `bzr log`.
 
51
 
 
52
To display the log for the first ten revisions::
 
53
    $ bzr log -r ..10
 
54
 
 
55
Negative numbers count from the latest revision, -1 is the last committed
 
56
revision.
 
57
 
 
58
To display the log for the last ten revisions::
 
59
 
 
60
    $ bzr log -r -10..
 
61
 
 
62
revno, last
 
63
-----------
 
64
 
 
65
`revno:`''number'' is the same as ''number'', except that negative numbers are
 
66
not allowed.
 
67
 
 
68
`last:`''number'' is the same as -''number''. `last:1` means the last commited
 
69
revision.
 
70
 
 
71
revid
 
72
-----
 
73
 
 
74
`revid` allows specifying a an internal revision ID, as show by `bzr testament` and some other commands.
 
75
 
 
76
For example::
 
77
 
 
78
    $ bzr log -r revid:Matthieu.Moy@imag.fr-20051026185030-93c7cad63ee570df
 
79
 
 
80
 
 
81
[[Anchor(before)]]
 
82
before
 
83
------
 
84
 
 
85
`before:`''rev'' specifies the leftmost parent of ''rev'', that is the revision
 
86
that appears before ''rev'' in the revision history, or the revision that was
 
87
current when ''rev'' what comitted.
 
88
 
 
89
''rev'' can be any revision specifier.
 
90
 
 
91
For example::
 
92
 
 
93
    $ bzr log -r before:before:4
 
94
    ...
 
95
    revno: 2
 
96
    ...
 
97
 
 
98
date
 
99
----
 
100
 
 
101
`date:`''value'' matches the first history entry after a given date, either at
 
102
midnight or at a specified time.
 
103
 
 
104
Legal values are:
 
105
 
 
106
 * `yesterday`
 
107
 * `today`
 
108
 * `tomorrow`
 
109
 * A `YYYY-MM-DD` format date.
 
110
 * A `YYYY-MM-DD,HH:MM:SS` format date/time, seconds are optional (note the
 
111
   comma)
 
112
 
 
113
The proper way of saying "give me all the log entries for today" is::
 
114
 
 
115
    $ bzr log -r date:yesterday..date:today
 
116
 
 
117
Ancestor
 
118
--------
 
119
 
 
120
`ancestor:`''path'' specifies the common ancestor between the current branch, and a different branch. This is the same ancestor that would be used for merging purposes.
 
121
 
 
122
''path'' may be the URL of a remote branch, or the file path to a local branch.
 
123
 
 
124
For example, to see what changes were made on a branch since it was forked off ``../parent``: {{{
 
125
$ bzr diff -r ancestor:../parent
 
126
}}}
 
127
 
 
128
Branch
 
129
------
 
130
 
 
131
`branch:`''path'' specifies the latest revision in another branch.
 
132
 
 
133
''path'' may be the URL of a remote branch, or the file path to a local branch.
 
134
 
 
135
For example, to get the differences between this and another branch:{{{
 
136
$ bzr diff -r branch:http://example.com/bzr/foo.dev
 
137
}}}