/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Ian Clatworthy
  • Date: 2007-11-14 03:50:56 UTC
  • mto: (3054.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 3055.
  • Revision ID: ian.clatworthy@internode.on.net-20071114035056-72l6odzpby4bcmub
First cut at new look User Guide including chapters 1 and 2

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
 
=============================
 
1
Specifying revisions
 
2
====================
4
3
 
5
4
Description of the subarguments for ``-r`` as used by commands such as
6
5
``bzr log`` and ``bzr merge``.
8
7
You can get the online documentation with ``bzr help revisionspec``.
9
8
 
10
9
Revision specs and ranges
11
 
=========================
 
10
-------------------------
12
11
 
13
12
``bzr`` has a very expressive way to specify a revision, or a range of revisions.
14
13
We'll take the example of the ``log`` command.
30
29
    $ bzr cat -r 42 foo.c
31
30
 
32
31
Available revision specs
33
 
========================
 
32
------------------------
34
33
 
35
34
The revision, or the bounds of the range, can be one of
36
35
 
55
54
 +----------------------+------------------------------------+
56
55
 
57
56
Numbers
58
 
-------
 
57
~~~~~~~
59
58
 
60
59
Positive numbers denote revision numbers in the current branch. Revision
61
60
numbers are labelled as "revno" in the output of ``bzr log``.  To display
71
70
    $ bzr log -r -10..
72
71
 
73
72
revno, last
74
 
-----------
 
73
~~~~~~~~~~~
75
74
 
76
75
**revno**:*number*
77
76
    The same as *number*, except that negative numbers are not allowed.
80
79
    The same as -''number''. **last:1** means the last commited revision.
81
80
 
82
81
revid
83
 
-----
 
82
~~~~~
84
83
 
85
84
**revid** allows specifying a an internal revision ID, as shown by ``bzr
86
85
log`` and some other commands.
91
90
 
92
91
 
93
92
before
94
 
------
 
93
~~~~~~
95
94
 
96
95
**before**
97
96
    ''rev'' specifies the leftmost parent of ''rev'', that is the revision
108
107
    ...
109
108
 
110
109
date
111
 
----
 
110
~~~~
112
111
 
113
112
**date**
114
113
    ''value'' matches the first history entry after a given date, either at
128
127
    $ bzr log -r date:yesterday..date:today
129
128
 
130
129
Ancestor
131
 
--------
 
130
~~~~~~~~
132
131
 
133
132
**ancestor**:*path*
134
133
    specifies the common ancestor between the current branch and a 
143
142
    $ bzr diff -r ancestor:../parent
144
143
 
145
144
Branch
146
 
------
 
145
~~~~~~
147
146
 
148
147
branch
149
148
   ``path`` specifies the latest revision in another branch.