/breezy/unstable

To get this branch, use:
bzr branch https://code.breezy-vcs.org/breezy/unstable

« back to all changes in this revision

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

  • Committer: Jelmer Vernooij
  • Date: 2017-05-24 01:39:33 UTC
  • mfrom: (3815.3776.6)
  • Revision ID: jelmer@jelmer.uk-20170524013933-ir4y4tqtrsiz2ka2
New upstream snapshot.

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
Revision identifiers and ranges
5
5
-------------------------------
6
6
 
7
 
Bazaar has a very expressive way to specify a revision or a range of revisions.
 
7
Breezy has a very expressive way to specify a revision or a range of revisions.
8
8
To specify a range of revisions, the upper and lower bounds are separated by the
9
9
``..`` symbol. For example::
10
10
 
11
 
    $ bzr log -r 1..4
 
11
    $ brz log -r 1..4
12
12
 
13
13
You can omit one bound like::
14
14
 
15
 
    $ bzr log -r 1..
16
 
    $ bzr log -r ..4
 
15
    $ brz log -r 1..
 
16
    $ brz log -r ..4
17
17
 
18
18
Some commands take only one revision, not a range. For example::
19
19
 
20
 
    $ bzr cat -r 42 foo.c
 
20
    $ brz cat -r 42 foo.c
21
21
 
22
22
In other cases, a range is required but you want the length of the range to
23
23
be one. For commands where this is relevant, the ``-c`` option is used like this::
24
24
 
25
 
    $ bzr diff -c 42
 
25
    $ brz diff -c 42
26
26
 
27
27
 
28
28
Available revision identifiers
63
63
 
64
64
A brief introduction to some of these formats is given below.
65
65
For complete details, see `Revision Identifiers`_ in the
66
 
Bazaar User Reference.
 
66
Breezy User Reference.
67
67
 
68
68
.. _Revision Identifiers: ../user-reference/index.html#revision-identifiers
69
69
 
71
71
~~~~~~~
72
72
 
73
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
 
74
numbers are labelled as "revno" in the output of ``brz log``.  To display
75
75
the log for the first ten revisions::
76
76
 
77
 
    $ bzr log -r ..10
 
77
    $ brz log -r ..10
78
78
 
79
79
Negative numbers count from the latest revision, -1 is the last committed
80
80
revision.
81
81
 
82
82
To display the log for the last ten revisions::
83
83
 
84
 
    $ bzr log -r -10..
 
84
    $ brz log -r -10..
85
85
 
86
86
revid
87
87
~~~~~
88
88
 
89
 
**revid** allows specifying an internal revision ID, as shown by ``bzr
 
89
**revid** allows specifying an internal revision ID, as shown by ``brz
90
90
log --show-ids`` and some other commands.
91
91
 
92
92
For example::
93
93
 
94
 
    $ bzr log -r revid:Matthieu.Moy@imag.fr-20051026185030-93c7cad63ee570df
 
94
    $ brz log -r revid:Matthieu.Moy@imag.fr-20051026185030-93c7cad63ee570df
95
95
 
96
96
before
97
97
~~~~~~
105
105
 
106
106
For example::
107
107
 
108
 
    $ bzr log -r before:before:4
 
108
    $ brz log -r before:before:4
109
109
    ...
110
110
    revno: 2
111
111
    ...
128
128
 
129
129
The proper way of saying "give me all the log entries for today" is::
130
130
 
131
 
    $ bzr log -r date:yesterday..date:today
 
131
    $ brz log -r date:yesterday..date:today
132
132
 
133
133
Ancestor
134
134
~~~~~~~~
143
143
For example, to see what changes were made on a branch since it was forked
144
144
off ``../parent``::
145
145
 
146
 
    $ bzr diff -r ancestor:../parent
 
146
    $ brz diff -r ancestor:../parent
147
147
 
148
148
Branch
149
149
~~~~~~
155
155
 
156
156
For example, to get the differences between this and another branch::
157
157
 
158
 
    $ bzr diff -r branch:http://example.com/bzr/foo.dev
 
158
    $ brz diff -r branch:http://example.com/brz/foo.dev
159
159