← 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: John Arbash Meinel
  • Date: 2007-12-10 16:46:00 UTC
  • mto: (3112.1.1 bzr_access)
  • mto: This revision was merged to the branch mainline in revision 3165.
  • Revision ID: john@arbash-meinel.com-20071210164600-xcvl9fto3gn5aqtj
Change the indentation to 4 spaces according to Bazaar style guidelines.

Show diffs side-by-side

added added

removed removed

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