emacs-elpa-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] externals/hyperbole 667ea76 1/2: Added keyboard 'throws' of items


From: Robert Weiner
Subject: [elpa] externals/hyperbole 667ea76 1/2: Added keyboard 'throws' of items for display in specific windows; fixed compilation error; released 7.0.2
Date: Thu, 23 Nov 2017 08:47:13 -0500 (EST)

branch: externals/hyperbole
commit 667ea76a88d8aacd32c6ddeca850146dc0be6076
Author: Bob Weiner <address@hidden>
Commit: Bob Weiner <address@hidden>

    Added keyboard 'throws' of items for display in specific windows; fixed 
compilation error; released 7.0.2
    
    * hversion.el: Released 7.0.2.
    
    * hui-window.el (hmouse-at-item-p): Added to test if on a draggable item.
    
    * hmouse-drv.el (hkey-throw): Added to throw a drag item to a specific 
window via the
        ace-window package and the key sequence {M-o t <window-id>}, leaving 
the original
        source window selected.
    * man/hyperbole.texi (Keyboard Drags): Added description of throwing an 
item.
    
    * hui-mouse.el: Fixed a compilation time problem with when hmouse-alist was 
defined.
    
    
==============================================================================
    V7.0.2 changes ^^^^:
    
==============================================================================
---
 Changes            |  17 ++++++++++++
 DEMO               |  17 ++++++------
 HY-ABOUT           |   2 +-
 HY-ANNOUNCE        |  75 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 HY-NEWS            |  17 ++++++++++--
 Makefile           |   2 +-
 README.md          |   2 +-
 README.md.html     |   2 +-
 hmouse-drv.el      |  26 ++++++++++++++++++-
 hui-mouse.el       |   6 ++++-
 hui-window.el      |  21 +++++++++------
 hversion.el        |   2 +-
 hyperbole-pkg.el   |   2 +-
 hyperbole.el       |   4 +--
 man/hyperbole.html |  38 +++++++++++++++++----------
 man/hyperbole.info | Bin 487474 -> 487960 bytes
 man/hyperbole.pdf  | Bin 1259831 -> 1260426 bytes
 man/hyperbole.texi |  32 +++++++++++++----------
 man/version.texi   |   6 ++---
 19 files changed, 214 insertions(+), 57 deletions(-)

diff --git a/Changes b/Changes
index 394b3be..47e574d 100644
--- a/Changes
+++ b/Changes
@@ -1,3 +1,20 @@
+2017-11-23  Bob Weiner  <address@hidden>
+
+* hversion.el: Released 7.0.2.
+
+* hui-window.el (hmouse-at-item-p): Added to test if on a draggable item.
+
+* hmouse-drv.el (hkey-throw): Added to throw a drag item to a specific window 
via the
+    ace-window package and the key sequence {M-o t <window-id>}, leaving the 
original
+    source window selected.
+* man/hyperbole.texi (Keyboard Drags): Added description of throwing an item.
+
+* hui-mouse.el: Fixed a compilation time problem with when hmouse-alist was 
defined.
+
+==============================================================================
+V7.0.2 changes ^^^^:
+==============================================================================
+
 2017-11-22  Bob Weiner  <address@hidden>
 
 * hversion.el: Released 7.0.1.
diff --git a/DEMO b/DEMO
index d0937c1..d39f2ab 100644
--- a/DEMO
+++ b/DEMO
@@ -1152,14 +1152,15 @@ made.  An Assist Key Drag will move the the item list 
buffer to the destination
 (swapping buffers), just as it does with other buffers.  Practice these drags 
as
 they will prove very beneficial across time.
 
-For even faster keyboard-based drag emulation, use the Emacs package
-'ace-window' (see "(hyperbole)Keyboard Drags" for setup).  Once this is
-configured, the leftmost character or two of each window's modeline will show
-the ID to type to use that window as the drag destination.  Then whenever point
-is on an item you want displayed in another window, use M-o i
-<id-of-window-to-display-item-in> and watch the magic happen.  You can also use
-this to create explicit button links to other window buffers when in an 
editable
-buffer.
+For even faster keyboard-based drag emulation, use the Emacs package 
'ace-window'
+(see "(hyperbole)Keyboard Drags" for setup).  Once this is configured, the
+leftmost character or two of each window's modeline will show the ID to type to
+use that window as the drag destination. Then whenever point is on an item you
+want displayed in another window, use M-o i <window-id> and watch the magic
+happen.  You can also use this to create explicit button links to other window
+buffers when in an editable buffer.  If you want to display multiple items in
+different windows, instead use the M-o t <window-id> key sequence to 
@emph{throw}
+the item to the window.
 
 *** Cloning Windows
 
diff --git a/HY-ABOUT b/HY-ABOUT
index cfd0c72..108ec33 100644
--- a/HY-ABOUT
+++ b/HY-ABOUT
@@ -3,7 +3,7 @@
                   Designed and Written by Bob Weiner
                Maintained by Mats Lidell and Bob Weiner
                 https://www.gnu.org/software/hyperbole/
-                            Version 7.0.1
+                            Version 7.0.2
 
 GNU Hyperbole (pronounced Ga-new Hi-per-bo-lee), or just Hyperbole, is
 an efficient and programmable hypertextual information management
diff --git a/HY-ANNOUNCE b/HY-ANNOUNCE
index 57dd3cc..7afa2a3 100644
--- a/HY-ANNOUNCE
+++ b/HY-ANNOUNCE
@@ -1,3 +1,78 @@
+----------------------------------------------------------------------
+7.0.2 Announcement
+----------------------------------------------------------------------
+From: Bob Weiner <address@hidden>
+To: address@hidden, address@hidden, address@hidden, address@hidden, 
address@hidden
+Subject: GNU Hyperbole 7.0.1-7.0.2 is now available
+Date: Wed, 23 Nov 2017
+--text follows this line--
+This is a minor release with a number of small issues resolved and the 
following
+new features:
+
+  SMART (ACTION AND ASSIST) KEYS
+
+    - Keyboard Drags: Keyboard emulation of many Smart Mouse Key drag actions.
+      See "(hyperbole)Keyboard Drags".
+  
+    - Keyboard Help: When {M-o} is bound to the `hkey-operate' command to
+      emulate drag depress and release events, then when in the release window
+      prior to pressing the second {M-o}, {C-h A} now reports the drag
+      action associated with the current release point.  See "(hyperbole)C-h 
A".
+
+    - Ace Window: Integrated Hyperbole item drag and link creation with this
+      package's direct window selection.  Use {M-o i <window-id>}.
+      You typically can display any Dired or Buffer Menu item in any window
+      with a single 3 keystroke command!
+
+      Also added the ability to 'throw' an item to a window while leaving the
+      selected window the same.  Use {M-o t <window-id>}.  This
+      works in Dired, Buffer Menu, iBuffer Menu and Treemacs modes and lets
+      you throw multiple items to multiple windows quickly.
+
+      See "(hyperbole)Keyboard Drags" for setup and use instructions.
+
+    - Smart Treemacs: Smart Key and item drag support for the Treemacs package.
+      See "(hyperbole)Smart Key - Treemacs".
+
+  HYROLO
+
+    - Fixed Google Contacts support to prompt for authorization only during
+      first time use.
+
+-----
+
+For details on what Hyperbole is and how to obtain and install it, see:
+
+  https://www.gnu.org/s/hyperbole
+
+For a list of use cases, see:
+
+  https://www.gnu.org/s/hyperbole/HY-WHY.html
+
+For a full list of new features in Hyperbole 7, see:
+
+  https://git.savannah.gnu.org/cgit/hyperbole.git/plain/HY-NEWS
+
+For what users think about Hyperbole, see:
+
+  https://www.gnu.org/s/hyperbole/hyperbole.html#user-quotes
+
+Bob Weiner designed and wrote GNU Hyperbole.  He and Mats
+Lidell maintain it with the Free Software Foundation.  It includes
+an interactive demo to introduce you to its features as well as a
+detailed reference manual, as explained here:
+
+  https://www.gnu.org/s/hyperbole/hyperbole.html#invocation-and-doc
+
+
+Happy Thanksgiving,
+
+Bob Weiner and Mats Lidell
+
+
+----------------------------------------------------------------------
+7.0.0 Announcement
+----------------------------------------------------------------------
 To: address@hidden, address@hidden, address@hidden, address@hidden, 
address@hidden
 ANNOUNCE: GNU Hyperbole 7, a.k.a the Git Ready for Action Release, is now 
available
 
diff --git a/HY-NEWS b/HY-NEWS
index 1e4284c..2c9ef33 100644
--- a/HY-NEWS
+++ b/HY-NEWS
@@ -2,6 +2,16 @@
                                 by Bob Weiner
 
 ===========================================================================
+*                                   V7.0.2
+===========================================================================
+
+    - Ace Window: Added the ability to 'throw' an item to a window while
+      leaving the selected window the same.  Use {M-o t <window-id>}.  This
+      works in Dired, Buffer Menu, iBuffer Menu and Treemacs modes and lets
+      you throw multiple items to multiple windows quickly.  See
+      "(hyperbole)Keyboard Drags" for setup and use instructions.
+
+===========================================================================
 *                                   V7.0.1
 ===========================================================================
 
@@ -12,14 +22,17 @@
   
     - Keyboard Help: When {M-o} is bound to the `hkey-operate' command to
       emulate drag depress and release events; when in the release window
-      prior to pressing the second {M-o}, the {C-h A} now reports the drag
+      prior to pressing the second {M-o}, {C-h A} now reports the drag
       action associated with the current release point.  See "(hyperbole)C-h 
A".
 
     - Smart Treemacs: Smart Key and item drag support for the Treemacs package.
       See "(hyperbole)Smart Key - Treemacs".
 
     - Ace Window: Integrated Hyperbole item drag and link creation with this
-      package's direct window selection.  See "(hyperbole)Keyboard Drags".
+      package's direct window selection.  Use {M-o i <window-id>}.
+      You typically can display any Dired or Buffer Menu item in any window
+      with a single 3 keystroke command!  See "(hyperbole)Keyboard Drags"
+      for setup and use instructions.
 
   HYROLO
 
diff --git a/Makefile b/Makefile
index 23c9546..c04dbd8 100644
--- a/Makefile
+++ b/Makefile
@@ -54,7 +54,7 @@
 
 # This ver setup won't work under any make except GNU make, so set it manually.
 #HYPB_VERSION = "`head -3 hversion.el | tail -1 | sed -e 's/.*|\(.*\)|.*/\1/'`"
-HYPB_VERSION = 7.0.1
+HYPB_VERSION = 7.0.2
 
 # Emacs executable used to byte-compile .el files into .elc's.
 # Possibilities include: emacs, infodock, xemacs, etc.
diff --git a/README.md b/README.md
index 875c05b..e8ff739 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# GNU Hyperbole 7.0.1 - The Everyday Hypertextual Information Manager
+# GNU Hyperbole 7.0.2 - The Everyday Hypertextual Information Manager
 
 <!-- START doctoc generated TOC -->
 **Table of Contents**
diff --git a/README.md.html b/README.md.html
index 65c84f8..43867b3 100644
--- a/README.md.html
+++ b/README.md.html
@@ -1,5 +1,5 @@
 <h1>
-<a 
id="user-content-gnu-hyperbole-701---the-everyday-hypertextual-information-manager"
 class="anchor" 
href="#gnu-hyperbole-701---the-everyday-hypertextual-information-manager" 
aria-hidden="true"><span aria-hidden="true" class="octicon 
octicon-link"></span></a>GNU Hyperbole 7.0.1 - The Everyday Hypertextual 
Information Manager</h1>
+<a 
id="user-content-gnu-hyperbole-702---the-everyday-hypertextual-information-manager"
 class="anchor" 
href="#gnu-hyperbole-702---the-everyday-hypertextual-information-manager" 
aria-hidden="true"><span aria-hidden="true" class="octicon 
octicon-link"></span></a>GNU Hyperbole 7.0.2 - The Everyday Hypertextual 
Information Manager</h1>
 
 <p><strong>Table of Contents</strong></p>
 <ul>
diff --git a/hmouse-drv.el b/hmouse-drv.el
index 27d3fc5..318b62e 100644
--- a/hmouse-drv.el
+++ b/hmouse-drv.el
@@ -16,7 +16,10 @@
 ;;; Other required Elisp libraries
 ;;; ************************************************************************
 
-(eval-when-compile (require 'hui-window)) ;; for `hmouse-drag-item-to-display'
+(eval-when-compile 
+  (defvar hmouse-alist nil)
+  (require 'hui-window)
+  (makunbound 'hmouse-alist)) ;; for `hmouse-drag-item-to-display'
 (require 'hypb)
 
 ;; Quiet byte compiler warnings for these free variables.
@@ -364,6 +367,26 @@ Only works when running under a window system, not from a 
dumb terminal."
     ;; Leave hkey-drag to choose selected window
     (hkey-drag release-window)))
 
+;;;###autoload
+(defun hkey-throw (release-window)
+  "Emulate Smart Mouse Key drag from selected window to RELEASE-WINDOW.
+After the drag, the selected window remains the same as it was before
+the drag.
+
+Optional prefix ARG non-nil means emulate Assist Key rather than the
+Action Key.
+
+Only works when running under a window system, not from a dumb terminal."
+  (let ((start-win (selected-window)))
+    (condition-case nil
+       ;; This may trigger a No Action error if start-win and
+       ;; release-win are the same.
+       (hkey-drag release-window)
+      (error (when (eq start-win release-window)
+              (hmouse-drag-item-to-displ
+               ay))))
+    (when (window-live-p start-win) (select-window start-win))))
+
 (defun hkey-ace-window-setup (&optional key)
   "Bind optional keyboard KEY and setup display of items in windows specified 
by short ids.
 
@@ -391,6 +414,7 @@ magic happen."
   (require 'ace-window)
   (when key (global-set-key key 'ace-window))
   (push '(?i hkey-drag-to "Hyperbole Drag To") aw-dispatch-alist)
+  (push '(?t hkey-throw   "Hyperbole Throw") aw-dispatch-alist)
   (setq aw-keys '(?a ?s ?d ?f ?g ?h ?j ?k ?l)
        ;; allows {i} operation to work when only 2 windows exist
        aw-dispatch-always t)
diff --git a/hui-mouse.el b/hui-mouse.el
index 6944b44..000bbcc 100644
--- a/hui-mouse.el
+++ b/hui-mouse.el
@@ -375,7 +375,6 @@ Action and Assist Mouse Keys.")
 (autoload 'var:append "hvar" "Append to a list variable." nil)
 
 (require 'hargs)
-(require 'hmouse-key)
 (defvar hmouse-alist hkey-alist
   "Alist of predicates and form-conses for the Action and Assist Mouse Keys.
 When the Action Mouse Key or Assist Mouse Key is pressed, the first or second
@@ -385,6 +384,11 @@ evaluated.
 The `hkey-alist' variable is the subset of this alist used by the
 smart keyboard keys.")
 
+;; This must be required after hmouse-alist is defined since this will
+;; recursively require hmouse-drv which requires hui-window when being
+;; compiled and that library requires that hmouse-alist be defined.
+(require 'hmouse-key)
+
 ;; This next library adds drag actions to `hmouse-alist'.
 (load "hui-window")
 
diff --git a/hui-window.el b/hui-window.el
index 63a6fd5..1d3cbf4 100644
--- a/hui-window.el
+++ b/hui-window.el
@@ -246,6 +246,16 @@ drag release window.")
 ;;; Public functions
 ;;; ************************************************************************
 
+(defun hmouse-at-item-p ()
+  "Return t if point is on an item draggable by Hyperbole, otherwise nil."
+  (let* ((buf (and (window-live-p action-key-depress-window) (window-buffer 
action-key-depress-window)))
+        (mode (and buf (cdr (assq 'major-mode (buffer-local-variables buf))))))
+    (and buf (with-current-buffer buf
+              ;; Point must be on an item, not after one
+              (not (looking-at "\\s-*$")))
+        (memq mode (mapcar #'car hmouse-drag-item-mode-forms))
+        t)))
+
 (defun hmouse-context-menu ()
   "If running under a window system, display or hide the buffer menu.
 If not running under a window system and Smart Menus are loaded, display the
@@ -509,14 +519,9 @@ not on an item, then nil.
 
 See `hmouse-drag-item-mode-forms' for how to allow for draggable
 items in other modes."
-  (let* ((buf (and (window-live-p action-key-depress-window) (window-buffer 
action-key-depress-window)))
-        (mode (and buf (cdr (assq 'major-mode (buffer-local-variables buf))))))
-    (when (and buf (with-current-buffer buf
-                    ;; Point must be on an item, not after one
-                    (not (looking-at "\\s-*$")))
-              (memq mode (mapcar #'car hmouse-drag-item-mode-forms)))
-      (hmouse-item-to-window new-window)
-      t)))
+  (when (hmouse-at-item-p)
+    (hmouse-item-to-window new-window)
+    t))
 
 (defun hmouse-drag-diagonally ()
   "Returns non-nil iff last Action Key use was a diagonal drag within a single 
window.
diff --git a/hversion.el b/hversion.el
index 0110b88..d9dc4d2 100644
--- a/hversion.el
+++ b/hversion.el
@@ -23,7 +23,7 @@
 ;;; Public variables
 ;;; ************************************************************************
 
-(defconst hyperb:version "7.0.1" "GNU Hyperbole revision number.")
+(defconst hyperb:version "7.0.2" "GNU Hyperbole revision number.")
 
 ;;;###autoload
 (defvar hyperb:microcruft-os-p
diff --git a/hyperbole-pkg.el b/hyperbole-pkg.el
index b9e11e4..d31bf5b 100644
--- a/hyperbole-pkg.el
+++ b/hyperbole-pkg.el
@@ -1,5 +1,5 @@
 ;; -*- no-byte-compile: t -*-
-(define-package "hyperbole" "7.0.1" "GNU Hyperbole: The Everyday Hypertextual 
Information Manager"
+(define-package "hyperbole" "7.0.2" "GNU Hyperbole: The Everyday Hypertextual 
Information Manager"
   '((emacs "24.4"))
   :url "http://www.gnu.org/software/hyperbole";
   :keywords '("comm" "convenience" "files" "frames" "hypermedia" "languages"
diff --git a/hyperbole.el b/hyperbole.el
index 5834858..d8b4fbb 100644
--- a/hyperbole.el
+++ b/hyperbole.el
@@ -5,8 +5,8 @@
 ;; Author:           Bob Weiner
 ;; Maintainer:       Bob Weiner <address@hidden> and Mats Lidell 
<address@hidden>
 ;; Created:          06-Oct-92 at 11:52:51
-;; Released:         24-Oct-17
-;; Version:          7.0.1
+;; Released:         23-Nov-17
+;; Version:          7.0.2
 ;; Keywords:         comm, convenience, files, frames, hypermedia, languages, 
mail, matching, mouse, multimedia, outlines, tools, wp
 ;; Package:          hyperbole
 ;; Package-Requires: ((emacs "24.4"))
diff --git a/man/hyperbole.html b/man/hyperbole.html
index fffb0b2..951ce28 100644
--- a/man/hyperbole.html
+++ b/man/hyperbole.html
@@ -1,7 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
 <html>
 <!-- This manual is for GNU Hyperbole
-(Edition 7.0.1, Published November 21, 2017).
+(Edition 7.0.2, Published November 23, 2017).
 
 Copyright (C) 1989-2017  Free Software Foundation, Inc.
 
@@ -340,8 +340,8 @@ WITHOUT ANY WARRANTY, without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
 
 <PRE>
-Edition 7.0.1
-Printed November 21, 2017.
+Edition 7.0.2
+Printed November 23, 2017.
 
   Published by the Free Software Foundation, Inc.
   Author:    Bob Weiner
@@ -788,7 +788,7 @@ Next: <a href="#Smart-Keys" accesskey="n" rel="next">Smart 
Keys</a>, Previous: <
 <h2 class="chapter">1 Introduction</h2>
 
 <p>This edition of the GNU Hyperbole Manual is for use with any version
-7.0.1 or greater of GNU Hyperbole.  Hyperbole runs atop GNU Emacs 24.3
+7.0.2 or greater of GNU Hyperbole.  Hyperbole runs atop GNU Emacs 24.3
 or higher.  It will trigger an error if your Emacs is older.
 </p>
 <p>This chapter summarizes the structure of the rest of the manual,
@@ -1970,7 +1970,7 @@ release.  Drag outside Emacs and it will be displayed in 
a new frame.  To
 display the last item you want, press the Action Key on it and it will display
 within the listing window itself.  (If you use the Treemacs file viewer 
package,
 item dragging works there as well).  Remember that you can emulate these drags
-from the keyboard when needed, see <a href="#Smart-Mouse-Key-Drags">Smart 
Mouse Key Drags</a>.
+from the keyboard when needed, see <a href="#Keyboard-Drags">Keyboard 
Drags</a>.
 </p>
 <p>So now you can put a bunch of buffers and files on your screen wherever
 you like.  Typically, a brief visual pulse is shown first at the source item 
and
@@ -2010,16 +2010,14 @@ session since drag actions are not supported without a 
window system.
 <a name="index-window-by-letter"></a>
 <a name="index-jump-to-window-by-letter"></a>
 <a name="index-keyboard_002c-jump-to-window"></a>
-<p>For even faster keyboard-based drag emulation, use the Emacs
+<p>For even faster keyboard-based display of items, use the Emacs
 package <code>ace-window</code> (see <a 
href="https://elpa.gnu.org/packages/ace-window.html";>https://elpa.gnu.org/packages/ace-window.html</a>).
 </p>
 <p>The ace-window package assigns short letter IDs to each Emacs window and 
lets
 you jump to or operate upon a specific window by giving its ID.  Hyperbole can
-add an operation to ace-window that replaces the two-step drag emulation key
-described above with a single key sequence that jumps directly to the
-destination window desired.  This is most useful when working with dired or
-buffer menu <em>items</em>, so the drag operation uses the {i} key
-within <code>ace-window</code>.
+add commands to ace-window that replace the two-step drag emulation key
+described above with a single key sequence that displays dired or
+buffer menu <em>items</em>.
 </p>
 <p>To enable this feature, in your Emacs initialization file after
 Hyperbole is initialized, if you do not have a key bound for
@@ -2029,12 +2027,20 @@ a key: <code>(hkey-ace-window-setup)</code>.
 </p>
 <a name="index-link-creation-from-keyboard"></a>
 <a name="index-keyboard-link-creation"></a>
+<a name="index-M_002do-i-_003cwindow_002did_003e"></a>
+<a name="index-M_002do-t-_003cwindow_002did_003e"></a>
+<a name="index-drag-item"></a>
+<a name="index-throw-item"></a>
+<a name="index-item-drag"></a>
+<a name="index-item-throw"></a>
 <p>After setup, the leftmost character or two of each window&rsquo;s modeline 
will show
 the ID to type to use that window as the drag destination.  Then whenever point
 is on an item you want displayed in another window, use <kbd>{M-o i
 &lt;id-of-window-to-display-item-in&gt;}</kbd> and watch the magic happen.  
You can also use
-this to create explicit button links to other window buffers when in an 
editable
-buffer.
+this command to create explicit button links to other window buffers when in 
an editable
+buffer rather than on an item.  If you want to display multiple items in 
different
+windows, instead use the <kbd>{M-o t 
&lt;id-of-window-to-display-item-in&gt;}</kbd> key sequence to
+<em>throw</em> the item to the window.
 </p>
 
 
@@ -11411,6 +11417,8 @@ Next: <a href="#Function" accesskey="n" 
rel="next">Function</a>, Previous: <a hr
 <tr><td></td><td valign="top"><a 
href="#index-M_002df"><code>M-f</code></a>:</td><td>&nbsp;</td><td 
valign="top"><a href="#Menus">Menus</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-M_002do"><code>M-o</code></a>:</td><td>&nbsp;</td><td 
valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-M_002do-1"><code>M-o</code></a>:</td><td>&nbsp;</td><td 
valign="top"><a href="#Global-Key-Bindings">Global Key Bindings</a></td></tr>
+<tr><td></td><td valign="top"><a 
href="#index-M_002do-i-_003cwindow_002did_003e"><code>M-o i 
&lt;window-id&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
+<tr><td></td><td valign="top"><a 
href="#index-M_002do-t-_003cwindow_002did_003e"><code>M-o t 
&lt;window-id&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-M_002dRET"><code>M-<span 
class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-M_002dRET-1"><code>M-<span 
class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Global-Key-Bindings">Global Key Bindings</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-M_002dx-kotl_002dmode_003ashow_002dsubtree"><code>M-x 
kotl-mode:show-subtree</code></a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
@@ -12511,6 +12519,7 @@ Previous: <a href="#Function" accesskey="p" 
rel="prev">Function</a>, Up: <a href
 <tr><td></td><td valign="top"><a 
href="#index-drag-1">drag</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Thing-Selection">Thing Selection</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-drag-2">drag</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited 
Things</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-drag-emulation">drag 
emulation</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-drag-item">drag 
item</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-drag_002c-buffer-menu-item">drag, buffer menu 
item</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer 
Items</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-drag_002c-buffer-swap">drag, 
buffer swap</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Swapping-Buffers">Swapping Buffers</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-drag_002c-clone-window">drag, 
clone window</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Cloning-Windows">Cloning Windows</a></td></tr>
@@ -12750,6 +12759,8 @@ Previous: <a href="#Function" accesskey="p" 
rel="prev">Function</a>, Up: <a href
 <tr><td></td><td valign="top"><a href="#index-invoking-Hyperbole">invoking 
Hyperbole</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Menus">Menus</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-isearch">isearch</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Invisible-Text-Searches">Invisible Text Searches</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-issue-tracking">issue 
tracking</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item-drag">item 
drag</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-item-throw">item 
throw</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
 <tr><td colspan="4"> <hr></td></tr>
 <tr><th><a name="Concept-Index_cp_letter-J">J</a></th><td></td><td></td></tr>
 <tr><td></td><td valign="top"><a href="#index-jump-menu">jump 
menu</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline 
Clicks</a></td></tr>
@@ -13185,6 +13196,7 @@ Previous: <a href="#Function" accesskey="p" 
rel="prev">Function</a>, Up: <a href
 <tr><td></td><td valign="top"><a 
href="#index-thing">thing</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Thing-Selection">Thing Selection</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-thing-1">thing</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited 
Things</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-things">things</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-throw-item">throw 
item</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
 <tr><td></td><td valign="top"><a 
href="#index-thumbnails">thumbnails</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image 
Thumbnails</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-toc-action-type">toc action 
type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action 
Types</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-toc-implicit-button-type">toc 
implicit button type</a>:</td><td>&nbsp;</td><td valign="top"><a 
href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
diff --git a/man/hyperbole.info b/man/hyperbole.info
index 1f4a847..8d541d6 100644
Binary files a/man/hyperbole.info and b/man/hyperbole.info differ
diff --git a/man/hyperbole.pdf b/man/hyperbole.pdf
index cc07b65..a4ca5b6 100644
Binary files a/man/hyperbole.pdf and b/man/hyperbole.pdf differ
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index cd7028d..86dc5da 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -151,8 +151,8 @@ WITHOUT ANY WARRANTY, without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
 
 <PRE>
-Edition 7.0.1
-Printed November 21, 2017.
+Edition 7.0.2
+Printed November 23, 2017.
 
   Published by the Free Software Foundation, Inc.
   Author:    Bob Weiner
@@ -176,7 +176,7 @@ Printed November 21, 2017.
 
 @center The Everyday Hypertextual Information Manager
 
address@hidden Edition 7.0.1, November 21, 2017.
address@hidden Edition 7.0.2, November 23, 2017.
 
 @sp 2
 @noindent
@@ -462,7 +462,7 @@ Smart Keyboard Keys
 @chapter Introduction
 
 This edition of the GNU Hyperbole Manual is for use with any version
-7.0.1 or greater of GNU Hyperbole.  Hyperbole runs atop GNU Emacs 24.3
+7.0.2 or greater of GNU Hyperbole.  Hyperbole runs atop GNU Emacs 24.3
 or higher.  It will trigger an error if your Emacs is older.
 
 This chapter summarizes the structure of the rest of the manual,
@@ -1416,7 +1416,7 @@ release.  Drag outside Emacs and it will be displayed in 
a new frame.  To
 display the last item you want, press the Action Key on it and it will display
 within the listing window itself.  (If you use the Treemacs file viewer 
package,
 item dragging works there as well).  Remember that you can emulate these drags
-from the keyboard when needed, @pxref{Smart Mouse Key Drags}.
+from the keyboard when needed, @pxref{Keyboard Drags}.
 
 So now you can put a bunch of buffers and files on your screen wherever
 you like.  Typically, a brief visual pulse is shown first at the source item 
and
@@ -1450,16 +1450,14 @@ session since drag actions are not supported without a 
window system.
 @cindex window by letter
 @cindex jump to window by letter
 @cindex keyboard, jump to window
-For even faster keyboard-based drag emulation, use the Emacs
+For even faster keyboard-based display of items, use the Emacs
 package @code{ace-window} (see 
@url{https://elpa.gnu.org/packages/ace-window.html}).
 
 The ace-window package assigns short letter IDs to each Emacs window and lets
 you jump to or operate upon a specific window by giving its ID.  Hyperbole can
-add an operation to ace-window that replaces the two-step drag emulation key
-described above with a single key sequence that jumps directly to the
-destination window desired.  This is most useful when working with dired or
-buffer menu @emph{items}, so the drag operation uses the @address@hidden key
-within @code{ace-window}.
+add commands to ace-window that replace the two-step drag emulation key
+described above with a single key sequence that displays dired or
+buffer menu @emph{items}.
 
 To enable this feature, in your Emacs initialization file after
 Hyperbole is initialized, if you do not have a key bound for
@@ -1469,12 +1467,20 @@ a key: @code{(hkey-ace-window-setup)}.
 
 @cindex link creation from keyboard
 @cindex keyboard link creation
address@hidden M-o i <window-id>
address@hidden M-o t <window-id>
address@hidden drag item
address@hidden throw item
address@hidden item drag
address@hidden item throw
 After setup, the leftmost character or two of each window's modeline will show
 the ID to type to use that window as the drag destination.  Then whenever point
 is on an item you want displayed in another window, use @bkbd{M-o i
 <id-of-window-to-display-item-in>} and watch the magic happen.  You can also 
use
-this to create explicit button links to other window buffers when in an 
editable
-buffer.
+this command to create explicit button links to other window buffers when in 
an editable
+buffer rather than on an item.  If you want to display multiple items in 
different
+windows, instead use the @bkbd{M-o t <id-of-window-to-display-item-in>} key 
sequence to
address@hidden the item to the window.
 
 @c -------
 
diff --git a/man/version.texi b/man/version.texi
index 2ff12f6..6b3f9c3 100644
--- a/man/version.texi
+++ b/man/version.texi
@@ -1,4 +1,4 @@
address@hidden UPDATED November 21, 2017
address@hidden UPDATED November 23, 2017
 @set UPDATED-MONTH Nov 2017
address@hidden EDITION 7.0.1
address@hidden VERSION 7.0.1
address@hidden EDITION 7.0.2
address@hidden VERSION 7.0.2



reply via email to

[Prev in Thread] Current Thread [Next in Thread]