[Toc][Index]

Modifying the .INI File


You can create, add to, and modify the .INI file in 2 ways: with the 
OPTION command and by editing the file with any ASCII editor.  OPTION 
displays a set of dialogs which allow you to modify the settings that are 
used most often.  When you exit from the dialogs, you can select the Save 
button to save your changes in the .INI file for use in the current 
session and all future sessions, select the Use or OK button to use your 
changes in the current session only, or discard the changes you have made 
by selecting the Cancel button.  See the OPTION command for additional 
details. 
Changes you make in the Startup section of the OPTION dialogs will only 
take effect when you restart the session or window in which CMD.EXE is 
running. 
OPTION handles most standard .INI file settings.  A few more advanced 
settings, as well as all settings that affect the interpretation of 
keystrokes, cannot be modified with OPTION and must be inserted or 
modified manually.  For more details see the OPTION command. 
You can also create, add to, and edit the CMD.INI file "manually" with any 
ASCII text editor.  Each command processor reads its .INI file when it 
starts, and configures itself accordingly. The .INI file is not re-read 
when you change it manually.  For manual changes to take effect, you must 
restart the session or window in which CMD.EXE is running.  If you edit 
the .INI file manually, make sure you save the file in ASCII format. 
Each item that you can include in the .INI file has a default value.  You 
only need to include entries in the file for settings that you want to 
change from their default values. 

Format: 
Most lines in the .INI file consist of a one-word directive, an equal sign 
[=], and a value.  For example, in the following line, the word 
"Environment" is the directive and "2048" is the value: 


        Environment = 2048

Any spaces before or after the equal sign are ignored. 
If you have a long string to enter in the .INI file (for example, for the 
ColorDir directive), you must enter it all on one line.  Strings cannot be 
"continued" to a second line.  Each line may be up to 1023 characters 
long. 
The format of the value part of a directive line depends on the individual 
directive.  It may be a numeric value, a single character, a choice (like 
"Yes" or "No"), a color setting, a key name, a path, a filename, or a text 
string.  The value begins with the first non-blank character after the 
equal sign and ends at the end of the line or the beginning of a comment. 
Blank lines are ignored in the .INI file and can be used to separate 
groups of directives.  You can place comments in the file by beginning a 
line with a semicolon [;].  You can also place comments at the end of any 
line except one containing a text string value.  To do so, enter at least 
one space or tab after the value, a semicolon, and your comment, like 
this: 


        Environment = 2048     ;set standard environment size

If you try to place a comment at the end of a string value, the comment 
will become part of the string and will probably cause an error. 
If you use the OPTION dialogs to modify the .INI file, comments on lines 
modified from within the dialogs will not be preserved when the new lines 
are saved.  To be sure .INI file comments are preserved, put them on 
separate lines in the file 
If you want to include the text of one .INI file within another (for 
example, if you have a set of common directives used by several JP 
Software products), see the Include directive. 

Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs