Updates for today's changes:

- changes to Logging panel
 - breaks in serial backend
(Plus, completely unrelated, an index term entry related to port forwarding
which seems to have been sitting around for ages, possibly waiting for me to
think about `see also' index terms in Halibut.)

[originally from svn r6836]

doc/config.but

@@ -147,19 +147,19 @@ The Logging configuration panel allows you to save \i{log file}s of your
 PuTTY sessions, for debugging, analysis or future reference.
 
 The main option is a radio-button set that specifies whether PuTTY
-will log anything at all. The options are
+will log anything at all. The options are:
 
-\b \q{Logging turned off completely}. This is the default option; in
+\b \q{None}. This is the default option; in this mode PuTTY will not
-this mode PuTTY will not create a log file at all.
+create a log file at all.
 
-\b \q{Log printable output only}. In this mode, a log file will be
+\b \q{Printable output}. In this mode, a log file will be
 created and written to, but only printable text will be saved into
 it. The various terminal control codes that are typically sent down
 an interactive session alongside the printable text will be omitted.
 This might be a useful mode if you want to read a log file in a text
 editor and hope to be able to make sense of it.
 
-\b \q{Log all session output}. In this mode, \e{everything} sent by
+\b \q{All session output}. In this mode, \e{everything} sent by
 the server into your terminal session is logged. If you view the log
 file in a text editor, therefore, you may well find it full of
 strange control characters. This is a particularly useful mode if
@@ -168,14 +168,21 @@ can record everything that went to the terminal, so that someone
 else can replay the session later in slow motion and watch to see
 what went wrong.
 
-\b \q{\i{Log SSH packet data}}. In this mode (which is only used by SSH
+\b \I{SSH packet log}\q{SSH packets}. In this mode (which is only used
-connections), the SSH message packets sent over the encrypted
+by SSH connections), the SSH message packets sent over the encrypted
-connection are written to the log file. You might need this to debug
+connection are written to the log file (as well as \i{Event Log}
-a network-level problem, or more likely to send to the PuTTY authors
+entries). You might need this to debug a network-level problem, or
-as part of a bug report. \e{BE WARNED} that if you log in using a
+more likely to send to the PuTTY authors as part of a bug report.
-password, the password can appear in the log file; see
+\e{BE WARNED} that if you log in using a password, the password can
-\k{config-logssh} for options that may help to remove sensitive
+appear in the log file; see \k{config-logssh} for options that may
-material from the log file before you send it to anyone else.
+help to remove sensitive material from the log file before you send it
+to anyone else.
+
+\b \q{SSH packets and raw data}. In this mode, as well as the
+decrypted packets (as in the previous mode), the \e{raw} (encrypted,
+compressed, etc) packets are \e{also} logged. This could be useful to
+diagnose corruption in transit. (The same caveats as the previous mode
+apply, of course.)
 
 \S{config-logfilename} \q{Log file name}
 
@@ -254,10 +261,11 @@ glean a lot of useful information from even these obfuscated logs
 
 \cfg{winhelp-topic}{logging.ssh.omitpassword}
 
-When checked, password fields are removed from the log of transmitted
+When checked, decrypted password fields are removed from the log of
-packets. (This includes any user responses to challenge-response
+transmitted packets. (This includes any user responses to
-authentication methods such as \q{keyboard-interactive}.) This does
+challenge-response authentication methods such as
-not include X11 authentication data if using X11 forwarding.
+\q{keyboard-interactive}.) This does not include X11 authentication
+data if using X11 forwarding.
 
 Note that this will only omit data that PuTTY \e{knows} to be a
 password. However, if you start another login session within your
@@ -271,10 +279,10 @@ This option is enabled by default.
 
 \cfg{winhelp-topic}{logging.ssh.omitdata}
 
-When checked, all \q{session data} is omitted; this is defined as data
+When checked, all decrypted \q{session data} is omitted; this is
-in terminal sessions and in forwarded channels (TCP, X11, and
+defined as data in terminal sessions and in forwarded channels (TCP,
-authentication agent). This will usually substantially reduce the size
+X11, and authentication agent). This will usually substantially reduce
-of the resulting log file.
+the size of the resulting log file.
 
 This option is disabled by default.
 
@@ -2675,11 +2683,12 @@ In place of port numbers, you can enter \i{service names}, if they are
 known to the local system. For instance, in the \q{Destination} box,
 you could enter \c{popserver.example.com:pop3}.
 
-You can modify the currently active set of port forwardings in
+You can \I{port forwarding, changing mid-session}modify the currently
-mid-session using \q{Change Settings} (see \k{using-changesettings}).
+active set of port forwardings in mid-session using \q{Change
-If you delete a local or dynamic port forwarding in mid-session, PuTTY
+Settings} (see \k{using-changesettings}). If you delete a local or
-will stop listening for connections on that port, so it can be re-used
+dynamic port forwarding in mid-session, PuTTY will stop listening for
-by another program. If you delete a remote port forwarding, note that:
+connections on that port, so it can be re-used by another program. If
+you delete a remote port forwarding, note that:
 
 \b The SSH-1 protocol contains no mechanism for asking the server to
 stop listening on a remote port.

doc/index.but

@@ -127,6 +127,12 @@ from SSH and Telnet
 \IM{port forwarding}{port forwardings} tunnelling using SSH
 \IM{port forwarding}{port forwardings} SSH tunnelling
 
+\IM{port forwarding, changing mid-session} port forwarding in SSH, changing mid-session
+\IM{port forwarding, changing mid-session} SSH port forwarding, changing mid-session
+\IM{port forwarding, changing mid-session} forwarding ports in SSH, changing mid-session
+\IM{port forwarding, changing mid-session} tunnelling using SSH, changing mid-session
+\IM{port forwarding, changing mid-session} SSH tunnelling, changing mid-session
+
 \IM{local port forwarding} local-to-remote port forwarding
 \IM{remote port forwarding} remote-to-local port forwarding
 
@@ -290,8 +296,8 @@ saved sessions from
 \IM{inactive window} window, inactive
 \IM{inactive window} terminal window, inactive
 
-\IM{Log SSH packet data} SSH packet log
+\IM{SSH packet log} SSH packet log
-\IM{Log SSH packet data} packet log, SSH
+\IM{SSH packet log} packet log, SSH
 
 \IM{auto wrap mode}{auto wrap} auto wrap mode
 \IM{auto wrap mode}{auto wrap} wrapping, automatic

doc/using.but

@@ -123,9 +123,10 @@ Event Log into your bug report.
 
 Depending on the protocol used for the current session, there may be
 a submenu of \q{special commands}. These are protocol-specific
-tokens, such as a \i{\q{break} signal}, that can be sent down a
+tokens, such as a \q{break} signal, that can be sent down a
 connection in addition to normal data. Their precise effect is usually
-up to the server. Currently only Telnet and SSH have special commands.
+up to the server. Currently only Telnet, SSH, and serial connections
+have special commands.
 
 The following \I{Telnet special commands}special commands are
 available in Telnet:
@@ -207,6 +208,9 @@ Only available in SSH-2, and only during a session. Sends various
 POSIX signals. Not honoured by all servers.
 }
 
+With a serial connection, the only available special command is
+\I{Break, serial special command}\q{Break}.
+
 \S2{using-newsession} Starting new sessions
 
 PuTTY's system menu provides some shortcut ways to start new