CVSROOT/taginfo

   1 # The "taginfo" file is used to control pre-tag checks.
   2 # The filter on the right is invoked with the following arguments if no format strings are present:
   3 #
   4 # $1 -- tagname
   5 # $2 -- operation "add" for tag, "mov" for tag -F, and "del" for tag -d
   6 # $3 -- tagtype "?" on delete, "T" for branch, "N" for static
   7 # $4 -- repository
   8 # $5->  file revision [file revision ...]
   9 #
  10 # If any format strings are present in the filter, they will be replaced as follows:
  11 #    %b = branch mode = "?" (delete ops - unknown) | "T" (branch) | "N" (not branch)
  12 #    %o = operation = "add" | "mov" | "del"
  13 #    %p = path relative to repository
  14 #    %r = repository (path portion of $CVSROOT)
  15 #    %t = tagname
  16 #    %{sVv} = attribute list = file name, old version tag will be deleted from,
  17 #           new version tag will be added to (or deleted from, but this feature is
  18 #           deprecated.  When either old or new revision is unknown, doesn't exist,
  19 #           or isn't applicable, the string "NONE" will be placed on the command
  20 #           line.
  21 #
  22 # Note that %{sVv} is a list operator and not all elements are necessary.  Thus %{sV} is
  23 # a legal format string, but will only be replaced with file name and old revision.
  24 # it also generates multiple arguments for each file being operated upon.  i.e. if two
  25 # files, file1 & file2, are having a tag moved from version 1.1 to versoin 1.1.2.9, %{sVv}
  26 # will generate the following six arguments in this order: file1, 1.1, 1.1.2.9, file2, 1.1,
  27 # 1.1.2.9.
  28 #
  29 # A non-zero exit of the filter program will cause the tag to be aborted.
  30 #
  31 # The first entry on a line is a regular expression which is tested
  32 # against the directory that the change is being committed to, relative
  33 # to the $CVSROOT.  For the first match that is found, then the remainder
  34 # of the line is the name of the filter to run.
  35 #
  36 # If the repository name does not match any of the regular expressions in this
  37 # file, the "DEFAULT" line is used, if it is specified.
  38 #
  39 # If the name "ALL" appears as a regular expression it is always used
  40 # in addition to the first matching regex or "DEFAULT".