← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Ian Clatworthy
  • Date: 2009-12-03 20:56:18 UTC
  • mfrom: (4840.1.1 pull-clarify)
  • mto: This revision was merged to the branch mainline in revision 4859.
  • Revision ID: ian.clatworthy@canonical.com-20091203205618-e0209g60uedfphei
Clarify pull help

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/builtins.py
913
913
class cmd_pull(Command):
914
914
    """Turn this branch into a mirror of another branch.
915
915
 
916
 
    This command only works on branches that have not diverged.  Branches are
917
 
    considered diverged if the destination branch's most recent commit is one
918
 
    that has not been merged (directly or indirectly) into the parent.
 
916
    By default, this command only works on branches that have not diverged.
 
917
    Branches are considered diverged if the destination branch's most recent 
 
918
    commit is one that has not been merged (directly or indirectly) into the 
 
919
    parent.
919
920
 
920
921
    If branches have diverged, you can use 'bzr merge' to integrate the changes
921
922
    from one into the other.  Once one branch has merged, the other should
922
923
    be able to pull it again.
923
924
 
924
 
    If you want to forget your local changes and just update your branch to
925
 
    match the remote one, use pull --overwrite.
 
925
    If you want to replace your local changes and just want your branch to
 
926
    match the remote one, use pull --overwrite. This will work even if the two
 
927
    branches have diverged.
926
928
 
927
929
    If there is no default location set, the first pull will set it.  After
928
930
    that, you can omit the location to use the default.  To change the