Batchoptions File Format
Note:
Functionality featured in the example in this section applies to multiple design types.
An example batchoptions file is shown below:
$begin 'Config'
'Desktop/ProjectDirectory'='C:/test/projects'
'Desktop/Settings/ProjectOptions/NumberofProcessors'=2
$end 'Config'
Additional notes on the file format:
- The file may contain an arbitrary number of batchoption entries, one per line.
- Leading whitespace on each line is ignored. Spaces or tabs may be used to make the file more readable.
- The Registry Key appears before the equals sign ( = ) on each line and must be enclosed in single quotes ( ' ). The registry key includes the key path and the name of the registry value.
- The registry value (or option value) appears after the equals sign on each line.
- Registry keys are case-insensitive.
- There are two supported types of registry values—string and integer:
- Each string value must be enclosed in single quotes ( ' ).
- Do not enclose interger values in quotes.
- For file paths within string values, the forward slash ( / ) may be used as a directory separator on both Windows and Linux systems.
- Alternatively, on Windows only, the customary backslash ( \ ) may be used as a directory separator. However, in string values, the backslash is used as an escape code for indicating special characters that cannot be typed directly (such as \n for a new line). Therfore, if you use the backslash as a directory path separator, each instance must be doubled ( \\ ). An example is: '\\\\host3\\temp\\Ansoft'. In this case, each double backslash is interpreted as a single backslash (\\host3\temp\Ansoft).
- The single quote character ( ' ) normally ends a string value. If you need to include a single quote (or apostrophe) within a string, use the backslash-apostrophe ( \' ) escape sequence. For example, the string '%UserProfile%/Documents/Ansoft/John\'s_Files', is interpreted as: %UserProfile%/Documents/Ansoft/John's_Files.