← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Robert Collins
  • Date: 2006-04-12 04:57:34 UTC
  • mto: This revision was merged to the branch mainline in revision 1654.
  • Revision ID: robertc@robertcollins.net-20060412045734-3e03b7af0860a5a9
 * 'pull' and 'push' now normalise the revision history, so that any two
   branches with the same tip revision will have the same output from 'log'.
   (Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/builtins.py
360
360
            
361
361
    
362
362
class cmd_pull(Command):
363
 
    """Pull any changes from another branch into the current one.
 
363
    """Turn this branch into a mirror of another branch.
364
364
 
365
365
    If there is no default location set, the first pull will set it.  After
366
366
    that, you can omit the location to use the default.  To change the
367
367
    default, use --remember.
368
368
 
369
369
    This command only works on branches that have not diverged.  Branches are
370
 
    considered diverged if both branches have had commits without first
371
 
    pulling from the other.
 
370
    considered diverged if the destination branch's most recent commit is one
 
371
    that has not been merged (directly or indirectly) into the parent.
372
372
 
373
373
    If branches have diverged, you can use 'bzr merge' to pull the text changes
374
374
    from one into the other.  Once one branch has merged, the other should
424
424
 
425
425
 
426
426
class cmd_push(Command):
427
 
    """Push this branch into another branch.
428
 
    
429
 
    The remote branch will not have its working tree populated because this
430
 
    is both expensive, and may not be supported on the remote file system.
431
 
    
432
 
    Some smart servers or protocols *may* put the working tree in place.
 
427
    """Update a mirror of this branch.
 
428
    
 
429
    The target branch will not have its working tree populated because this
 
430
    is both expensive, and is not supported on remote file systems.
 
431
    
 
432
    Some smart servers or protocols *may* put the working tree in place in
 
433
    the future.
433
434
 
434
435
    If there is no default push location set, the first push will set it.
435
436
    After that, you can omit the location to use the default.  To change the
436
437
    default, use --remember.
437
438
 
438
439
    This command only works on branches that have not diverged.  Branches are
439
 
    considered diverged if the branch being pushed to is not an older version
440
 
    of this branch.
 
440
    considered diverged if the destination branch's most recent commit is one
 
441
    that has not been merged (directly or indirectly) by the source branch.
441
442
 
442
443
    If branches have diverged, you can use 'bzr push --overwrite' to replace
443
 
    the other branch completely.
 
444
    the other branch completely, discarding its unmerged changes.
444
445
    
445
446
    If you want to ensure you have the different changes in the other branch,
446
 
    do a merge (see bzr help merge) from the other branch, and commit that
447
 
    before doing a 'push --overwrite'.
 
447
    do a merge (see bzr help merge) from the other branch, and commit that.
 
448
    After that you will be able to do a push without '--overwrite'.
448
449
    """
449
450
    takes_options = ['remember', 'overwrite', 
450
451
                     Option('create-prefix',