X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/putty/blobdiff_plain/9ec95c23db58dac88a48fae594ea978c148d1c61..22bf65b33160e1eae32fe06d1ee12b0738ffe523:/doc/config.but diff --git a/doc/config.but b/doc/config.but index 00e23c48..e48240c2 100644 --- a/doc/config.but +++ b/doc/config.but @@ -1,4 +1,4 @@ -\versionid $Id: config.but,v 1.65 2003/06/21 20:21:29 jacob Exp $ +\versionid $Id: config.but,v 1.74 2004/02/07 23:49:21 jacob Exp $ \C{config} Configuring PuTTY @@ -1091,9 +1091,10 @@ If you select \q{UTF-8} as a character set you can use this mode. Not all server-side applications will support it. If you need support for a numeric code page which is not listed in -the drop-down list, such as code page 866, then you should be able -to enter its name manually (\c{CP866} for example) in the list box -and get the right result. +the drop-down list, such as code page 866, then you can try entering +its name manually (\c{CP866} for example) in the list box. If the +underlying version of Windows has the appropriate translation table +installed, PuTTY will use it. \S{config-cyr} \q{Caps Lock acts as Cyrillic switch} @@ -1141,12 +1142,7 @@ You should use this option if none of the other options works. in Unicode. For good Unicode-supporting fonts this is probably the most reliable and functional option. -\H{config-selection} The Selection panel - -The Selection panel allows you to control the way copy and paste -work in the PuTTY window. - -\S{config-linedrawpaste} Controlling the pasting of line drawing +\S{config-linedrawpaste} Controlling copy and paste of line drawing characters \cfg{winhelp-topic}{selection.linedraw} @@ -1155,18 +1151,23 @@ By default, when you copy and paste a piece of the PuTTY screen that contains VT100 line and box drawing characters, PuTTY will paste them in the form they appear on the screen: either Unicode line drawing code points, or the \q{poor man's} line-drawing characters -\c{+}, \c{-} and \c{|}. The checkbox \q{Paste VT100 line drawing -chars as lqqqk} disables this feature, so line-drawing characters -will be pasted as the ASCII characters that were printed to produce -them. This will typically mean they come out mostly as \c{q} and -\c{x}, with a scattering of \c{jklmntuvw} at the corners. This might -be useful if you were trying to recreate the same box layout in -another program, for example. +\c{+}, \c{-} and \c{|}. The checkbox \q{Copy and paste VT100 line +drawing chars as lqqqk} disables this feature, so line-drawing +characters will be pasted as the ASCII characters that were printed +to produce them. This will typically mean they come out mostly as +\c{q} and \c{x}, with a scattering of \c{jklmntuvw} at the corners. +This might be useful if you were trying to recreate the same box +layout in another program, for example. Note that this option only applies to line-drawing characters which \e{were} printed by using the VT100 mechanism. Line-drawing characters displayed using Unicode will paste as Unicode always. +\H{config-selection} The Selection panel + +The Selection panel allows you to control the way copy and paste +work in the PuTTY window. + \S{config-rtfpaste} Pasting in Rich Text Format \cfg{winhelp-topic}{selection.rtf} @@ -1186,19 +1187,25 @@ disabled. \cfg{winhelp-topic}{selection.buttons} -PuTTY's copy and paste mechanism is modelled on the Unix \c{xterm} -application. The X Window System uses a three-button mouse, and the -convention is that the left button selects, the right button extends -an existing selection, and the middle button pastes. +PuTTY's copy and paste mechanism is by default modelled on the Unix +\c{xterm} application. The X Window System uses a three-button mouse, +and the convention is that the left button selects, the right button +extends an existing selection, and the middle button pastes. -Windows typically only has two mouse buttons, so in PuTTY's default -configuration, the \e{right} button pastes, and the \e{middle} -button (if you have one) extends a selection. +Windows often only has two mouse buttons, so in PuTTY's default +configuration (\q{Compromise}), the \e{right} button pastes, and the +\e{middle} button (if you have one) extends a selection. If you have a three-button mouse and you are already used to the \c{xterm} arrangement, you can select it using the \q{Action of mouse buttons} control. +Alternatively, with the \q{Windows} option selected, the middle +button extends, and the right button brings up a context menu (on +which one of the options is \q{Paste}). (This context menu is always +available by holding down Ctrl and right-clicking, regardless of the +setting of this option.) + \S{config-mouseshift} \q{Shift overrides application's use of mouse} \cfg{winhelp-topic}{selection.shiftdrag} @@ -1315,6 +1322,18 @@ If you are not getting the colours you ask for on an 8-bit display, you can try enabling this option. However, be warned that it's never worked very well. +\S{config-syscolour} \q{Use system colours} + +\cfg{winhelp-topic}{colours.system} + +Enabling this option will cause PuTTY to ignore the configured colours +for \q{Default Background/Foreground} and \q{Cursor Colour/Text} (see +\k{config-colourcfg}), instead going with the system-wide defaults. + +Note that non-bold and bold text will be the same colour if this +option is enabled. You might want to change to indicating bold text +by font changes (see \k{config-boldcolour}). + \S{config-colourcfg} Adjusting the colours in the terminal window \cfg{winhelp-topic}{colours.config} @@ -1835,12 +1854,12 @@ separate configuration of the preference orders. As a result you may get two warnings similar to the one above, possibly with different encryptions. -Single-DES is not supported natively in the SSH 2 draft protocol -standards. One or two server implementations do support it, by a -non-standard name. PuTTY can use single-DES to interoperate with -these servers if you enable the \q{Enable non-standard single-DES in +Single-DES is not recommended in the SSH 2 draft protocol +standards, but one or two server implementations do support it. +PuTTY can use single-DES to interoperate with +these servers if you enable the \q{Enable legacy use of single-DES in SSH 2} option; by default this is disabled and PuTTY will stick to -the standard. +recommended ciphers. \H{config-ssh-auth} The Auth panel @@ -2012,7 +2031,7 @@ To add a port forwarding: on whether you want to forward a local port to a remote destination (\q{Local}) or forward a remote port to a local destination (\q{Remote}). Alternatively, select \q{Dynamic} if you want PuTTY to -provide a local SOCKS proxy on a local port. +provide a local SOCKS 4/4A/5 proxy on a local port. \b Enter a source port number into the \q{Source port} box. For local forwardings, PuTTY will listen on this port of your PC. For @@ -2034,17 +2053,9 @@ To remove a port forwarding, simply select its details in the list box, and click the \q{Remove} button. In the \q{Source port} box, you can also optionally enter an IP -address to listen on. Typically a Windows machine can be asked to -listen on any single IP address in the \cw{127.*.*.*} range, and all -of these are loopback addresses available only to the local machine. -So if you forward (for example) \c{127.0.0.5:79} to a remote -machine's \cw{finger} port, then you should be able to run commands -such as \c{finger fred@127.0.0.5}. This can be useful if the program -connecting to the forwarded port doesn't allow you to change the -port number it uses. This feature is available for local-to-remote -forwarded ports; SSH1 is unable to support it for remote-to-local -ports, while SSH2 can support it in theory but servers will not -necessarily cooperate. +address to listen on, by specifying (for instance) \c{127.0.0.5:79}. +See \k{using-port-forwarding} for more information on how this +works and its restrictions. \S{config-ssh-portfwd-localhost} Controlling the visibility of forwarded ports @@ -2259,7 +2270,7 @@ line options, so it's all automatic. Here is what you need in \c regedit /s putty.reg \c regedit /s puttyrnd.reg \c start /w putty.exe -\c regedit /e puttynew.reg HKEY_CURRENT_USER\Software\SimonTatham\PuTTY +\c regedit /ea puttynew.reg HKEY_CURRENT_USER\Software\SimonTatham\PuTTY \c copy puttynew.reg putty.reg \c del puttynew.reg \c regedit /s puttydel.reg