/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 bzrlib/builtins.py

  • Committer: Ian Clatworthy
  • Date: 2008-03-28 07:24:55 UTC
  • mfrom: (3277.1.4 bzr.scode)
  • mto: This revision was merged to the branch mainline in revision 3314.
  • Revision ID: ian.clatworthy@canonical.com-20080328072455-0xlxool8cm4ibem8
Improve doc on send/merge relationship (Peter Schuller)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/builtins.py
589
589
    that, you can omit the location to use the default.  To change the
590
590
    default, use --remember. The value will only be saved if the remote
591
591
    location can be accessed.
 
592
 
 
593
    Note: The location can be specified either in the form of a branch,
 
594
    or in the form of a path to a file containing a merge directive generated
 
595
    with bzr send.
592
596
    """
593
597
 
594
598
    _see_also = ['push', 'update', 'status-flags']
2763
2767
class cmd_merge(Command):
2764
2768
    """Perform a three-way merge.
2765
2769
    
2766
 
    The branch is the branch you will merge from.  By default, it will merge
2767
 
    the latest revision.  If you specify a revision, that revision will be
2768
 
    merged.  If you specify two revisions, the first will be used as a BASE,
2769
 
    and the second one as OTHER.  Revision numbers are always relative to the
2770
 
    specified branch.
 
2770
    The source of the merge can be specified either in the form of a branch,
 
2771
    or in the form of a path to a file containing a merge directive generated
 
2772
    with bzr send. If neither is specified, the default is the upstream branch
 
2773
    or the branch most recently merged using --remember.
 
2774
 
 
2775
    When merging a branch, by default the tip will be merged. To pick a different
 
2776
    revision, pass --revision. If you specify two values, the first will be used as
 
2777
    BASE and the second one as OTHER. Merging individual revisions, or a subset of
 
2778
    available revisions, like this is commonly referred to as "cherrypicking".
 
2779
 
 
2780
    Revision numbers are always relative to the branch being merged.
2771
2781
 
2772
2782
    By default, bzr will try to merge in all new work from the other
2773
2783
    branch, automatically determining an appropriate base.  If this
2804
2814
        To merge the changes introduced by 82, without previous changes::
2805
2815
 
2806
2816
            bzr merge -r 81..82 ../bzr.dev
 
2817
 
 
2818
        To apply a merge directive contained in in /tmp/merge:
 
2819
 
 
2820
            bzr merge /tmp/merge
2807
2821
    """
2808
2822
 
2809
2823
    encoding_type = 'exact'
2810
2824
    _see_also = ['update', 'remerge', 'status-flags']
2811
 
    takes_args = ['branch?']
 
2825
    takes_args = ['location?']
2812
2826
    takes_options = [
2813
2827
        'change',
2814
2828
        'revision',
2834
2848
        Option('preview', help='Instead of merging, show a diff of the merge.')
2835
2849
    ]
2836
2850
 
2837
 
    def run(self, branch=None, revision=None, force=False, merge_type=None,
2838
 
            show_base=False, reprocess=False, remember=False,
 
2851
    def run(self, location=None, revision=None, force=False,
 
2852
            merge_type=None, show_base=False, reprocess=False, remember=False,
2839
2853
            uncommitted=False, pull=False,
2840
2854
            directory=None,
2841
2855
            preview=False,
2842
2856
            ):
2843
 
        # This is actually a branch (or merge-directive) *location*.
2844
 
        location = branch
2845
 
        del branch
2846
 
 
2847
2857
        if merge_type is None:
2848
2858
            merge_type = _mod_merge.Merge3Merger
2849
2859
 
4078
4088
    older formats.  It is compatible with Bazaar 0.19 and later.  It is the
4079
4089
    default.  "0.9" uses revision bundle format 0.9 and merge directive
4080
4090
    format 1.  It is compatible with Bazaar 0.12 - 0.18.
 
4091
    
 
4092
    Merge directives are applied using the merge command or the pull command.
4081
4093
    """
4082
4094
 
4083
4095
    encoding_type = 'exact'
4084
4096
 
4085
 
    _see_also = ['merge']
 
4097
    _see_also = ['merge', 'pull']
4086
4098
 
4087
4099
    takes_args = ['submit_branch?', 'public_branch?']
4088
4100