NAME

VCP::Filter::addlabels - Add labels to each revision

SYNOPSIS

  ## From the command line:
   vcp <source> addlabels: "rev_$rev_id" "change_$change_id" -- <dest>
  ## In a .vcp file:
    AddLabels:
            rev_$rev_id
            change_$change_id
            # ... etc ...

DESCRIPTION

Used when you want to track the original rev_id, change_id, branch_id, etc. each revision had in the source repository by adding a label. Can be used to turn any piece of metadata in to a label.

Note that the fields

    source_name, source_filebranch_id, source_branch_id,
    source_rev_id, source_change_id

are set by VCP to be the same value as the corresponding fields without the source prefix (except source_filebranch_id, which is built from the file name, rooted in the repository, and for cvs repositories, the branch number in angle brackets.) These source_* fields (intended to be immutable in vcp) should be used to make labels rather than their mutable equivalents which may be changed via a vcp filter.

There is no way to add labels only to selected revisions at this time, but if you try to add a label for metadata that is undefined or empty, it will not be added.

AUTHOR

Barrie Slaymaker <barries@slaysys.com>

COPYRIGHT

Copyright (c) 2000, 2001, 2002 Perforce Software, Inc. All rights reserved.

See VCP::License ("vcp help license") for the terms of use.