← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/specifying_revisions.txt

  • Committer: John Arbash Meinel
  • Date: 2006-10-06 07:13:51 UTC
  • mto: This revision was merged to the branch mainline in revision 2071.
  • Revision ID: john@arbash-meinel.com-20061006071351-e3fdd47eed1c3e7e
lazy import revisionspec and errors for bzrlib.options

Show diffs side-by-side

added added

removed removed

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