The Hackerlab at `regexps.com`

## Customizing the inventory Naming Conventions

up: arch Meets hello-world next: The GNU Free Documentation License prev: The arch Changeset Format

In Project Tree Inventories, you learned how the `larch inventory` command classifies files within a project tree using a set of naming conventions. This appendix explains how you can customize those naming conventions.

### When to Customize Naming Conventions

It's best to make customizations to the naming conventions of a project at the outset: before you `import` your first revision.

If you must make changes later, then it's essential that your changes do not change the classification of files already in the latest revision(s) of your project at the time you make the change (otherwise, you are likely to experience perplexing and undesirable behavior).

### How to Customize Naming Conventions

You should begin by reviewing the naming convention algorithm in The arch Naming Conventions. You can modify that algorithm by changing the regular expression used for each category test.

You can customize naming conventions by modifying the file `./{arch}/=tagging-method` in your project trees. That file is created by the `tagging-method` command and initially, it contains a single line which names the tagging method (`names` , `explicit` , or `implicit` ).

In particular, `=tagging-method` can contain blank lines and comments (lines beginning with # ) and directives, one per line. The permissible directives are:

            implicit
            explicit
            names
                    specify the tagging method to use for this tree

            exclude RE
            junk RE
            backup RE
            precious RE
            unrecognized RE
            source RE
                    specify a regular expression to use for the indicated
                    category of files.

Regular expressions are specified in Posix ERE syntax (the same syntax used by egrep , grep -E , and awk ) and have default values which implement the naming conventions described in The arch Naming Conventions.

arch Meets hello-world: A Tutorial Introduction to The arch Revision Control System
The Hackerlab at `regexps.com`