~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

• browse files at revision 5398
• compare with another revision
• download diff
• download tarball
• view history from revision 5398

• reverse the comparison (5398 to 1185.11.1)
• stop comparing with revision 1185.11.1

Show diffs side-by-side

added

removed

doc/en/user-guide/reviewing_changes.txt

 

1

Reviewing changes

 

2

=================

 

3

 

 

4

Looking before you leap

 

5

-----------------------

 

6

 

 

7

Once you have completed some work, it's a good idea to review your changes

 

8

prior to permanently recording it. This way, you can make sure you'll be

 

9

committing what you intend to.

 

10

 

 

11

Two bzr commands are particularly useful here: **status** and **diff**.

 

12

 

 

13

bzr status

 

14

----------

 

15

 

 

16

The **status** command tells you what changes have been made to the

 

17

working directory since the last revision::

 

18

 

 

19

    % bzr status

 

20

    modified:

 

21

       foo

 

22

 

 

23

``bzr status`` hides "boring" files that are either unchanged or ignored.

 

24

The status command can optionally be given the name of some files or

 

25

directories to check.

 

26

 

 

27

bzr diff

 

28

--------

 

29

 

 

30

The **diff** command shows the full text of changes to all files as a

 

31

standard unified diff.  This can be piped through many programs such as

 

32

''patch'', ''diffstat'', ''filterdiff'' and ''colordiff''::

 

33

 

 

34

    % bzr diff

 

35

    === added file 'hello.txt'

 

36

    --- hello.txt   1970-01-01 00:00:00 +0000

 

37

    +++ hello.txt   2005-10-18 14:23:29 +0000

 

38

    @@ -0,0 +1,1 @@

 

39

    +hello world

 

40

 

 

41

 

 

42

With the ``-r`` option, the tree is compared to an earlier revision, or

 

43

the differences between two versions are shown::

 

44

 

 

45

    % bzr diff -r 1000..          # everything since r1000

 

46

    % bzr diff -r 1000..1100      # changes from 1000 to 1100

 

47

 

 

48

To see the changes introduced by a single revision, you can use the ``-c``

 

49

option to diff.

 

50

 

 

51

::

 

52

 

 

53

    % bzr diff -c 1000            # changes from r1000

 

54

                                  # identical to -r999..1000

 

55

 

 

56

The ``--diff-options`` option causes bzr to run the external diff program,

 

57

passing options.  For example::

 

58

 

 

59

    % bzr diff --diff-options --side-by-side foo

 

60

 

 

61

Some projects prefer patches to show a prefix at the start of the path

 

62

for old and new files.  The ``--prefix`` option can be used to provide

 

63

such a prefix.

 

64

As a shortcut, ``bzr diff -p1`` produces a form that works with the

 

65

command ``patch -p1``.

 

66

 

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1