mkrules

set or clear multiple include/exclude rules for a workspace or stream

Usage

accurev mkrules -l <file>

Description

The mkrules command uses an XML-format file to set one or more include/exclude rules for a workspace or stream. The following example demonstrates the structure of the input file:

<depot name="velo"/>
  <stream name="xray24_dvt_john"/>
  <comment>set two rules for a workspace</comment>
  <elements>
    <element
      kind="excl"
      location="\.\dir01\sub01"/>
    <element
      kind="incldo"
      location="\.\dir02\sub02"/>
    <element
       kind="incl"
       location="\.\dir01\sub03"
       backingStream="xray24_qa"/>
    </elements>

You can create an input file for mkrules by revising the output of an lsrules -fmx command as follows:

•	Remove the top-level tags: <AcResponse> and </AcResponse>.

•	To clear an existing rule, change the value of the kind attribute from incl/incldo/excl to clear.

•	The <depot> element is required unless you are running this command from within a workspace.

•	The <stream> element is optional; if you omit it, mkrules operates on the current workspace.

Important! If the <stream> element is omitted, mkrules must be run from within a workspace.

•	The <comment> element is optional; it places a comment string in the AccuRev transaction that mkrules creates.

Options

-l <file>

Specifies the location of the XML-format message (document), containing the set of include/exclude rules to be set or cleared.

See Also

clear, excl, incl, incldo, lsrules