Sebastian Kuschel reports that pfd_closing can be called for a socket
[u/mdw/putty] / doc / man-ptel.but
CommitLineData
e3e5784e 1\cfg{man-identity}{puttytel}{1}{2004-03-24}{PuTTY tool suite}{PuTTY tool suite}
2
3\H{puttytel-manpage} Man page for PuTTYtel
4
5\S{puttytel-manpage-name} NAME
6
7\cw{puttytel} \- GUI Telnet and Rlogin client for X
8
9\S{puttytel-manpage-synopsis} SYNOPSIS
10
11\c puttytel [ options ] [ host ]
12\e bbbbbbbb iiiiiii iiii
13
14\S{puttytel-manpage-description} DESCRIPTION
15
16\cw{puttytel} is a graphical Telnet and Rlogin client for X. It
17is a direct port of the Windows Telnet and Rlogin client of the same
18name, and a cut-down cryptography-free version of PuTTY.
19
20\S{puttytel-manpage-options} OPTIONS
21
22The command-line options supported by \cw{puttytel} are:
23
24\dt \cw{\-\-display} \e{display\-name}
25
26\dd Specify the X display on which to open \cw{puttytel}. (Note this
27option has a double minus sign, even though none of the others do.
28This is because this option is supplied automatically by GTK.
29Sorry.)
30
31\dt \cw{\-fn} \e{font-name}
32
33\dd Specify the font to use for normal text displayed in the terminal.
34
35\dt \cw{\-fb} \e{font-name}
36
37\dd Specify the font to use for bold text displayed in the terminal. If
38the \cw{BoldAsColour} resource is set to 1 (the default), bold text
39will be displayed in different colours instead of a different font,
863c5362 40so this option will be ignored. If \cw{BoldAsColour} is set to 0 or 2
e3e5784e 41and you do not specify a bold font, \cw{puttytel} will overprint the
42normal font to make it look bolder.
43
44\dt \cw{\-fw} \e{font-name}
45
46\dd Specify the font to use for double-width characters (typically
47Chinese, Japanese and Korean text) displayed in the terminal.
48
49\dt \cw{\-fwb} \e{font-name}
50
51\dd Specify the font to use for bold double-width characters
52(typically Chinese, Japanese and Korean text). Like \cw{-fb}, this
863c5362 53will be ignored unless the \cw{BoldAsColour} resource is set to 0 or 2.
e3e5784e 54
55\dt \cw{\-geometry} \e{geometry}
56
57\dd Specify the size of the terminal, in rows and columns of text. See
58\e{X(7)} for more information on the syntax of geometry
59specifications.
60
61\dt \cw{\-sl} \e{lines}
62
63\dd Specify the number of lines of scrollback to save off the top of the
64terminal.
65
66\dt \cw{\-fg} \e{colour}
67
68\dd Specify the foreground colour to use for normal text.
69
70\dt \cw{\-bg} \e{colour}
71
72\dd Specify the background colour to use for normal text.
73
74\dt \cw{\-bfg} \e{colour}
75
76\dd Specify the foreground colour to use for bold text, if the
863c5362 77\cw{BoldAsColour} resource is set to 1 (the default) or 2.
e3e5784e 78
79\dt \cw{\-bbg} \e{colour}
80
81\dd Specify the foreground colour to use for bold reverse-video text, if
863c5362 82the \cw{BoldAsColour} resource is set to 1 (the default) or 2. (This
e3e5784e 83colour is best thought of as the bold version of the background
84colour; so it only appears when text is displayed \e{in} the
85background colour.)
86
87\dt \cw{\-cfg} \e{colour}
88
89\dd Specify the foreground colour to use for text covered by the cursor.
90
91\dt \cw{\-cbg} \e{colour}
92
93\dd Specify the background colour to use for text covered by the cursor.
94In other words, this is the main colour of the cursor.
95
96\dt \cw{\-title} \e{title}
97
98\dd Specify the initial title of the terminal window. (This can be
99changed under control of the server.)
100
101\dt \cw{\-sb\-} or \cw{+sb}
102
103\dd Tells \cw{puttytel} not to display a scroll bar.
104
105\dt \cw{\-sb}
106
107\dd Tells \cw{puttytel} to display a scroll bar: this is the opposite of
108\cw{\-sb\-}. This is the default option: you will probably only need
109to specify it explicitly if you have changed the default using the
110\cw{ScrollBar} resource.
111
112\dt \cw{\-log} \e{filename}
113
114\dd This option makes \cw{puttytel} log all the terminal output to a file
115as well as displaying it in the terminal.
116
117\dt \cw{\-cs} \e{charset}
118
119\dd This option specifies the character set in which \cw{puttytel}
120should assume the session is operating. This character set will be
121used to interpret all the data received from the session, and all
122input you type or paste into \cw{puttytel} will be converted into
123this character set before being sent to the session.
124
125\lcont{ Any character set name which is valid in a MIME header (and
126supported by \cw{puttytel}) should be valid here (examples are
127\q{\cw{ISO-8859-1}}, \q{\cw{windows-1252}} or \q{\cw{UTF-8}}). Also,
128any character encoding which is valid in an X logical font
129description should be valid (\q{\cw{ibm-cp437}}, for example).
130
131\cw{puttytel}'s default behaviour is to use the same character
132encoding as its primary font. If you supply a Unicode
133(\cw{iso10646-1}) font, it will default to the UTF-8 character set.
134
135Character set names are case-insensitive.
136}
137
138\dt \cw{\-nethack}
139
140\dd Tells \cw{puttytel} to enable NetHack keypad mode, in which the
141numeric keypad generates the NetHack \c{hjklyubn} direction keys.
142This enables you to play NetHack with the numeric keypad without
143having to use the NetHack \c{number_pad} option (which requires you
144to press \q{\cw{n}} before any repeat count). So you can move with
145the numeric keypad, and enter repeat counts with the normal number
146keys.
147
148\dt \cw{\-help}, \cw{\-\-help}
149
150\dd Display a message summarizing the available options.
151
2285d016 152\dt \cw{\-pgpfp}
153
154\dd Display the fingerprints of the PuTTY PGP Master Keys, to aid
155in verifying new files released by the PuTTY team.
156
e3e5784e 157\dt \cw{\-load} \e{session}
158
159\dd Load a saved session by name. This allows you to run a saved session
160straight from the command line without having to go through the
161configuration box first.
162
163\dt \cw{\-telnet}, \cw{\-rlogin}, \cw{\-raw}
164
165\dd Select the protocol \cw{puttytel} will use to make the connection.
166
167\dt \cw{\-l} \e{username}
168
169\dd Specify the username to use when logging in to the server.
170
171\dt \cw{\-P} \e{port}
172
173\dd Specify the port to connect to the server on.
174
175\S{puttytel-manpage-saved-sessions} SAVED SESSIONS
176
177Saved sessions are stored in a \cw{.putty/sessions} subdirectory in
178your home directory.
179
180\S{puttytel-manpage-more-information} MORE INFORMATION
181
182For more information on PuTTY and PuTTYtel, it's probably best to go
183and look at the manual on the web page:
184
185\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/}\cw{http://www.chiark.greenend.org.uk/~sgtatham/putty/}
186
187\S{puttytel-manpage-bugs} BUGS
188
189This man page isn't terribly complete.