← 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: 2008-08-18 22:34:21 UTC
  • mto: (3606.5.6 1.6)
  • mto: This revision was merged to the branch mainline in revision 3641.
  • Revision ID: john@arbash-meinel.com-20080818223421-todjny24vj4faj4t
Add tests for the fetching behavior.

The proper parameter passed is 'unordered' add an assert for it, and
fix callers that were passing 'unsorted' instead.
Add tests that we make the right get_record_stream call based
on the value of _fetch_uses_deltas.
Fix the fetch request for signatures.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/specifying_revisions.txt
1
 
Revision specs and ranges
2
 
=========================
3
 
 
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.
6
 
 
7
 
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::
8
10
 
9
11
    $ bzr log -r 1..4
10
12
 
13
15
    $ bzr log -r 1..
14
16
    $ bzr log -r ..4
15
17
 
16
 
Note::
17
 
    Omitting the lower bound doesn't work on currently released versions.
18
 
 
19
 
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::
20
19
 
21
20
    $ bzr cat -r 42 foo.c
22
21
 
23
 
Available revision specs
24
 
========================
25
 
 
26
 
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.
27
33
 
28
34
 +----------------------+------------------------------------+
29
35
 |  argument type       | description                        |
40
46
 +----------------------+------------------------------------+
41
47
 | **date**:*value*     | first entry after a given date     |
42
48
 +----------------------+------------------------------------+
 
49
 | **tag**:*value*      | revision matching a given tag      |
 
50
 +----------------------+------------------------------------+
43
51
 | **ancestor**:*path*  | last merged revision from a branch |
44
52
 +----------------------+------------------------------------+
45
53
 | **branch**:*path*    | latest revision on another branch  |
46
54
 +----------------------+------------------------------------+
 
55
 | **submit**:*path*    | common ancestor with submit branch |
 
56
 +----------------------+------------------------------------+
 
57
 
 
58
A brief introduction to some of these formats is given below.
 
59
For complete details, see `Revision Identifiers`_ in the
 
60
Bazaar User Reference.
 
61
 
 
62
.. _Revision Identifiers: ../user-reference/bzr_man.html#revision-identifiers
47
63
 
48
64
Numbers
49
 
-------
 
65
~~~~~~~
50
66
 
51
67
Positive numbers denote revision numbers in the current branch. Revision
52
 
numbers are labelled as "revno" in the output of **bzr log**.  To display
 
68
numbers are labelled as "revno" in the output of ``bzr log``.  To display
53
69
the log for the first ten revisions::
54
70
 
55
71
    $ bzr log -r ..10
61
77
 
62
78
    $ bzr log -r -10..
63
79
 
64
 
revno, last
65
 
-----------
66
 
 
67
 
**revno**:*number*
68
 
    The same as *number*, except that negative numbers are not allowed.
69
 
 
70
 
**last**:*number*
71
 
    The same as -''number''. **last:1** means the last commited revision.
72
 
 
73
80
revid
74
 
-----
 
81
~~~~~
75
82
 
76
 
**revid** allows specifying a an internal revision ID, as show by **bzr
77
 
testament** and some other commands.
 
83
**revid** allows specifying a an internal revision ID, as shown by ``bzr
 
84
log`` and some other commands.
78
85
 
79
86
For example::
80
87
 
81
88
    $ bzr log -r revid:Matthieu.Moy@imag.fr-20051026185030-93c7cad63ee570df
82
89
 
83
 
 
84
90
before
85
 
------
 
91
~~~~~~
86
92
 
87
93
**before**
88
94
    ''rev'' specifies the leftmost parent of ''rev'', that is the revision
89
95
    that appears before ''rev'' in the revision history, or the revision that
90
96
    was current when ''rev'' what comitted.
91
97
 
92
 
''rev'' can be any revision specifier.
 
98
''rev'' can be any revision specifier and may be chained.
93
99
 
94
100
For example::
95
101
 
99
105
    ...
100
106
 
101
107
date
102
 
----
 
108
~~~~
103
109
 
104
110
**date**
105
111
    ''value'' matches the first history entry after a given date, either at
119
125
    $ bzr log -r date:yesterday..date:today
120
126
 
121
127
Ancestor
122
 
--------
 
128
~~~~~~~~
123
129
 
124
130
**ancestor**:*path*
125
 
    specifies the common ancestor between the current branch,and a 
 
131
    specifies the common ancestor between the current branch and a 
126
132
    different branch. This is the same ancestor that would be used for
127
133
    merging purposes.
128
134
 
129
135
*path* may be the URL of a remote branch, or the file path to a local branch.
130
136
 
131
137
For example, to see what changes were made on a branch since it was forked
132
 
off **../parent**::
 
138
off ``../parent``::
133
139
 
134
140
    $ bzr diff -r ancestor:../parent
135
141
 
136
142
Branch
137
 
------
 
143
~~~~~~
138
144
 
139
145
branch
140
 
   ''path'' specifies the latest revision in another branch.
 
146
   ``path`` specifies the latest revision in another branch.
141
147
 
142
 
''path'' may be the URL of a remote branch, or the file path to a local branch.
 
148
``path`` may be the URL of a remote branch, or the file path to a local branch.
143
149
 
144
150
For example, to get the differences between this and another branch::
145
151