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
 
-\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.)
@@ -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.
 
-\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.
@@ -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.
 
-\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.
@@ -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
-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
@@ -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.)
 
+\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
@@ -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
-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?
@@ -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
-/\u02C8{'}p\u028C{V}t\u026A{I}/.
+/\u02C8{'}p\u028C{V}ti/.