commit 35abfa1b39e7f1c46332db435fe775baa9611313
from: Russ Cox <rsc@swtch.com>
date: Sun Jul 16 02:24:45 2017 UTC

man1: document mouse keystrokes in acme, sam, 9term

Change-Id: Id99ce9a143a21009d93a1c6ba2d1f84a3588649f
Reviewed-on: https://plan9port-review.googlesource.com/2942
Reviewed-by: Russ Cox <rsc@swtch.com>

commit - b15fd97627767291628309677c40b3f40b868497
commit + 35abfa1b39e7f1c46332db435fe775baa9611313
blob - acff6fe94e4ebbec7852c11b99d8a8c2fee0b3f6
blob + e0e5aad7172a5352b12c80a18712793875156984
--- man/man1/9term.1
+++ man/man1/9term.1
@@ -285,6 +285,17 @@ containing the selection (typing cursor).
 A typical use of this feature is to tell the editor to find the source of an error
 by plumbing the file and line information in a compiler's diagnostic.
 .PP
+For systems without a three-button mouse, the keyboard modifier
+keys can be used to modify the effect of the main mouse button.
+On Unix systems, the Control key changes the main button to button 2,
+and the Alt key changes it to button 3.
+On Mac systems, the Option key changes the main button to button 2,
+and the Command key changes it to button 3.
+Also on Mac systems, the usual keyboard shortcuts
+Command-C, -V, and -X invoke
+copy, paste, and cut,
+as in other programs.
+.PP
 Each
 .I 9term
 listens for connections on a Unix socket.
blob - aa02f770dcaf3004f41612037826e96f3d7092b1
blob + b3266595b8bb770f0611bf350db84807af748fbe
--- man/man1/acme.1
+++ man/man1/acme.1
@@ -645,6 +645,24 @@ environment variable
 .B $acmeaddr
 is created that holds, in the form interpreted by button 3,
 the fully-qualified address of the extra argument.
+.SS "Simulated buttons
+For systems without a three-button mouse, the keyboard modifier
+keys can be used to modify the effect of the main mouse button.
+On Unix systems, the Control key changes the main button to button 2,
+and the Alt key changes it to button 3.
+On Mac systems, the Option key changes the main button to button 2,
+and the Command key changes it to button 3.
+Pressing the key after the button is held down adds the button to form
+a chord, so that for example on Macs selecting text with the trackpad
+button and then typing Option without letting go of the button will
+cause a 1-2 chord, cutting the selection.
+On Mac systems, the usual keyboard shortcuts
+Command-C, -V, -X, and -Z invoke
+copy, paste, cut, and undo, 
+and Command-Shift-Z invokes redo,
+as in other programs.
+Especially on Mac laptops, these keyboard shortcuts are
+typically much less awkward than the equivalent chords.
 .SS "Support programs
 .I Win
 creates a new
blob - 1c9dd5f79ff19a9cd5e9a2123cd9499d0c788be7
blob + 460fd6d6d35e3254e8ec320531d1eb56277818d1
--- man/man1/sam.1
+++ man/man1/sam.1
@@ -821,6 +821,17 @@ dot is the null string, as if it were typed to the com
 Saves the sent text in the snarf buffer.
 (Command window only.) 
 .PD
+.SS Simulated buttons
+For systems without a three-button mouse, the keyboard modifier
+keys can be used to modify the effect of the main mouse button.
+On Unix systems, the Control key changes the main button to button 2,
+and the Alt key changes it to button 3.
+On Mac systems, the Option key changes the main button to button 2,
+and the Command key changes it to button 3.
+Also on Mac systems, the usual keyboard shortcuts
+Command-C, -V, and -X invoke
+copy, paste, and cut,
+as in other programs.
 .SS External communication
 .I Sam
 listens to the