1This file describes all the environment variables and options that are
2available in TELNET.INI.  If you are having problems with a terminal setting,
3this is the file you want to read first.  If this file does not help you,
4please send a bug report to Paul Brannan <pbranna@clemson.edu>.
5
6Environment variables
7---------------------
8
9Before there was a telnet.ini file, all the options were controlled
10through environment variables.  These have been left in for compatibility
11with previous versions, and for specifying locations of files.  They
12override any values in telnet.ini.
13
14TELNET_CFG      Specifies the location of the keys.cfg file
15TELNET_REDIR    Specifies whether file redirection needs to be supported
16INPUT_REDIR     Specicies only to redirect input
17OUTPUT_REDIR    Specifies only to redirect output
18TELNET_INI      Specifies the location of the telnet.ini file
19
20Configuration options
21---------------------
22
23These are the options that you can specify in telnet.ini.  This file is in
24the same format as any normal Windows ini file.  You can also change some
25of these options using the SET command at the telnet> prompt.
26
27[Terminal] section
28
29Dumpfile
30Specifies the filename of a file to dump output to.  (Default = "")
31
32Term
33The name of the terminal type to send to the server.  You
34can use this if Telnet is sending "ANSI" but you have a
35vt100 terminal.  If you use this options, please read about
36some of the other options below.  (Default = ansi)
37
38EightBit_Ansi
39Some machines use the ASCII characters 128 to 155 for ANSI
40sequences.  These are usually the newer VAX systems.  Turning
41this option on may cause problems with certain foreign
42(non-American) character sets.  (Default = FALSE)
43
44VT100_Mode
45This option turns on VT100 mode.  There are a few minor
46differences between ANSI terminals and DEC VT100 terminals.
47I recommend trying TERM=vt220 or TERM=vt102 before trying
48this option, but if you must have true VT100 emulation,
49this is the only way to get it.  (Default = FALSE)
50
51Destructive_Backspace
52This will probably cause problems with most programs, but if you need the
53backspace to erase the previous character (as with some BBSes), use this
54option.  (Default = FALSE)
55
56Speaker_Beep
57If you set this to true you will hear beeps through the PC speaker; setting
58it to false will play the default system beep sound through your sound
59card.  (Default = TRUE)
60
61Beep
62Setting this to false turns off all beeps; setting this to true turns on
63all beeps.  (Default = TRUE)
64
65Preserve_Colors
66This turns on color preservation for systems that require it (like SCO).
67(Default = FALSE)
68
69Wrap_line
70This turns on/off line wrap.  (Default = TRUE)
71
72Lock_linewrap
73Turning on this option disables the ability of the remote end to control
74line wrap, and "locks" it into whatever it is set to in the ini file.
75(Default = FALSE)
76
77Fast_write
78This turns on/off fast screen write.  Turning it off allows you to see
79control characters if your application requires it.  (Default = TRUE)
80
81Term_width
82Term_height
83These options specify the size of the terminal.  You can specify non-standard
84sizes if you are running telnet in a window.  You may want to specify
85a font size if you use these (using "Auto" can cause display problems).
86Specifying -1 means use the settings for the parent console.
87(Default = -1, -1)
88
89Wide_enable
90This is to allow the ANSI parser to change the screen size when sent certain
91escape sequences.  This is for vt100 compatibility.  (Default = FALSE)
92
93Buffer_size
94This is the size of the ANSI buffer used for parsing sequences.  Increasing
95this value speeds up the parser, and decreasing it allows the mouse to
96respond faster.  (Default = 2048)
97
98Input_redir
99Output_redir
100These are for redirecting input and output.  (Default = 0, 0)
101Any value greater than 0 turns redir on.  Turn Output_redir on to bypass
102the Console Telnet screen writing and positioning functions and simply
103pass the data stream as received from the host straight through.
104
105Strip_redir
106If enabled, this option will attempt to strip the stream before passing it on
107through redirected output.  This will have no effect on non-redirected output.
108(Default=FALSE)
109
110[Colors] section
111
112Setting the following to -1 disables them:
113Blink_bg                Background color to use for blink (default = -1)
114Blink_fg                Foreground color to use for blink (default = -1)
115Underline_bg            Background color to use for underline (default = -1)
116Underline_fg            Foreground color to use for underline (default = -1)
117UlBlink_bg              Background color to use for blink+uline (default = -1)
118UlBlink_fg              Foreground color to use for blink+uline (default = -1)
119
120Setting the following to -1 uses colors detected at startup:
121Normal_bg               Normal text background color (default = -1)
122Normal_fg               Normal text foreground color (default = -1)
123
124Please do not set these values to -1:
125Scroll_bg               Background color for scrollback mode (default = 0)
126Scroll_fg               Foreground color for scrollback mode (default = 7)
127Status_bg               Bg color of status line in scrollback (default = 1)
128Status_fg               Fg color of status line in scrollback (default = 15)
129
130Here's a list of colors:
1310 - black, 1 - blue, 2 - green, 3 - cyan, 4 - red, 5 - magenta, 6 - brown
1327 - lt. grey (dk. white), 8 - dk. grey, 9 - bright blue, 10 - bright green,
13311 - bright cyan, 12 - bright red, 13 - bright magenta, 14 - yellow
13415 - bright white
135
136[Mouse] section
137
138Enable_Mouse
139Turns on mouse support.  (Default = TRUE)
140
141[Printer] section
142
143Printer_Name
144The DOS name for the printer.  (Default = LPT1)
145
146[Keyboard] section
147Many of these options are also available from telnet.cfg.
148
149Escape_key
150The key to break out of a telnet session.  (Default = ])
151
152Scrollback_key
153The key for switching to scrollback mode.  (Default = [)
154
155Dial_key
156You can start a new telnet session with this key.  (Default = \)
157
158Alt_erase
159If you set this to true, it will swap backspace and delete.
160(Default = FALSE)
161
162Keyboard_paste
163This option allows pasting to the screen via shift-insert.  (Default = FALSE)
164
165Keyfile
166Selects an alternate telnet.cfg file.  (Default = TELNET.CFG)
167
168Default_Config
169Selects a different keyboard definition.  All of these are defined in
170telnet.cfg.
171
172[Scrollback] section
173
174Scroll_Mode
175Selects the default mode for scrollback.  Valid selections are:
176        HEX             Hex dump
177        DUMP            Dump, control characters are shown as "."
178        DUMPB           Binary dump
179        TEXT            Text mode
180Note: you can press TAB in scrollback mode to cycle through these.
181(Default = DUMP)
182
183Command-line Options
184--------------------
185
186-d<filename>    Specifies the name of the dumpfile.
187-h		Gives a help screen.
188