add (6)

Attempts to add a series of file exclusions to the selected systems. No action will be taken unless at least one system is selected.

Please note that using this command will re-indent and remove all comments from the selected systems’ UDC files.

usage: cmri system file-exclusion add <--expressions EXPRESSIONS>

required arguments:

-e,``-expression``

A comma-separated list of expressions matching a series of files which will be excluded from the CodeMRI scan. See the Expressions section below for details.

Expressions

Expressions are evaluated in the order they appear and indicate a combination of files or directories to exclude from the CodeMRI scan. This is done through the use of an exclusion group, which contains the expressions to indicate the files to exclude.

Standard expressions are simply written as a file or directory path string some/file.c. The * is considered a wildcard character so to include all files under a specific directory, the expression would be written like, some/directory/*.

The expressions written above add an inclusion to the exclusion group. This simply means that the files indicated by the expressions are included in the exclusion group and would be removed from the CodeMRI scan. It is also possible to add an exclusion to the exclusion group which allows for greater flexibility in designating files or directories from being excluded in the CodeMRI scan.

Exclusion expressions begin with a ~ and indicate files or directories which are to be excluded from the exclusion group. This allows finer control and flexibility when indicating which files are to be excluded from the CodeMRI scan. For example, if the user wanted to exclude all files under some/directory but not exclude the .h files under the same directory, that can be achieved easily using an inclusion expression of some/directory/* combined with an exclusion expression of ~*.h. Together, they would be written in a single expression like some/directory/*,~*.h.