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

  • Committer: Robert Collins
  • Date: 2010-05-05 00:05:29 UTC
  • mto: This revision was merged to the branch mainline in revision 5206.
  • Revision ID: robertc@robertcollins.net-20100505000529-ltmllyms5watqj5u
Make 'pydoc bzrlib.tests.build_tree_shape' useful.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/reviewing_changes.txt
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 brz commands are particularly useful here: **status** and **diff**.
 
11
Two bzr commands are particularly useful here: **status** and **diff**.
12
12
 
13
 
brz status
 
13
bzr 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
 
    % brz status
 
19
    % bzr status
20
20
    modified:
21
21
       foo
22
22
 
23
 
``brz status`` hides "boring" files that are either unchanged or ignored.
 
23
``bzr 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
 
brz diff
 
27
bzr 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
 
    % brz diff
 
34
    % bzr 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
 
    % brz diff -r 1000..          # everything since r1000
46
 
    % brz diff -r 1000..1100      # changes from 1000 to 1100
 
45
    % bzr diff -r 1000..          # everything since r1000
 
46
    % bzr 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
 
    % brz diff -c 1000            # changes from r1000
 
53
    % bzr diff -c 1000            # changes from r1000
54
54
                                  # identical to -r999..1000
55
55
 
56
 
The ``--diff-options`` option causes brz to run the external diff program,
 
56
The ``--diff-options`` option causes bzr to run the external diff program,
57
57
passing options.  For example::
58
58
 
59
 
    % brz diff --diff-options --side-by-side foo
 
59
    % bzr 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, ``brz diff -p1`` produces a form that works with the
 
64
As a shortcut, ``bzr diff -p1`` produces a form that works with the
65
65
command ``patch -p1``.
66
66