[elpa] externals/hyperbole 7e1675e 05/20: * README.md: Added menu images and screenshots for easy access.

[Robert Weiner]

branch: externals/hyperbole
commit 7e1675ed776202520ea17312477a424b90ba8c9c
Author: Bob Weiner <address@hidden>
Commit: Bob Weiner <address@hidden>

    * README.md: Added menu images and screenshots for easy access.
    
    * hui-mouse.el (action-key-eol-function, assist-key-eol-function): Added 
these 2
        options to control what the Action and Assist Keys do at the end of a 
line.
        Default behaviors remain as before but now one can set these to 
`complete'
        for example to mimic standard Emacs behavior at end of lines, rather 
than
        scrolling, if desired.
---
 ChangeLog          |   10 ++++++++++
 README.md          |   12 +++++++++++-
 hui-mouse.el       |   14 +++++++++++++-
 man/hyperbole.texi |    2 +-
 4 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 8f8cbd0..ec57656 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 -- Almost all changes listed herein are new as of 2016. --
 
+2016-07-29  Bob Weiner  <address@hidden>
+
+* hui-mouse.el (action-key-eol-function, assist-key-eol-function): Added these 
2
+    options to control what the Action and Assist Keys do at the end of a line.
+    Default behaviors remain as before but now one can set these to `complete'
+    for example to mimic standard Emacs behavior at end of lines, rather than
+    scrolling, if desired.
+
+* README.md: Added menu images and screenshots for easy access.
+
 2016-07-28  Bob Weiner  <address@hidden>
 
 * hyperbole.el: Updated the header fields to better match GNU standards for use
diff --git a/README.md b/README.md
index b0b38ff..1c073bf 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@
 `Hyperbole`, is an efficient and programmable hypertextual information
 management system implemented as a GNU Emacs package.  It works well
 on GNU Emacs 24.4 or above.  It is designed and written by Bob Weiner.
-It's main distribution site is: <https://www.gnu.org/software/hyperbole/>.
+Its main distribution site is: <https://www.gnu.org/software/hyperbole/>.
 
 It includes easy-to-use, powerful hypertextual button types without
 the need to learn a markup language; a hierarchical, record-based
@@ -37,6 +37,8 @@ World-Wide Web URLs, Info manuals, ftp archives, etc.
 The [Hyperbole wiki page](https://www.emacswiki.org/emacs/Hyperbole)
 explains the many ways it differs from and is complementary to Org mode.
 
+![Hyperbole screenshot of the Koutliner, DEMO file and 
HyRolo](man/im/hyperbole-cv.png)
+
 ## Installation
 
 Once you have Emacs set up at your site, GNU Hyperbole may be
@@ -83,6 +85,8 @@ You can invoke Hyperbole commands in one of three ways:
 
    use the Hyperbole menu on your menubar;
 
+   ![Hyperbole Menubar Menu](man/im/menu-hyperbole.png)
+
    type {C-h h} or {M-x hyperbole RET} to bring up the Hyperbole main menu
    in the minibuffer window, for fast keyboard or mouse-based selection;
    select an item from this menu by typing the item's first letter; use {q}
@@ -94,9 +98,13 @@ You can invoke Hyperbole commands in one of three ways:
 Use {C-h h d d} for an interactive demonstration of standard Hyperbole
 button capabilities.
 
+![Hyperbole screenshot of the DEMO](man/im/demo.png)
+
 {C-h h k e} offers a interactive demonstration of the Koutliner,
 Hyperbole's multi-level autonumbered hypertextual outliner.
 
+![Hyperbole screenshot of the Koutliner](man/im/koutliner.png)
+
 To try out HyControl, Hyperbole's interactive frame and window control
 system, use {C-h h s w} for window control or {C-h h s f} for frame
 control.  {t} switches between window and frame control once in one of
@@ -154,6 +162,8 @@ Hyperbole consists of five parts:
        has a menu interface, which may be operated from the keyboard or
        the mouse.
 
+          ![HyRolo Menubar Menu](man/im/menu-rolo.png)
+
    3.  **Screen Control**: the fastest, easiest-to-use window and frame
        control available for GNU Emacs.  With just a few keystrokes,
        you can shift from increasing a window's height by 5 lines
diff --git a/hui-mouse.el b/hui-mouse.el
index 8a2be04..2876eab 100644
--- a/hui-mouse.el
+++ b/hui-mouse.el
@@ -63,6 +63,18 @@ Set it to #'hkey-summarize if you want it to display a 
summary of Smart Key beha
   :type 'function
   :group 'hyperbole-keys)
 
+(defcustom action-key-eol-function #'smart-scroll-up
+  "*Function run by the Action Key at the end of a line.
+Set it to #'complete if you want behavior similar to that of standard Emacs."
+  :type 'function
+  :group 'hyperbole-keys)
+
+(defcustom assist-key-eol-function #'smart-scroll-down
+  "*Function run by the Assist Key at the end of a line.
+Set it to #'complete if you want behavior similar to that of standard Emacs."
+  :type 'function
+  :group 'hyperbole-keys)
+
 ;;; ************************************************************************
 ;;; Hyperbole context-sensitive keys dispatch table
 ;;; ************************************************************************
@@ -108,7 +120,7 @@ Set it to #'hkey-summarize if you want it to display a 
summary of Smart Key beha
     ((if (eq major-mode 'kotl-mode)
        (and (not (kotl-mode:eobp)) (kotl-mode:eolp))
       (and (not (eobp)) (or (eolp) (and selective-display (eq (following-char) 
?\r))))) .
-     ((smart-scroll-up) . (smart-scroll-down)))
+     ((funcall action-key-eol-function) . (funcall assist-key-eol-function)))
     ;;
     ;; The Smart Menu system provides menus within Emacs on a dumb terminal.
     ;; It is a part of InfoDock, but may also be obtained as a separate
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index 0e62a95..d04272f 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -200,7 +200,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 @end example
 
 @float Image,image:Sample
address@hidden Hyperbole screenshot of the Koutliner, the DEMO file and the 
Rolo}
address@hidden Hyperbole screenshot of the Koutliner, DEMO file and HyRolo}
 @center @image{im/hyperbole-cv,6in,,Sample Hyperbole Screenshot}
 @end float
 @sp 1