Rework copy/paste documentation a bit.

Try harder to distinguish PuTTY's behaviour when run on Windows and on
Unix.
This commit is contained in:
Jacob Nevins 2019-03-24 13:28:29 +00:00
Родитель a956da6e5b
Коммит 190761a272
1 изменённых файлов: 27 добавлений и 20 удалений

Просмотреть файл

@ -1431,14 +1431,15 @@ work in the PuTTY window.
PuTTY's copy and paste mechanism is by default modelled on the Unix PuTTY's copy and paste mechanism is by default modelled on the Unix
\i\c{xterm} application. The X Window System uses a three-button mouse, \i\c{xterm} application. The X Window System uses a three-button mouse,
and the convention is that the \i{left button} \I{selecting text}selects, and the convention in that system is that the \i{left button}
the \i{right button} extends an existing selection, and the \I{selecting text}selects, the \i{right button} extends an existing
\i{middle button} pastes. selection, and the \i{middle button} pastes.
Windows often only has two mouse buttons, so in PuTTY's default Windows often only has two mouse buttons, so when run on Windows,
configuration (\q{Compromise}), the \e{right} button pastes, and the PuTTY is configurable. In PuTTY's default configuration
\e{middle} button (if you have one) \I{adjusting a selection}extends (\q{Compromise}), the \e{right} button pastes, and the \e{middle}
a selection. button (if you have one) \I{adjusting a selection}extends a
selection.
If you have a \i{three-button mouse} and you are already used to the If you have a \i{three-button mouse} and you are already used to the
\c{xterm} arrangement, you can select it using the \q{Action of \c{xterm} arrangement, you can select it using the \q{Action of
@ -1450,6 +1451,9 @@ which one of the options is \q{Paste}). (This context menu is always
available by holding down Ctrl and right-clicking, regardless of the available by holding down Ctrl and right-clicking, regardless of the
setting of this option.) setting of this option.)
(When PuTTY iself is running on Unix, it follows the X Window System
convention.)
\S{config-mouseshift} \q{Shift overrides application's use of mouse} \S{config-mouseshift} \q{Shift overrides application's use of mouse}
\cfg{winhelp-topic}{selection.shiftdrag} \cfg{winhelp-topic}{selection.shiftdrag}
@ -1499,10 +1503,17 @@ you have to hold down Alt to get the \e{normal} behaviour.
Here you can configure which clipboard(s) are written or read by Here you can configure which clipboard(s) are written or read by
PuTTY's various copy and paste actions. PuTTY's various copy and paste actions.
Most platforms, including Windows, have a single system clipboard.
On these platforms, PuTTY provides a second clipboard-like facility by
permitting you to paste the text you last selected in \e{this window},
whether or not it is currently also in the system clipboard. This is
not enabled by default.
The X Window System (which underlies most Unix graphical interfaces) The X Window System (which underlies most Unix graphical interfaces)
provides multiple clipboards (or \q{\i{selections}}), and many provides multiple clipboards (or \q{\i{selections}}), and many
applications support more than one of them by a different user applications support more than one of them by a different user
interface mechanism. interface mechanism. When PuTTY itself is running on Unix, it has
more configurability relating to these selections.
The two most commonly used selections are called \cq{\i{PRIMARY}} and The two most commonly used selections are called \cq{\i{PRIMARY}} and
\cq{\I{CLIPBOARD selection}CLIPBOARD}; in applications supporting both, \cq{\I{CLIPBOARD selection}CLIPBOARD}; in applications supporting both,
@ -1512,12 +1523,6 @@ the usual behaviour is that \cw{PRIMARY} is used by mouse-only actions
is used by explicit Copy and Paste menu items or keypresses such as is used by explicit Copy and Paste menu items or keypresses such as
\i{Ctrl-C} and \i{Ctrl-V}. \i{Ctrl-C} and \i{Ctrl-V}.
On other platforms such as Windows, where there is a single system
clipboard, PuTTY provides a second clipboard-like facility by permitting
you to paste the text you last selected in \e{this window}, whether or
not it is currently also in the system clipboard. This is not enabled
by default.
\S2{config-selection-autocopy} \q{Auto-copy selected text} \S2{config-selection-autocopy} \q{Auto-copy selected text}
\cfg{winhelp-topic}{selection.autocopy} \cfg{winhelp-topic}{selection.autocopy}
@ -1530,8 +1535,9 @@ clipboard, without requiring a separate user interface action.
On X, the wording of this option is changed slightly so that On X, the wording of this option is changed slightly so that
\cq{CLIPBOARD} is mentioned in place of the \q{system clipboard}. Text \cq{CLIPBOARD} is mentioned in place of the \q{system clipboard}. Text
selected in the terminal window will \e{always} be automatically selected in the terminal window will \e{always} be automatically
placed in the \cw{PRIMARY} selection, but if you tick this box, it placed in the \cw{PRIMARY} selection, as is conventional, but if you
will \e{also} be placed in \cq{CLIPBOARD} at the same time. tick this box, it will \e{also} be placed in \cq{CLIPBOARD} at the
same time.
\S2{config-selection-clipactions} Choosing a clipboard for UI actions \S2{config-selection-clipactions} Choosing a clipboard for UI actions
@ -1545,10 +1551,11 @@ whichever mouse button (if any) is configured to paste (see
You can configure which of the available clipboards each of these You can configure which of the available clipboards each of these
actions pastes from (including turning the paste action off actions pastes from (including turning the paste action off
completely). On platforms with a single system clipboard, the completely). On platforms with a single system clipboard (such as
available options are to paste from that clipboard or to paste from Windows), the available options are to paste from that clipboard or
PuTTY's internal memory of the \i{last selected text} within that to paste from PuTTY's internal memory of the \i{last selected text}
window. On X, the standard options are \cw{CLIPBOARD} or \cw{PRIMARY}. within that window. On X, the standard options are \cw{CLIPBOARD} or
\cw{PRIMARY}.
(\cw{PRIMARY} is conceptually similar in that it \e{also} refers to (\cw{PRIMARY} is conceptually similar in that it \e{also} refers to
the last selected text \dash just across all applications instead of the last selected text \dash just across all applications instead of