From 35abfa1b39e7f1c46332db435fe775baa9611313 Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Sat, 15 Jul 2017 20:23:49 -0600 Subject: man1: document mouse keystrokes in acme, sam, 9term Change-Id: Id99ce9a143a21009d93a1c6ba2d1f84a3588649f Reviewed-on: https://plan9port-review.googlesource.com/2942 Reviewed-by: Russ Cox --- man/man1/9term.1 | 11 +++++++++++ man/man1/acme.1 | 18 ++++++++++++++++++ man/man1/sam.1 | 11 +++++++++++ 3 files changed, 40 insertions(+) diff --git a/man/man1/9term.1 b/man/man1/9term.1 index acff6fe9..e0e5aad7 100644 --- a/man/man1/9term.1 +++ b/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. diff --git a/man/man1/acme.1 b/man/man1/acme.1 index aa02f770..b3266595 100644 --- a/man/man1/acme.1 +++ b/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 diff --git a/man/man1/sam.1 b/man/man1/sam.1 index 1c9dd5f7..460fd6d6 100644 --- a/man/man1/sam.1 +++ b/man/man1/sam.1 @@ -821,6 +821,17 @@ dot is the null string, as if it were typed to the command window. 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 -- cgit v1.2.3