clear

remove an include/exclude rule

Usage

accurev clear [ -c <comment> ] [ -s <stream> ] [ -fx ] { -l <list-file> | <existing-rule> }

Description

The clear command removes an existing include/exclude rule from the specified stream. If you don’t specify a stream, the command applies to the workspace containing the current working directory. You must specify the existing rule with a depot-relative pathname, just as it appears in an lsrules listing.

When you remove a rule from a stream, the effect is immediate on the stream itself and on streams below it. The effect does not take place on workspaces below the stream until they are Update’d.

When you remove a rule from a workspace, the effect is immediate on the workspace itself: files are copied into the workspace tree if you remove an exclude rule; files are deleted from the workspace tree if you remove an include rule.

Options

-c <comment>

Specify a comment about the change to the include/exclude rules. The next command-line argument should be a quoted string. Alternatively, the next argument can be in the form @<comment-file>, which uses the contents of text-file <comment-file> as the comment.

-s <stream>

The name of the stream in which the include or exclude rule was explicitly set. (Use lsrules -fx to determine this information.) If you use this option, you must specify the existing rule with a depot-relative pathname.

-fx

Display the results in XML format.

-l <list-file>

Process the include/exclude rules listed in <list-file>. This must be a text file, with one rule per line. Extra whitespace is not allowed; make sure there are no empty lines and no leading or trailing white space around the rules. There is no provision for comment lines in a <list-file>.

If you use this option, you cannot also specify an <existing-rule>.

<existing-rule>

An existing include/exclude rule. If you specify a rule in this way, you cannot also use the -l option.

Examples

Remove the rule for subdirectory perl from the current workspace:

> accurev clear \.\tools\perl

Remove the rule for subdirectory perl from stream kestrel_test:

> accurev clear -s kestrel_test \.\tools\perl

See Also

excl, incl, lsrules, update