← 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: Canonical.com Patch Queue Manager
  • Date: 2010-10-12 10:43:30 UTC
  • mfrom: (5487.1.1 trunk)
  • Revision ID: pqm@pqm.ubuntu.com-20101012104330-tsonnndvloj18v4q
(vila) Add a --no-tree option for init and push (Matthew Gordon)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/specifying_revisions.txt
1
 
=============================
2
 
Specifying revision in Bazaar
3
 
=============================
4
 
 
5
 
Description of the subarguments for ``-r`` as used by commands such as
6
 
``bzr log`` and ``bzr merge``.
7
 
 
8
 
You can get the online documentation with ``bzr help revisionspec``.
9
 
 
10
 
Revision specs and ranges
11
 
=========================
12
 
 
13
 
``bzr`` has a very expressive way to specify a revision, or a range of revisions.
14
 
We'll take the example of the ``log`` command.
15
 
 
16
 
To specify a range of revisions, use for example::
 
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::
17
10
 
18
11
    $ bzr log -r 1..4
19
12
 
22
15
    $ bzr log -r 1..
23
16
    $ bzr log -r ..4
24
17
 
25
 
Note:
26
 
    Omitting the lower bound doesn't work on versions of ``bzr`` prior to 0.14.
27
 
 
28
 
Other commands, like ``bzr cat`` take only one revision, not a range, like::
 
18
Some commands take only one revision, not a range. For example::
29
19
 
30
20
    $ bzr cat -r 42 foo.c
31
21
 
32
 
Available revision specs
33
 
========================
34
 
 
35
 
The revision, or the bounds of the range, can be one of
 
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.
36
33
 
37
34
 +----------------------+------------------------------------+
38
35
 |  argument type       | description                        |
39
36
 +----------------------+------------------------------------+
40
37
 | *number*             | revision number                    |
41
38
 +----------------------+------------------------------------+
42
 
 | **revno**:*number*   | positive revision number           |
 
39
 | **revno**:*number*   | revision number                    |
43
40
 +----------------------+------------------------------------+
44
41
 | **last**:*number*    | negative revision number           |
45
42
 +----------------------+------------------------------------+
 
43
 | *guid*               | globally unique revision id        |
 
44
 +----------------------+------------------------------------+
46
45
 | **revid**:*guid*     | globally unique revision id        |
47
46
 +----------------------+------------------------------------+
48
47
 | **before**:*rev*     | leftmost parent of ''rev''         |
49
48
 +----------------------+------------------------------------+
50
 
 | **date**:*value*     | first entry after a given date     |
 
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      |
51
56
 +----------------------+------------------------------------+
52
57
 | **ancestor**:*path*  | last merged revision from a branch |
53
58
 +----------------------+------------------------------------+
54
59
 | **branch**:*path*    | latest revision on another branch  |
55
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/index.html#revision-identifiers
56
69
 
57
70
Numbers
58
 
-------
 
71
~~~~~~~
59
72
 
60
73
Positive numbers denote revision numbers in the current branch. Revision
61
74
numbers are labelled as "revno" in the output of ``bzr log``.  To display
70
83
 
71
84
    $ bzr log -r -10..
72
85
 
73
 
revno, last
74
 
-----------
75
 
 
76
 
**revno**:*number*
77
 
    The same as *number*, except that negative numbers are not allowed.
78
 
 
79
 
**last**:*number*
80
 
    The same as -''number''. **last:1** means the last commited revision.
81
 
 
82
86
revid
83
 
-----
 
87
~~~~~
84
88
 
85
89
**revid** allows specifying a an internal revision ID, as shown by ``bzr
86
 
log`` and some other commands.
 
90
log --show-ids`` and some other commands.
87
91
 
88
92
For example::
89
93
 
90
94
    $ bzr log -r revid:Matthieu.Moy@imag.fr-20051026185030-93c7cad63ee570df
91
95
 
92
 
 
93
96
before
94
 
------
 
97
~~~~~~
95
98
 
96
99
**before**
97
100
    ''rev'' specifies the leftmost parent of ''rev'', that is the revision
98
101
    that appears before ''rev'' in the revision history, or the revision that
99
 
    was current when ''rev'' what comitted.
 
102
    was current when ''rev'' was committed.
100
103
 
101
104
''rev'' can be any revision specifier and may be chained.
102
105
 
108
111
    ...
109
112
 
110
113
date
111
 
----
 
114
~~~~
112
115
 
113
116
**date**
114
117
    ''value'' matches the first history entry after a given date, either at
128
131
    $ bzr log -r date:yesterday..date:today
129
132
 
130
133
Ancestor
131
 
--------
 
134
~~~~~~~~
132
135
 
133
136
**ancestor**:*path*
134
 
    specifies the common ancestor between the current branch and a 
 
137
    specifies the common ancestor between the current branch and a
135
138
    different branch. This is the same ancestor that would be used for
136
139
    merging purposes.
137
140
 
143
146
    $ bzr diff -r ancestor:../parent
144
147
 
145
148
Branch
146
 
------
 
149
~~~~~~
147
150
 
148
151
branch
149
152
   ``path`` specifies the latest revision in another branch.