Purpose: | Modify or display TCC configuration |
Formats: | Invoking the OPTION dialog: |
OPTION
OPTION /U
Temporarily changing an option:
OPTION //directive=value ...
Temporarily changing a list of options:
OPTION @filename
Displaying the current value of an option:
OPTION directive
directive | Name of a directive to set, modify, or display. |
value | A new value for that directive. |
filename | A file containing directives to be immediately activated. |
Usage:
OPTION without parameters displays a property sheet which allows you to modify most of the configuration options stored in the INI file.
When you exit from the property sheet, you can select Save to save your changes in the .INI file for use in the current session and all future sessions, or select Cancel to discard the changes. See Configuration Dialogs for more information.
In some cases, changes you make in the Startup section of the OPTION dialogs will only take effect when you restart TCC. Other changes take effect as soon as you exit the dialogs with Apply or OK. However, not all option changes will appear immediately, even if they have taken effect. For example, some color changes will only appear after a CLS command.
OPTION handles most standard directives, including key mapping. The Advanced Directives cannot be modified with the OPTION dialogs. These settings must be manually edited in the .INI file.
OPTION does not preserve inline comments when saving modified settings in the .INI file. To be sure .INI file comments are preserved, put them on separate lines in the file.
The /U option will invoke the updater to check https://jpsoft.com for updates to Take Command / TCC.
Setting Individual Options Temporarily
If you follow the OPTION command with one or more sequences of a double slash mark //, each followed by a new directive=value, the new settings will take effect immediately, and will be in effect for the current session only. This example turns off batch file echo and changes the input colors to bright cyan on black:
option //BatchEcho=No //InputColors=bri cya on bla
Option values may contain white space. However, you cannot enter an option value that contains the // string. If you do not specify a value, OPTION will reset the value for that directive to the default.
This feature is most useful for testing settings quickly, and in aliases or batch files that depend on certain options being in effect.
Changes made with // are temporary. They will not be saved in the .INI file.
Setting Many Options Temporarily
The command OPTION @filename allows you to temporarily modify multiple directive settings. The file specified by filename must be in the same format as an .INI file. Changes made with @filename are temporary. They will not be saved in the .INI file.
Specifying an option name alone will display the value of that option; e.g.:
option localHistory
localHistory=Yes
See also: the @OPTION function.