SETDOS
Contents
| Purpose: | Display or set the TCC configuration |
| Format: | SETDOS [/A? /C? /D? /E? /Fn.n /G?? /I[+|-] command /M? /N? /P? /S?:? /V? /X[+|-]n] |
See also: OPTION.
Usage:
SETDOS allows you to customize certain aspects of TCC to suit your personal tastes or the configuration of your system.
You can display the value of all SETDOS options by entering the SETDOS command with no parameters.
Most of the SETDOS options can also be changed in the configuration dialogs. The name of the corresponding configuration option is listed with each SETDOS option below; if none is listed, that option cannot be set from the configuration dialogs. You can also define the SETDOS options in your TCSTART or other startup file (see Automatic Batch Files), in aliases, or at the command line.
Note: The functionality of the "/Y" option ("debug", no longer supported) of previous versions has been moved to the BDEBUGGER command.
Inheritance
When a new instance of the command is started, it inherits the SETDOS characteristics set by the most recently started instance of TCC.
Options:
| /A | [ANSI] This option determines whether ANSI X3.64 support is enabled. /A1 enables ANSI X3.64 string processing. The default of /A0 disables ANSI X3.64 strings. See the ANSI X3.64 Commands Reference for a list of the ANSI X3.64 sequences supported by TCC. See also: the ANSI Colors configuration option and the _ANSI internal variable. |
| /C | [Command Separator] This option sets the character used for separating multiple commands on the same line. The default value is the ampersand [&]. You cannot use any of the redirection characters (| > <), or a space, tab, comma, or equal sign as the command separator. The command separator is saved by SETLOCAL and restored by ENDLOCAL. The following example changes the separator character to a tilde [~]: |
setdos /c~
| /D | [Descriptions and Description Name] This option controls whether file processing commands like COPY, DEL, MOVE, and REN process file descriptions along with the files they belong to. /D1 turns description processing on, which is the default. /D0 turns description processing off. See also: the Enable Descriptions configuration option. |
You can also use /D to set the name of the hidden file in each directory that contains file descriptions. To do so, follow /D with the filename in quotes:
setdos /d"files.bbs"
Use this option with caution, because changing the name of the description file will make it difficult to transfer file descriptions to another system.
| /E | [Escape Character] This option sets the character used to suppress the normal meaning of the following character. Any character following the escape character will be passed unmodified to the command. The default escape character is a caret [^]. You cannot use any of the redirection characters (| > <) or a space, tab, comma, or equal sign as the escape character. The escape character is saved by SETLOCAL and restored by ENDLOCAL. Certain characters (b, c, e, f, k, n, q, r, s, and t) have special meanings when immediately preceded by the escape character. |
| /F | [@EVAL maximum and minimum] This option lets you set the default decimal display precision for the @EVAL variable function. The maximum precision is 20,000 digits to the left of the decimal point and 10,000 digits to the right of the decimal point. (You can specify up to 10,000 digits in an @EVAL calculation by using the =x,y option.) |
The format for this option is /Fx.y, where the x value sets the minimum number of digits to the right of the decimal point and the y value sets the maximum number of digits. You can use =x,y instead of =x.y if the comma is your decimal separator. Both values can range from 0 to 10. You can specify either or both values: /F2.5, /F2, and /F.5 are all valid entries. If x is greater than y, it is ignored; if only x is specified, y is set to the same value (e.g. /F2 is equivalent to /F2.2). See the @EVAL Precision configuration option to set the precision when TCC starts; see the @EVAL function if you want to set the display precision for a single computation.
| /G | [Decimal and thousands separator characters] This option sets the Decimal and Thousands separator characters. The format is /Gxy where "x" is the new decimal separator and "y" is the new thousands separator. Both characters must be included. The only valid settings are /G., (period is the decimal separator, comma is the thousands separator); /G,. (the reverse); or /G0 to remove any custom setting and use the default separators associated with your current country code (this is the default). |
The decimal separator is used for @EVAL, numeric IF and IFF tests, version numbers, and other similar uses. The thousands separator is used for numeric output, and is skipped when performing calculations in @EVAL.
setdos /i-list
To re-enable all disabled commands use /I*.
| /M | [Edit Mode] This option controls the initial line editing mode. To start in overstrike mode at the beginning of each command line, use /M0 (the default). To start in insert mode, use /M1). See also: the Edit Mode configuration option. |
| /N | [NoClobber] This option controls output redirection. /N0 means existing files will be overwritten by output redirection (with >) and that appending (with >>) does not require the file to exist already. This is the default. /N1 means existing files may not be overwritten by output redirection, and that when appending the output file must exist. A /N1 setting can be overridden with the [!] character. See also: the Protect Redirected Output File configuration option. |
| /P | [Parameter Character] This option sets the character used after a percent sign to specify all or all remaining command line parameters in a batch file or alias. The default value is the dollar sign [$]. The parameter character is saved by SETLOCAL and restored by ENDLOCAL. |
If either value is -1, TCC will not attempt to modify the cursor shape at all. You can retrieve the current cursor shape values with the %_CI and %_CO internal variables. See also the Overstrike Cursor and Insert Cursor configuration options.
/V0 disables echoing of batch file commands unless ECHO is explicitly set ON.
/V1, the default setting, enables echoing of batch file commands unless ECHO is explicitly set OFF. See also: the Batch Echo configuration option.
| /X[+|-]n | (expansion and special characters) This option enables and disables alias and environment variable expansion, and controls whether special characters have their usual meaning or are treated as text. It is most often used in batch files to process text strings which may contain special characters. You can get the current expansion mode with the %_expansion internal variable. |
The features enabled or disabled by /X are numbered (in hex). All features are enabled when TCC starts, and you can re-enable all features at any time by using /X0. To disable a particular feature, use /X-n, where n is the feature number from the list below. To re-enable the feature, use /X+n. To enable or disable multiple individual features, list their numbers in sequence after the + or - (e.g. /X-345 to disable features 3, 4, and 5).
The features are:
| 1 | All alias expansion |
| 2 | Nested alias expansion only |
| 3 | All variable expansion (includes environment variables, batch file parameters, variable function evaluation, and alias parameters) |
| 4 | Nested variable expansion only |
| 5 | Multiple commands, conditional commands, and piping (affects the command separator, ||, &&, |, and |&) |
| 6 | Redirection (affects < , >, >&, >&>, etc.) |
| 7 | Quoting (affects back-quotes [`] and double quotes ["]) and square brackets) |
| 8 | Escape character |
If nested alias expansion is disabled (/X-2), the first alias of a command is expanded but any aliases it invokes are not expanded. If nested variable expansion is disabled (X-4), each variable is expanded once, but variables containing the names of other variables are not expanded further.
For example, to disable all features except alias expansion while you are processing a text file containing special characters:
setdos /x-35678
... [perform text processing here]
setdos /x0
A SETLOCAL command will save the current SETDOS /X values for ENDLOCAL to restore.