← 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: Ian Clatworthy
  • Date: 2007-11-30 04:51:51 UTC
  • mfrom: (2977.1.21 bzr.user-guide)
  • mto: This revision was merged to the branch mainline in revision 3055.
  • Revision ID: ian.clatworthy@internode.on.net-20071130045151-w5aa98ufajkztqny
Bazaar User Guide for 1.0rc (Ian Clatworthy)

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``.
 
1
Revision specifiers
 
2
===================
9
3
 
10
4
Revision specs and ranges
11
 
=========================
 
5
-------------------------
12
6
 
13
7
``bzr`` has a very expressive way to specify a revision, or a range of revisions.
14
8
We'll take the example of the ``log`` command.
30
24
    $ bzr cat -r 42 foo.c
31
25
 
32
26
Available revision specs
33
 
========================
 
27
------------------------
34
28
 
35
29
The revision, or the bounds of the range, can be one of
36
30
 
55
49
 +----------------------+------------------------------------+
56
50
 
57
51
Numbers
58
 
-------
 
52
~~~~~~~
59
53
 
60
54
Positive numbers denote revision numbers in the current branch. Revision
61
55
numbers are labelled as "revno" in the output of ``bzr log``.  To display
71
65
    $ bzr log -r -10..
72
66
 
73
67
revno, last
74
 
-----------
 
68
~~~~~~~~~~~
75
69
 
76
70
**revno**:*number*
77
71
    The same as *number*, except that negative numbers are not allowed.
80
74
    The same as -''number''. **last:1** means the last commited revision.
81
75
 
82
76
revid
83
 
-----
 
77
~~~~~
84
78
 
85
79
**revid** allows specifying a an internal revision ID, as shown by ``bzr
86
80
log`` and some other commands.
91
85
 
92
86
 
93
87
before
94
 
------
 
88
~~~~~~
95
89
 
96
90
**before**
97
91
    ''rev'' specifies the leftmost parent of ''rev'', that is the revision
108
102
    ...
109
103
 
110
104
date
111
 
----
 
105
~~~~
112
106
 
113
107
**date**
114
108
    ''value'' matches the first history entry after a given date, either at
128
122
    $ bzr log -r date:yesterday..date:today
129
123
 
130
124
Ancestor
131
 
--------
 
125
~~~~~~~~
132
126
 
133
127
**ancestor**:*path*
134
128
    specifies the common ancestor between the current branch and a 
143
137
    $ bzr diff -r ancestor:../parent
144
138
 
145
139
Branch
146
 
------
 
140
~~~~~~
147
141
 
148
142
branch
149
143
   ``path`` specifies the latest revision in another branch.