X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/putty/blobdiff_plain/006238cb5a88743545d9c7b97312563cbf8c7a56..11cd814b19dd4278d51ab15c14e81fb8ee96777c:/unix/pterm.1

diff --git a/unix/pterm.1 b/unix/pterm.1
index e08d033a..64d8a305 100644
--- a/unix/pterm.1
+++ b/unix/pterm.1
@@ -43,10 +43,10 @@ Chinese, Japanese and Korean text) displayed in the terminal.
 Specify the font to use for bold double-width characters (typically
 Chinese, Japanese and Korean text) Like \fI-fb\fP, this will be
 ignored unless the \fIBoldAsColour\fP resource is set to 0.
-.IP "\fB\-geometry\fP \fIwidth\fPx\fIheight\fP"
-Specify the size of the terminal, in rows and columns of text.
-Unfortunately \fIpterm\fP does not currently support specifying the
-initial position of the window.
+.IP "\fB\-geometry\fP \fIgeometry\fP"
+Specify the size of the terminal, in rows and columns of text. See
+\fIX(7)\fP for more information on the syntax of geometry
+specifications.
 .IP "\fB\-sl\fP \fIlines\fP"
 Specify the number of lines of scrollback to save off the top of the
 terminal.
@@ -68,7 +68,7 @@ Specify the foreground colour to use for text covered by the cursor.
 .IP "\fB\-cbg\fP \fIcolour\fP"
 Specify the background colour to use for text covered by the cursor.
 In other words, this is the main colour of the cursor.
-.IP "\fB\-T\fP \fItitle\fP"
+.IP "\fB\-title\fP \fItitle\fP"
 Specify the initial title of the terminal window. (This can be
 changed under control of the server.)
 .IP "\fB\-ut\-\fP or \fB+ut\fP"
@@ -110,6 +110,10 @@ supported by \fIpterm\fP) should be valid here (examples are
 encoding which is valid in an X logical font description should be
 valid ("ibm-cp437", for example).
 
+\fIpterm\fP's default behaviour is to use the same character
+encoding as its primary font. If you supply a Unicode (iso10646-1)
+font, it will default to the UTF-8 character set.
+
 Character set names are case-insensitive.
 .IP "\fB\-nethack\fP"
 Tells \fIpterm\fP to enable NetHack keypad mode, in which the
@@ -125,7 +129,7 @@ example:
 
 pterm \-xrm 'ScrollbarOnLeft: 1'
 .IP "\fB\-help\fP, \fB\-\-help\fP"
-Display a message summarizing the available options
+Display a message summarizing the available options.
 .SH X RESOURCES
 \fIpterm\fP can be more completely configured by means of X
 resources. All of these resources are of the form \fIpterm.FOO\fP
@@ -197,6 +201,22 @@ screen exactly the way they found it.
 This option should be set to either 0 or 1; the default is 0. When
 set to 1, it stops the server from remotely controlling the title of
 the \fIpterm\fP window.
+.IP "\fBpterm.NoRemoteQTitle\fP"
+This option should be set to either 0 or 1; the default is 1. When
+set to 1, it stops the server from remotely requesting the title of
+the \fIpterm\fP window.
+
+This feature is a \fBPOTENTIAL SECURITY HAZARD\fP. If a malicious
+application can write data to your terminal (for example, if you
+merely \fIcat\fP a file owned by someone else on the server
+machine), it can change your window title (unless you have disabled
+this using the \fBNoRemoteWinTitle\fP resource) and then use this
+service to have the new window title sent back to the server as if
+typed at the keyboard. This allows an attacker to fake keypresses
+and potentially cause your server-side applications to do things you
+didn't want. Therefore this feature is disabled by default, and we
+recommend you do not turn it on unless you \fBreally\fP know what
+you are doing.
 .IP "\fBpterm.NoDBackspace\fP"
 This option should be set to either 0 or 1; the default is 0. When
 set to 1, it disables the normal action of the Delete (^?) character
@@ -446,5 +466,3 @@ resource is equivalent to the \fI\-ls\fP command-line option.
 .SH BUGS
 Most of the X resources have silly names. (Historical reasons from
 PuTTY, mostly.)
-
-Character-set switching and Unicode are not yet supported.