<< Click here to display Table of Contents >> Navigation: TCC-RT > Commands:

SETDOS

Contents

Purpose:

Display or set the TCC-RT configuration

Format:

SETDOS [/C? /D? /E? /Fn.n /G?? /I[+|-] command /M? /N? /P? /S?:? /V? /X[+|-]n]

/C(ompound)	/M(ode for editing)
/D(escriptions)	/N(o clobber)
/E(scape character)	/P(arameter character)
/F(ormat for @EVAL)	/S(hape of cursor)
/G (numeric separators)	/V(erbose)
/I(nternal)	/X (expansion, special characters)

See also: OPTION.

Usage:

SETDOS allows you to customize certain aspects of TCC-RT 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.

Inheritance

When a new instance of the command is started, it inherits the SETDOS characteristics set by the most recently started instance of TCC-RT.

Options:

[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.

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.

[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.

[@EVAL maximum and minimum] This option lets you set the default decimal display precision for the @EVAL variable function. The maximum precision is 1,000 digits to the left of the decimal point and 1,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 function if you want to set the display precision for a single computation.

[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.

/I	This option allows you to disable or enable internal commands. To disable a command, precede the command name with a minus [-]. To re-enable a command, precede it with a plus [+]. For example, to disable the internal LIST command to force TCC-RT to use an external command:

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).

[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.

/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.

[Insert and Overstrike Cursor] The cursor size is entered as a percentage of the total character height. The default values are 10:100 (a 10% underscore cursor for overstrike mode, and a 100% block cursor for insert mode). Because of the way video drivers remap the cursor shape, you may not get a smooth progression in the cursor size from 1% - 100%. (You can disable the cursor by specifying a size of 0:0.)

If either value is -1, TCC-RT 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.

/V	[Batch Echo] This option controls the default for command echoing in batch files.

/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.

/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.

The features enabled or disabled by /X are numbered (in hex). All features are enabled when TCC-RT 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

9	Include lists

A	User-defined functions

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.