~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/revisionspec.py

Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
286
286
    than the branch's history, the first revision is returned.
287
287
    Examples::
288
288
 
289
 
      revno:1                   -> return the first revision
 
289
      revno:1                   -> return the first revision of this branch
290
290
      revno:3:/path/to/branch   -> return the 3rd revision of
291
291
                                   the branch '/path/to/branch'
292
292
      revno:-1                  -> The last revision in a branch.
475
475
 
476
476
    help_txt = """Selects the parent of the revision specified.
477
477
 
478
 
    Supply any revision spec to return the parent of that revision.
 
478
    Supply any revision spec to return the parent of that revision.  This is
 
479
    mostly useful when inspecting revisions that are not in the revision history
 
480
    of a branch.
 
481
 
479
482
    It is an error to request the parent of the null revision (before:0).
480
 
    This is mostly useful when inspecting revisions that are not in the
481
 
    revision history of a branch.
482
483
 
483
484
    Examples::
484
485
 
485
486
      before:1913    -> Return the parent of revno 1913 (revno 1912)
486
487
      before:revid:aaaa@bbbb-1234567890  -> return the parent of revision
487
488
                                            aaaa@bbbb-1234567890
488
 
      bzr diff -r before:revid:aaaa..revid:aaaa
489
 
            -> Find the changes between revision 'aaaa' and its parent.
490
 
               (what changes did 'aaaa' introduce)
 
489
      bzr diff -r before:1913..1913
 
490
            -> Find the changes between revision 1913 and its parent (1912).
 
491
               (What changes did revision 1913 introduce).
 
492
               This is equivalent to:  bzr diff -c 1913
491
493
    """
492
494
 
493
495
    prefix = 'before:'