/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/browsing_history.txt

  • Committer: Jelmer Vernooij
  • Date: 2017-05-21 19:09:26 UTC
  • mfrom: (6622.1.36 breezy)
  • Revision ID: jelmer@jelmer.uk-20170521190926-5vtz8xaf0e9ylrpc
Merge rename to breezy.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/browsing_history.txt
1
1
Browsing history
2
2
================
3
3
 
4
 
bzr log
 
4
brz log
5
5
-------
6
6
 
7
 
The ``bzr log`` command shows a list of previous revisions.
8
 
 
9
 
As with ``bzr diff``, ``bzr log`` supports the ``-r`` argument::
10
 
 
11
 
    % bzr log -r 1000..          # Revision 1000 and everything after it
12
 
    % bzr log -r ..1000          # Everything up to and including r1000
13
 
    % bzr log -r 1000..1100      # changes from 1000 to 1100
14
 
    % bzr log -r 1000            # The changes in only revision 1000
 
7
The ``brz log`` command shows a list of previous revisions.
 
8
 
 
9
As with ``brz diff``, ``brz log`` supports the ``-r`` argument::
 
10
 
 
11
    % brz log -r 1000..          # Revision 1000 and everything after it
 
12
    % brz log -r ..1000          # Everything up to and including r1000
 
13
    % brz log -r 1000..1100      # changes from 1000 to 1100
 
14
    % brz log -r 1000            # The changes in only revision 1000
15
15
 
16
16
Viewing merged revisions
17
17
------------------------
18
18
 
19
 
As distributed VCS tools like Bazaar make merging much easier than
 
19
As distributed VCS tools like Breezy make merging much easier than
20
20
it is in central VCS tools, the history of a branch may often contain
21
21
lines of development splitting off the mainline and merging back
22
22
in at a later time. Technically, the relationship between the
28
28
the mainline and indicate which revisions have nested merged revisions.
29
29
To explore the merged revisions for revision X, use the following command::
30
30
 
31
 
  bzr log -n0 -rX
 
31
  brz log -n0 -rX
32
32
 
33
33
To see all revisions and all their merged revisions::
34
34
 
35
 
  bzr log -n0
 
35
  brz log -n0
36
36
 
37
37
Note that the -n option is used to indicate the number of levels to display
38
38
where 0 means all. If that is too noisy, you can easily adjust the number
39
39
to only view down so far. For example, if your project is structured with
40
 
a top level gatekeeper merging changes from team gatekeepers, ``bzr log``
41
 
shows what the top level gatekeeper did while ``bzr log -n2`` shows what
 
40
a top level gatekeeper merging changes from team gatekeepers, ``brz log``
 
41
shows what the top level gatekeeper did while ``brz log -n2`` shows what
42
42
the team gatekeepers did. In the vast majority of cases though, ``-n0``
43
43
is fine.
44
44
 
63
63
applies to a given file. To do this, provide the filename
64
64
to the ``log`` command like this::
65
65
 
66
 
  bzr log foo.py
 
66
  brz log foo.py
67
67
 
68
68
Viewing an old version of a file
69
69
--------------------------------
71
71
To get the contents of a file at a given version, use the
72
72
``cat`` command like this::
73
73
 
74
 
  bzr cat -r X file
 
74
  brz cat -r X file
75
75
 
76
76
where ``X`` is the revision identifier and ``file`` is
77
77
the filename. This will send output to the standard output
79
79
a viewing tool (like ``less`` or ``more``) or redirect it
80
80
like this::
81
81
 
82
 
  bzr cat -r -2 foo.py | less
83
 
  bzr cat -r 1 foo.py > /tmp/foo-1st-version.py
 
82
  brz cat -r -2 foo.py | less
 
83
  brz cat -r 1 foo.py > /tmp/foo-1st-version.py
84
84
 
85
85
Graphical history viewers
86
86
-------------------------
87
87
 
88
88
History browsing is one area where GUI tools really make life easier.
89
 
Bazaar has numerous plug-ins that provide this capability including
90
 
QBzr and bzr-gtk. See `Using plugins <plugins.html>`_ for details on how to install
 
89
Breezy has numerous plug-ins that provide this capability including
 
90
QBzr and brz-gtk. See `Using plugins <plugins.html>`_ for details on how to install
91
91
these if they are not already installed.
92
92
 
93
93
To use the graphical viewer from QBzr::
94
94
 
95
 
  bzr qlog
96
 
 
97
 
To use the graphical viewer from bzr-gtk::
98
 
 
99
 
  bzr viz
 
95
  brz qlog
 
96
 
 
97
To use the graphical viewer from brz-gtk::
 
98
 
 
99
  brz viz
100
100
 
101
101
``viz`` is actually a built-in alias for ``visualize`` so use the longer
102
102
command name if you prefer.