Mention relationship between terminal types, keyboard sequences, and

[sgt/putty] / doc / faq.but

diff --git a/doc/faq.but b/doc/faq.but
index 3bdd5cd..abb4490 100644 (file)
--- a/doc/faq.but
+++ b/doc/faq.but
@@ -438,7 +438,7 @@ To run a PuTTY session saved under the name \q{\cw{mysession}},
 create a Windows shortcut that invokes PuTTY with a command line
 like
 
 create a Windows shortcut that invokes PuTTY with a command line
 like
 

-\c \path\name\to\putty.exe -load mysession
+\c \path\name\to\putty.exe -load "mysession"

 
 (Note: prior to 0.53, the syntax was \c{@session}. This is now
 deprecated and may be removed at some point.)
 
 (Note: prior to 0.53, the syntax was \c{@session}. This is now
 deprecated and may be removed at some point.)


@@ -779,8 +779,8 @@ your terminal runs the risk of sending the same control sequence by
 accident, and cause unexpected changes in the window title. Don't do
 it.
 
 accident, and cause unexpected changes in the window title. Don't do
 it.
 

-\S{faq-password-fails}{Question} My keyboard stops working once
-PuTTY displays the password prompt.
+\S{faq-password-fails}{Question} My \i{keyboard} stops working once
+PuTTY displays the \i{password prompt}.

 
 No, it doesn't. PuTTY just doesn't display the password you type, so
 that someone looking at your screen can't see what it is.
 
 No, it doesn't. PuTTY just doesn't display the password you type, so
 that someone looking at your screen can't see what it is.


@@ -790,8 +790,8 @@ as a row of asterisks either. This is so that someone looking at
 your screen can't even tell how \e{long} your password is, which
 might be valuable information.
 
 your screen can't even tell how \e{long} your password is, which
 might be valuable information.
 

-\S{faq-keyboard}{Question} One or more function keys don't do what I
-expected in a server-side application.
+\S{faq-keyboard}{Question} One or more \I{keyboard}\i{function keys}
+don't do what I expected in a server-side application.

 
 If you've already tried all the relevant options in the PuTTY
 Keyboard panel, you may need to mail the PuTTY maintainers and ask.
 
 If you've already tried all the relevant options in the PuTTY
 Keyboard panel, you may need to mail the PuTTY maintainers and ask.


@@ -812,8 +812,8 @@ application is expecting.
 The simplest way to investigate this is to find some other terminal
 environment, in which that function key \e{does} work; and then
 investigate what sequence the function key is sending in that
 The simplest way to investigate this is to find some other terminal
 environment, in which that function key \e{does} work; and then
 investigate what sequence the function key is sending in that

-situation. One reasonably easy way to do this on a Unix system is to
-type the command \c{cat}, and then press the function key. This is
+situation. One reasonably easy way to do this on a \i{Unix} system is to
+type the command \i\c{cat}, and then press the function key. This is

 likely to produce output of the form \c{^[[11~}. You can also do
 this in PuTTY, to find out what sequence the function key is
 producing in that. Then you can mail the PuTTY maintainers and tell
 likely to produce output of the form \c{^[[11~}. You can also do
 this in PuTTY, to find out what sequence the function key is
 producing in that. Then you can mail the PuTTY maintainers and tell


@@ -985,6 +985,17 @@ will be sacrificing security for this. (Falling back to SSH-1 would
 also remove the delays, but would lose a \e{lot} more security
 still. We do not recommend it.)
 
 also remove the delays, but would lose a \e{lot} more security
 still. We do not recommend it.)
 

+\S{faq-xpwontrun}{Question} PuTTY fails to start up.  Windows claims that
+\q{the application configuration is incorrect}.
+
+This is caused by a bug in certain versions of \i{Windows XP} which is
+triggered by PuTTY 0.58.  It can be avoided by installing
+Service Pack 2, by using a different version of PuTTY, or by installing
+a special \i{manifest file} alongside the PuTTY executable.
+The
+\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist/xp-wont-run}{\q{xp-wont-run}}
+entry in PuTTY's wishlist has more details.
+

 \H{faq-secure} Security questions
 
 \S{faq-publicpc}{Question} Is it safe for me to download PuTTY and
 \H{faq-secure} Security questions
 
 \S{faq-publicpc}{Question} Is it safe for me to download PuTTY and


@@ -1013,8 +1024,8 @@ leave. You can do that automatically, by running the command
 the currently logged-in user on \i{multi-user systems}.)
 
 If PuTTY was installed from the installer package, it will also
 the currently logged-in user on \i{multi-user systems}.)
 
 If PuTTY was installed from the installer package, it will also

-appear in \q{Add/Remove Programs}. Uninstallation does not currently
-remove the above-mentioned registry entries and file.
+appear in \q{Add/Remove Programs}. Older versions of the uninstaller
+do not remove the above-mentioned registry entries and file.

 
 \S{faq-dsa}{Question} How come PuTTY now supports \i{DSA}, when the
 website used to say how insecure it was?
 
 \S{faq-dsa}{Question} How come PuTTY now supports \i{DSA}, when the
 website used to say how insecure it was?


@@ -1220,4 +1231,4 @@ couldn't possibly comment on such allegations.
 \S{faq-pronounce}{Question} How do I pronounce \q{PuTTY}?
 
 Exactly like the English word \q{putty}, which we pronounce
 \S{faq-pronounce}{Question} How do I pronounce \q{PuTTY}?
 
 Exactly like the English word \q{putty}, which we pronounce

-/\u02C8{'}p\u028C{V}t\u026A{I}/.
+/\u02C8{'}p\u028C{V}ti/.