Using the --ignore Option for CLI Commands

You can specify ignore patterns using one or more --ignore options for the add, files, and stat CLI commands. Ignore patterns specified using --ignore options take precedence over patterns specified using either the .acignore file.

Command	Description
stat -x	Lists external objects. (In the AccuRev GUI, performing an External search in the File Browser Outgoing Changes mode executes a stat-x command.)
add -x	Adds external objects to the AccuRev depot, placing them under AccuRev control.
files	Lists all elements and external objects.

(Note that the stat -x command is also used by the External search in the AccuRev GUI.)

When applying stat -x and add -x commands to an entire workspace, AccuRev uses any applicable ignore patterns to filter the list of objects before sending the list to the AccuRev Server process. You can, however, instruct AccuRev to include objects that would otherwise be ignored because they match an applicable ignore pattern, as described in the following section.

One Pattern per Each --ignore

The --ignore option can be used to express only a single pattern, however, you can use multiple --ignore options for a single CLI command. For example, if you want AccuRev to ignore all .bak and .txt files, for example, you might enter the following:

accurev stat -x --ignore=*.bak --ignore=*.txt

You can also specify a file containing ignore patterns and reference that file using --ignore. For example:

accurev stat -x --ignore="@c:\my_files\ignore.txt"

Patterns specified in this file (ignore.txt, in this example) must follow the same rules as the .acignore file.

See the CLI User’s Guide or command line help for more information on the --ignore option for these commands.