← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/specifying_revisions.txt

  • Committer: Robert Collins
  • Date: 2007-03-08 04:06:06 UTC
  • mfrom: (2323.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 2442.
  • Revision ID: robertc@robertcollins.net-20070308040606-84gsniv56huiyjt4
Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/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
 
1
10
Revision specs and ranges
2
11
=========================
3
12
 
4
 
**bzr** has a very expressive way to specify a revision, or a range of revisions.
5
 
We'll take the example of the **log** command.
 
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.
6
15
 
7
16
To specify a range of revisions, use for example::
8
17
 
13
22
    $ bzr log -r 1..
14
23
    $ bzr log -r ..4
15
24
 
16
 
Note::
17
 
    Omitting the lower bound doesn't work on currently released versions.
 
25
Note:
 
26
    Omitting the lower bound doesn't work on versions of ``bzr`` prior to 0.14.
18
27
 
19
 
Other commands, like **bzr cat** take only one revision, not a range, like::
 
28
Other commands, like ``bzr cat`` take only one revision, not a range, like::
20
29
 
21
30
    $ bzr cat -r 42 foo.c
22
31
 
49
58
-------
50
59
 
51
60
Positive numbers denote revision numbers in the current branch. Revision
52
 
numbers are labelled as "revno" in the output of **bzr log**.  To display
 
61
numbers are labelled as "revno" in the output of ``bzr log``.  To display
53
62
the log for the first ten revisions::
54
63
 
55
64
    $ bzr log -r ..10
73
82
revid
74
83
-----
75
84
 
76
 
**revid** allows specifying a an internal revision ID, as show by **bzr
77
 
testament** and some other commands.
 
85
**revid** allows specifying a an internal revision ID, as shown by ``bzr
 
86
log`` and some other commands.
78
87
 
79
88
For example::
80
89
 
89
98
    that appears before ''rev'' in the revision history, or the revision that
90
99
    was current when ''rev'' what comitted.
91
100
 
92
 
''rev'' can be any revision specifier.
 
101
''rev'' can be any revision specifier and may be chained.
93
102
 
94
103
For example::
95
104
 
122
131
--------
123
132
 
124
133
**ancestor**:*path*
125
 
    specifies the common ancestor between the current branch,and a 
 
134
    specifies the common ancestor between the current branch and a 
126
135
    different branch. This is the same ancestor that would be used for
127
136
    merging purposes.
128
137
 
129
138
*path* may be the URL of a remote branch, or the file path to a local branch.
130
139
 
131
140
For example, to see what changes were made on a branch since it was forked
132
 
off **../parent**::
 
141
off ``../parent``::
133
142
 
134
143
    $ bzr diff -r ancestor:../parent
135
144
 
137
146
------
138
147
 
139
148
branch
140
 
   ''path'' specifies the latest revision in another branch.
 
149
   ``path`` specifies the latest revision in another branch.
141
150
 
142
 
''path'' may be the URL of a remote branch, or the file path to a local branch.
 
151
``path`` may be the URL of a remote branch, or the file path to a local branch.
143
152
 
144
153
For example, to get the differences between this and another branch::
145
154