Product Documentation

BTRV Edition User's Guide

Previous Topic

Next Topic

<normalize>

The <normalize> configuration option helps normalizing file paths passed to FairCom RTG. This option is global-only and can be set only as a child of <config>. It is not valid if specified as child of <*instance> or <file>. When this option is in use the file path gets normalized before any file configuration matching.

The <normalize> section can perform two types of normalization:

  1. <sep> - Specifies the path separator, such as forward slash (/) or backslash (\).
  2. <drive> - Specifies a drive letter to be used if the path does not include a drive letter.
  3. If the file path to be normalized already includes a drive letter, <drive> accepts a force= attribute to force it to change the drive to the one specified, for example <drive force="y">.

Examples

The following <normalize> section replaces all path separators with a backslash (\) and prefixes all the file paths with a C drive unless the path to be normalized already includes a drive letter:

<normalize><sep>\</sep><drive>C</drive></normalize>

If the file path to be normalized already has a drive it is not changed by default. It is possible to force the drive to be changed to the one specified by setting the force= attribute to yes. For example:

<normalize><drive force="y">C</drive></normalize>

It is also possible to remove an existing drive by specifying an empty drive. For example:

<normalize><drive></drive></normalize>

TOCIndex