← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/builtins.py

Update docs again

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/builtins.py
2325
2325
            return 0
2326
2326
 
2327
2327
class cmd_revert(Command):
2328
 
    """Revert files to the last-committed version.
 
2328
    """Revert files to a previous revision.
2329
2329
 
2330
 
    Only versioned files are affected.  Specify filenames to revert only 
2331
 
    those files.  To revert files to a different revision, specify --revision.
 
2330
    Giving a list of files will revert only those files.  Otherwise, all files
 
2331
    will be reverted.  If the revision is not specified with '--revision', the
 
2332
    last committed revision is used.
2332
2333
 
2333
2334
    To remove only some changes, without reverting to a prior version, use
2334
2335
    merge instead.  For example, "merge . --r-2..-3" will remove the changes
2337
2338
    
2338
2339
    By default, any files that have been manually changed will be backed up
2339
2340
    first.  (Files changed only by merge are not backed up.)  Backup files have
2340
 
    '~#~' appended to their name, where # is a number.
 
2341
    '.~#~' appended to their name, where # is a number.
 
2342
 
 
2343
    When you provide files, you can use their current pathname or the pathname
 
2344
    from the target revision.  So you can use revert to "undelete" a file by
 
2345
    name.  If you name a directory, all the contents of that directory will be
 
2346
    reverted.
2341
2347
    """
2342
2348
    takes_options = ['revision', 'no-backup']
2343
2349
    takes_args = ['file*']