/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/reviewing_changes.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:
8
8
prior to permanently recording it. This way, you can make sure you'll be
9
9
committing what you intend to.
10
10
 
11
 
Two bzr commands are particularly useful here: **status** and **diff**.
 
11
Two brz commands are particularly useful here: **status** and **diff**.
12
12
 
13
 
bzr status
 
13
brz status
14
14
----------
15
15
 
16
16
The **status** command tells you what changes have been made to the
17
17
working directory since the last revision::
18
18
 
19
 
    % bzr status
 
19
    % brz status
20
20
    modified:
21
21
       foo
22
22
 
23
 
``bzr status`` hides "boring" files that are either unchanged or ignored.
 
23
``brz status`` hides "boring" files that are either unchanged or ignored.
24
24
The status command can optionally be given the name of some files or
25
25
directories to check.
26
26
 
27
 
bzr diff
 
27
brz diff
28
28
--------
29
29
 
30
30
The **diff** command shows the full text of changes to all files as a
31
31
standard unified diff.  This can be piped through many programs such as
32
32
''patch'', ''diffstat'', ''filterdiff'' and ''colordiff''::
33
33
 
34
 
    % bzr diff
 
34
    % brz diff
35
35
    === added file 'hello.txt'
36
36
    --- hello.txt   1970-01-01 00:00:00 +0000
37
37
    +++ hello.txt   2005-10-18 14:23:29 +0000
42
42
With the ``-r`` option, the tree is compared to an earlier revision, or
43
43
the differences between two versions are shown::
44
44
 
45
 
    % bzr diff -r 1000..          # everything since r1000
46
 
    % bzr diff -r 1000..1100      # changes from 1000 to 1100
 
45
    % brz diff -r 1000..          # everything since r1000
 
46
    % brz diff -r 1000..1100      # changes from 1000 to 1100
47
47
 
48
48
To see the changes introduced by a single revision, you can use the ``-c``
49
49
option to diff.
50
50
 
51
51
::
52
52
 
53
 
    % bzr diff -c 1000            # changes from r1000
 
53
    % brz diff -c 1000            # changes from r1000
54
54
                                  # identical to -r999..1000
55
55
 
56
 
The ``--diff-options`` option causes bzr to run the external diff program,
 
56
The ``--diff-options`` option causes brz to run the external diff program,
57
57
passing options.  For example::
58
58
 
59
 
    % bzr diff --diff-options --side-by-side foo
 
59
    % brz diff --diff-options --side-by-side foo
60
60
 
61
61
Some projects prefer patches to show a prefix at the start of the path
62
62
for old and new files.  The ``--prefix`` option can be used to provide
63
63
such a prefix.
64
 
As a shortcut, ``bzr diff -p1`` produces a form that works with the
 
64
As a shortcut, ``brz diff -p1`` produces a form that works with the
65
65
command ``patch -p1``.
66
66