The supplied value should be either a comma-separated list of strings, or the name of a text file preceded by an up-arrow character " ", containing one or more comma-separated list of strings. Each string is either a ``keyword=value'' setting, or the name of a text file preceded by an up-arrow character " ". Such text files should contain further comma-separated lists which will be read and interpreted in the same manner (any blank lines or lines beginning with # are ignored). Within a text file, newlines can be used as delimiters as well as commas.
Each individual setting should be of the form:
keyword = value
where keyword is either a simple name, or a dot-delimited hierarchy of names (e.g. "camera.settings.exp=1.0"). The value string should not contain any commas. [!]
"\d"-- Matches a single digit.
"\D"-- Matches anything but a single digit.
"\w"-- Matches any alphanumeric character, and "_".
"\W"-- Matches anything but alphanumeric characters, and "_".
"\s"-- Matches white space.
"\S"-- Matches anything but white space.
Any other character that has no special significance within a regular expression matches itself. Characters that have special significance can be matched by preceding them with a backslash ( ) in which case their special significance is ignored (note, this does not apply to the characters in the set dDsSwW).
Note, minus signs ("-") within brackets have no special significance, so ranges of characters must be specified explicitly.
The following quantifiers are allowed.
The following constraints are allowed.
Multiple templates can be concatenated, using the " " character to separate them. The test string is compared against each one in turn until a match is found.
A template should use parentheses to enclose the sub-strings that are to be replaced, and the set of corresponding replacement values should be appended to the end of the string, separated by "=" characters. The section of the test string that matches the first parenthesised section in the template string will be replaced by the first replacement string. The section of the test string that matches the second parenthesised section in the template string will be replaced by the second replacement string, and so on.
The replacement strings can include the tokens "$1","$2", etc. The section of the test string that matched the corresponding parenthesised section in the template is used in place of the token.
See the ``Examples'' section above for how to use these facilities.
KAPPA --- Kernel Application Package