Protect against multiple Change Settings dialogues. We should probably also

[u/mdw/putty] / doc / config.but

diff --git a/doc/config.but b/doc/config.but
index 3566d5d..7dbe04d 100644 (file)
--- a/doc/config.but
+++ b/doc/config.but
@@ -53,10 +53,12 @@ you want them saved. Then come back to the Session panel. Select the
 \q{Default Settings} entry in the saved sessions list, with a single
 click. Then press the \q{Save} button.
 
 \q{Default Settings} entry in the saved sessions list, with a single
 click. Then press the \q{Save} button.
 

+\lcont{

 Note that PuTTY does not allow you to save a host name into the
 Default Settings entry. This ensures that when PuTTY is started up,
 the host name box is always empty, so a user can always just type in
 a host name and connect.
 Note that PuTTY does not allow you to save a host name into the
 Default Settings entry. This ensures that when PuTTY is started up,
 the host name box is always empty, so a user can always just type in
 a host name and connect.

+}

 
 If there is a specific host you want to store the details of how to
 connect to, you should create a saved session, which will be
 
 If there is a specific host you want to store the details of how to
 connect to, you should create a saved session, which will be


@@ -69,6 +71,14 @@ Sessions} input box. (The server name is often a good choice for a
 saved session name.) Then press the \q{Save} button. Your saved
 session name should now appear in the list box.
 
 saved session name.) Then press the \q{Save} button. Your saved
 session name should now appear in the list box.
 

+\lcont{
+You can also save settings in mid-session, from the \q{Change Settings}
+dialog. Settings changed since the start of the session will be saved
+with their current values; as well as settings changed through the
+dialog, this includes changes in window size, window title changes
+sent by the server, and so on.
+}
+

 \b To reload a saved session: single-click to select the session
 name in the list box, and then press the \q{Load} button. Your saved
 settings should all appear in the configuration panel.
 \b To reload a saved session: single-click to select the session
 name in the list box, and then press the \q{Load} button. Your saved
 settings should all appear in the configuration panel.


@@ -76,7 +86,7 @@ settings should all appear in the configuration panel.
 \b To modify a saved session: first load it as described above. Then
 make the changes you want. Come back to the Session panel, and press
 the \q{Save} button. The new settings will be saved over the top of
 \b To modify a saved session: first load it as described above. Then
 make the changes you want. Come back to the Session panel, and press
 the \q{Save} button. The new settings will be saved over the top of

-the old ones
+the old ones.

 
 \lcont{
 To save the new settings under a different name, you can enter the new
 
 \lcont{
 To save the new settings under a different name, you can enter the new


@@ -1568,7 +1578,7 @@ will be slightly more efficient; with it disabled, you may find you
 get a faster response to your keystrokes when connecting to some
 types of server.
 
 get a faster response to your keystrokes when connecting to some
 types of server.
 

-The Nagle algorithm is disabled by default.
+The Nagle algorithm is disabled by default for interactive connections.

 
 \S{config-tcp-keepalives} \q{Enable TCP keepalives}
 
 
 \S{config-tcp-keepalives} \q{Enable TCP keepalives}
 


@@ -1590,7 +1600,7 @@ typically two hours; this is set by the operating system, and cannot
 be configured within PuTTY.
 
 \b If the operating system does not receive a response to a keepalive,
 be configured within PuTTY.
 
 \b If the operating system does not receive a response to a keepalive,

-it may send out more in quick succession and if terminate the connection
+it may send out more in quick succession and terminate the connection

 if no response is received.
 
 TCP keepalives may be more useful for ensuring that half-open connections
 if no response is received.
 
 TCP keepalives may be more useful for ensuring that half-open connections


@@ -1619,7 +1629,7 @@ explicitly set this to \q{IPv4} or \q{IPv6}.
 The Data panel allows you to configure various pieces of data which
 can be sent to the server to affect your connection at the far end.
 
 The Data panel allows you to configure various pieces of data which
 can be sent to the server to affect your connection at the far end.
 

-Each options on this panel applies to more than one protocol.
+Each option on this panel applies to more than one protocol.

 Options which apply to only one protocol appear on that protocol's
 configuration panels.
 
 Options which apply to only one protocol appear on that protocol's
 configuration panels.
 


@@ -2326,7 +2336,9 @@ This box is where you enter the name of your private key file if you
 are using public key authentication. See \k{pubkey} for information
 about public key authentication in SSH.
 
 are using public key authentication. See \k{pubkey} for information
 about public key authentication in SSH.
 

-This key must be in PuTTY's native format (\c{*.PPK}).
+This key must be in PuTTY's native format (\c{*.PPK}). If you have a
+private key in another format that you want to use with PuTTY, see
+\k{puttygen-conversions}.

 
 \H{config-ssh-x11} The X11 panel
 
 
 \H{config-ssh-x11} The X11 panel
 


@@ -2342,7 +2354,7 @@ a local X display on your PC.
 To enable X11 forwarding, check the \q{Enable X11 forwarding} box.
 If your X display is somewhere unusual, you will need to enter its
 location in the \q{X display location} box; if this is left blank,
 To enable X11 forwarding, check the \q{Enable X11 forwarding} box.
 If your X display is somewhere unusual, you will need to enter its
 location in the \q{X display location} box; if this is left blank,

-PuTTY try to find a sensible default in the environment, or use the
+PuTTY will try to find a sensible default in the environment, or use the

 primary local display (\c{:0}) if that fails.
 
 See \k{using-x-forwarding} for more information about X11
 primary local display (\c{:0}) if that fails.
 
 See \k{using-x-forwarding} for more information about X11