← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-10-18 11:57:18 UTC
  • mfrom: (5505.1.1 trunk)
  • Revision ID: pqm@pqm.ubuntu.com-20101018115718-cbuoc2gafnjldngk
(vila) Document hunk editing when shelving.(Neil Martinsen-Burrell)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/builtins.py
5907
5907
 
5908
5908
    You can put multiple items on the shelf, and by default, 'unshelve' will
5909
5909
    restore the most recently shelved changes.
 
5910
 
 
5911
    For complicated changes, it is possible to edit the changes in a separate
 
5912
    editor program to decide what the file remaining in the working copy
 
5913
    should look like.  To do this, add the configuration option
 
5914
 
 
5915
        change_editor = PROGRAM @new_path @old_path
 
5916
 
 
5917
    where @new_path is replaced with the path of the new version of the 
 
5918
    file and @old_path is replaced with the path of the old version of 
 
5919
    the file.  The PROGRAM should save the new file with the desired 
 
5920
    contents of the file in the working tree.
 
5921
        
5910
5922
    """
5911
5923
 
5912
5924
    takes_args = ['file*']
5924
5936
        Option('destroy',
5925
5937
               help='Destroy removed changes instead of shelving them.'),
5926
5938
    ]
5927
 
    _see_also = ['unshelve']
 
5939
    _see_also = ['unshelve', 'configuration']
5928
5940
 
5929
5941
    def run(self, revision=None, all=False, file_list=None, message=None,
5930
5942
            writer=None, list=False, destroy=False, directory=u'.'):