~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/conflicts.py

Updated docs to clarify conflict handling

Show diffs side-by-side

added added

removed removed

Lines of Context:
26
26
import errno
27
27
 
28
28
import bzrlib.status
 
29
from bzrlib.commands import register_command
29
30
from bzrlib.errors import BzrCommandError, NotConflicted
30
 
from bzrlib.commands import register_command
 
31
from bzrlib.option import Option
31
32
from bzrlib.workingtree import CONFLICT_SUFFIXES, WorkingTree
32
33
from bzrlib.osutils import rename
33
34
 
34
35
class cmd_conflicts(bzrlib.commands.Command):
35
36
    """List files with conflicts.
 
37
 
 
38
    Merge will do its best to combine the changes in two branches, but there
 
39
    are some kinds of problems only a human can fix.  When it encounters those,
 
40
    it will mark a conflict.  A conflict means that you need to fix something,
 
41
    before you should commit.
 
42
 
 
43
    Use bzr resolve when you have fixed a problem.
 
44
 
36
45
    (conflicts are determined by the presence of .BASE .TREE, and .OTHER 
37
46
    files.)
 
47
 
 
48
    See also bzr resolve.
38
49
    """
39
50
    def run(self):
40
51
        for path in WorkingTree.open_containing(u'.')[0].iter_conflicts():
42
53
 
43
54
class cmd_resolve(bzrlib.commands.Command):
44
55
    """Mark a conflict as resolved.
 
56
 
 
57
    Merge will do its best to combine the changes in two branches, but there
 
58
    are some kinds of problems only a human can fix.  When it encounters those,
 
59
    it will mark a conflict.  A conflict means that you need to fix something,
 
60
    before you should commit.
 
61
 
 
62
    Once you have fixed a problem, use "bzr resolve FILE.." to mark
 
63
    individual files as fixed, or "bzr resolve --all" to mark all conflicts as
 
64
    resolved.
 
65
 
 
66
    See also bzr conflicts.
45
67
    """
46
68
    aliases = ['resolved']
47
69
    takes_args = ['file*']
48
 
    takes_options = ['all']
 
70
    takes_options = [Option('all', help='Resolve all conflicts in this tree')]
49
71
    def run(self, file_list=None, all=False):
50
72
        if file_list is None:
51
73
            if not all: