← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/specifying_revisions.txt

  • Committer: Martin Pool
  • Date: 2005-07-28 11:56:24 UTC
  • Revision ID: mbp@sourcefrog.net-20050728115624-93c11c2b1e399023
- note changes to command line parsing

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/specifying_revisions.txt
1
 
Specifying revisions
2
 
====================
3
 
 
4
 
Revision identifiers and ranges
5
 
-------------------------------
6
 
 
7
 
Bazaar has a very expressive way to specify a revision or a range of revisions.
8
 
To specify a range of revisions, the upper and lower bounds are separated by the
9
 
``..`` symbol. For example::
10
 
 
11
 
    $ bzr log -r 1..4
12
 
 
13
 
You can omit one bound like::
14
 
 
15
 
    $ bzr log -r 1..
16
 
    $ bzr log -r ..4
17
 
 
18
 
Some commands take only one revision, not a range. For example::
19
 
 
20
 
    $ bzr cat -r 42 foo.c
21
 
 
22
 
In other cases, a range is required but you want the length of the range to
23
 
be one. For commands where this is relevant, the ``-c`` option is used like this::
24
 
 
25
 
    $ bzr diff -c 42
26
 
 
27
 
 
28
 
Available revision identifiers
29
 
------------------------------
30
 
 
31
 
The revision, or the bounds of the range, can be given using
32
 
different format specifications as shown below.
33
 
 
34
 
 +----------------------+------------------------------------+
35
 
 |  argument type       | description                        |
36
 
 +----------------------+------------------------------------+
37
 
 | *number*             | revision number                    |
38
 
 +----------------------+------------------------------------+
39
 
 | **revno**:*number*   | revision number                    |
40
 
 +----------------------+------------------------------------+
41
 
 | **last**:*number*    | negative revision number           |
42
 
 +----------------------+------------------------------------+
43
 
 | *guid*               | globally unique revision id        |
44
 
 +----------------------+------------------------------------+
45
 
 | **revid**:*guid*     | globally unique revision id        |
46
 
 +----------------------+------------------------------------+
47
 
 | **before**:*rev*     | leftmost parent of ''rev''         |
48
 
 +----------------------+------------------------------------+
49
 
 | *date-value*         | first entry after a given date     |
50
 
 +----------------------+------------------------------------+
51
 
 | **date**:*date-value*| first entry after a given date     |
52
 
 +----------------------+------------------------------------+
53
 
 | *tag-name*           | revision matching a given tag      |
54
 
 +----------------------+------------------------------------+
55
 
 | **tag**:*tag-name*   | revision matching a given tag      |
56
 
 +----------------------+------------------------------------+
57
 
 | **ancestor**:*path*  | last merged revision from a branch |
58
 
 +----------------------+------------------------------------+
59
 
 | **branch**:*path*    | latest revision on another branch  |
60
 
 +----------------------+------------------------------------+
61
 
 | **submit**:*path*    | common ancestor with submit branch |
62
 
 +----------------------+------------------------------------+
63
 
 
64
 
A brief introduction to some of these formats is given below.
65
 
For complete details, see `Revision Identifiers`_ in the
66
 
Bazaar User Reference.
67
 
 
68
 
.. _Revision Identifiers: ../user-reference/bzr_man.html#revision-identifiers
69
 
 
70
 
Numbers
71
 
~~~~~~~
72
 
 
73
 
Positive numbers denote revision numbers in the current branch. Revision
74
 
numbers are labelled as "revno" in the output of ``bzr log``.  To display
75
 
the log for the first ten revisions::
76
 
 
77
 
    $ bzr log -r ..10
78
 
 
79
 
Negative numbers count from the latest revision, -1 is the last committed
80
 
revision.
81
 
 
82
 
To display the log for the last ten revisions::
83
 
 
84
 
    $ bzr log -r -10..
85
 
 
86
 
revid
87
 
~~~~~
88
 
 
89
 
**revid** allows specifying a an internal revision ID, as shown by ``bzr
90
 
log --show-ids`` and some other commands.
91
 
 
92
 
For example::
93
 
 
94
 
    $ bzr log -r revid:Matthieu.Moy@imag.fr-20051026185030-93c7cad63ee570df
95
 
 
96
 
before
97
 
~~~~~~
98
 
 
99
 
**before**
100
 
    ''rev'' specifies the leftmost parent of ''rev'', that is the revision
101
 
    that appears before ''rev'' in the revision history, or the revision that
102
 
    was current when ''rev'' was committed.
103
 
 
104
 
''rev'' can be any revision specifier and may be chained.
105
 
 
106
 
For example::
107
 
 
108
 
    $ bzr log -r before:before:4
109
 
    ...
110
 
    revno: 2
111
 
    ...
112
 
 
113
 
date
114
 
~~~~
115
 
 
116
 
**date**
117
 
    ''value'' matches the first history entry after a given date, either at
118
 
    midnight or at a specified time.
119
 
 
120
 
Legal values are:
121
 
 
122
 
 * **yesterday**
123
 
 * **today**
124
 
 * **tomorrow**
125
 
 * A **YYYY-MM-DD** format date.
126
 
 * A **YYYY-MM-DD,HH:MM:SS** format date/time, seconds are optional (note the
127
 
   comma)
128
 
 
129
 
The proper way of saying "give me all the log entries for today" is::
130
 
 
131
 
    $ bzr log -r date:yesterday..date:today
132
 
 
133
 
Ancestor
134
 
~~~~~~~~
135
 
 
136
 
**ancestor**:*path*
137
 
    specifies the common ancestor between the current branch and a
138
 
    different branch. This is the same ancestor that would be used for
139
 
    merging purposes.
140
 
 
141
 
*path* may be the URL of a remote branch, or the file path to a local branch.
142
 
 
143
 
For example, to see what changes were made on a branch since it was forked
144
 
off ``../parent``::
145
 
 
146
 
    $ bzr diff -r ancestor:../parent
147
 
 
148
 
Branch
149
 
~~~~~~
150
 
 
151
 
branch
152
 
   ``path`` specifies the latest revision in another branch.
153
 
 
154
 
``path`` may be the URL of a remote branch, or the file path to a local branch.
155
 
 
156
 
For example, to get the differences between this and another branch::
157
 
 
158
 
    $ bzr diff -r branch:http://example.com/bzr/foo.dev
159