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

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

[elpa] externals/hyperbole ce6fa24 41/53: Updated HY-NEWS with all new f


From: Robert Weiner
Subject: [elpa] externals/hyperbole ce6fa24 41/53: Updated HY-NEWS with all new features for next major release.
Date: Wed, 15 Nov 2017 22:47:07 -0500 (EST)

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

    Updated HY-NEWS with all new features for next major release.
    
    * HY-NEWS: Updated for next major release
    
    * man/hyperbole.texi (Button Colors): Added doc on 
hproperty:but-highlight-flag.
                         (Hook Variables): Added doc of: 
action-key-depress-hook, action-key-release-hook,
        assist-key-depress-hook and assist-key-release-hook.
    
    * hsettings.el (hproperty:but-highlight-flag): Added as a setting.
      hui-em-but.el (hproperty:but-highlight-p): Renamed to 
hproperty:but-highlight-flag.
                    (hproperty:but-emphasize-p): Renamed to 
hproperty:but-highlight-flag.
      hui-xe-but.el (hproperty:but-highlight-p): Renamed to 
hproperty:but-highlight-flag.
                    (hproperty:but-emphasize-p): Renamed to 
hproperty:but-highlight-flag.
---
 Changes            |  63 ++++++-----
 DEMO               |   4 +
 HY-NEWS            | 308 ++++++++++++++++++++++++++++++++++++++++++++++++++++-
 hsettings.el       |   8 +-
 hui-em-but.el      |  16 +--
 hui-xe-but.el      |  16 +--
 hyrolo.el          |   2 +-
 man/hyperbole.texi |  30 ++++--
 8 files changed, 393 insertions(+), 54 deletions(-)

diff --git a/Changes b/Changes
index 25a5a88..422a86b 100644
--- a/Changes
+++ b/Changes
@@ -1,10 +1,24 @@
+2017-11-02  Bob Weiner  <address@hidden>
+
+* HY-NEWS: Updated for next major release
+
+* man/hyperbole.texi (Button Colors): Added doc on 
hproperty:but-highlight-flag.
+                     (Hook Variables): Added doc of: action-key-depress-hook, 
action-key-release-hook,
+    assist-key-depress-hook and assist-key-release-hook.
+
+* hsettings.el (hproperty:but-highlight-flag): Added as a setting.
+  hui-em-but.el (hproperty:but-highlight-p): Renamed to 
hproperty:but-highlight-flag.
+                (hproperty:but-emphasize-p): Renamed to 
hproperty:but-highlight-flag.
+  hui-xe-but.el (hproperty:but-highlight-p): Renamed to 
hproperty:but-highlight-flag.
+                (hproperty:but-emphasize-p): Renamed to 
hproperty:but-highlight-flag.
+
 2017-11-01  Bob Weiner  <address@hidden>
 
 * hib-kbd.el (kbd-key:special-sequence-p): Added and used in implicit button 
type kbd-key and kbd-key:act.
              (kbd-key:key-and-arguments): Added to allow for key sequences 
with interactive arguments and
     added an example in DEMO.
 
-* hui-mini.el (hui:menus): 
+* hui-mini.el (hui:menus):
   hui-menu.el (hui-menu-key-bindings): Added Find Web and Jump Thing key 
binding change entries.
 
 * hyperbole.el (mouse-position-function): Added this setting to make 
mouse-position and mouse-pixel-position
@@ -49,12 +63,11 @@
     now.
                      (Searching and Summarizing): Renamed from Location.
 
-* hpath.el (hpath:remote-at-p): Fixed to return /ftp: pre-pended to ftp paths 
since Tramp requires it.
-
 * hibtypes.el (mail-address): Made lower priority than pathname so when an 
email-like address@hidden is part of a remote
     pathname, this won't trigger.
 
-* hpath.el (hpath:rfc): Prepended /ftp: to value so tramp recognizes it as a 
remote file path.
+* hpath.el (hpath:remote-at-p): Fixed to return /ftp: prepended to ftp paths 
since Tramp requires it.
+           (hpath:rfc): Prepended /ftp: to value so tramp recognizes it as a 
remote file path.
 
 * man/hyperbole.texi (Smart Mouse Key Modifiers):
   hmouse-mod.el: Disabled this feature since it conflicts with present Emacs 
bindings of Control- and Meta- mouse keys.
@@ -212,7 +225,7 @@
     windows specified by rows and columns (typically as prefix arg
     digits).  Each window shows a different buffer, if possible, with the
     by-major-mode command preferring buffers with the specified major mode.  
The hycontrol-split-windows
-    chooses the by-major-mode command when given a prefix arge of 0; 
otheriwse, the rows-column one.
+    chooses the by-major-mode command when given a prefix arg of 0; otheriwse, 
the rows-column one.
                (hycontrol-window-display-buffer, 
hycontrol-display-buffer-predicate-list)
                 hycontrol--invert-display-buffer-predicates): Added to support 
new commands.
                (require 'set): Added for set:create used in 
hycontrol-split-windows-by-major-mode.
@@ -301,7 +314,7 @@
                hycontrol--frames-prompt-format, 
hycontrol--windows-prompt-format,
                hycontrol-frames-pre-command-hook, 
hycontrol-windows-pre-command-hook,
                hycontrol-frames-mode-map, hycontrol-windows-mode-map, 
hycontrol-exit-mode): Added.
-              (hycontrol-prettify-event, hycontrol-handle-event): Removed. 
+              (hycontrol-prettify-event, hycontrol-handle-event): Removed.
 
               (hycontrol-frames, hycontrol-windows): Rewrote HyControl to use 
a frame-mode
    and window-mode transient keymap which allows for regular key bindings and 
eliminates
@@ -313,7 +326,7 @@
 2017-10-17  Bob Weiner  <address@hidden>
 
 * hycontrol.el (hycontrol-screen-offset-alist, hycontrol-set-screen-offsets,
-                hycontrol-display-screen-offsets): 
+                hycontrol-display-screen-offsets):
     Changed ordering of items to match Emacs window-edges and frame-edges.
                (hycontrol-fit-to-screen): Added and used to ensure resized and 
repositioned
     windows fit on the screen.
@@ -414,7 +427,7 @@
 
 * hui-menu.el (hui-menu-key-binding-item): Added.
 
-* hmouse-drv.el (hmouse-set-point): Fixed to return a posn object as a 
fallback, i.e. what 
+* hmouse-drv.el (hmouse-set-point): Fixed to return a posn object as a 
fallback, i.e. what
     event-start and event-end return; previously, had returned point as a 
marker in this case.
     Keyboard-based emulation of mouse drags via hkey-operate had been broken; 
this fixed it.
 * hui-window.el (hmouse-x-coord, hmouse-y-coord): Updated to accept a posn.
@@ -633,7 +646,7 @@
 
 * hbut.el (ebut:operate): Updated documentation to clarify that this modified 
button properties,
     notably its action's argument list.
-  hbut.el (hattr:copy, hattr:set): 
+  hbut.el (hattr:copy, hattr:set):
   hpath.el (hpath:substitute-var): Clarified documentation.
 
 * hui.el (hui:ebut-message): Added message for use when creating and modifying 
explicit buttons.
@@ -661,7 +674,7 @@
 
 * man/hyperbole.texi (Version): Updated to 6.0.2b and rebuilt output formats.
 
-* hycontrol.el (hycontrol-handle-event): 
+* hycontrol.el (hycontrol-handle-event):
                (hycontrol-prettify-event): Fixed to handle large integer code 
events, e.g. M-p.
 
 2017-09-30  Bob Weiner  <address@hidden>
@@ -775,8 +788,8 @@
     Improved doc.
 
 * hui-window.el (smart-coords-in-window-p, smart-window-of-coords,
-                 hmouse-inactive-minibuffer-p): 
-  hmouse-drv.el (hmouse-depress-inactive-minibuffer-p): 
+                 hmouse-inactive-minibuffer-p):
+  hmouse-drv.el (hmouse-depress-inactive-minibuffer-p):
   hargs.el (hargs:select-event-window): Updated to handle multiple frames and 
minibuffers.
 
 * hui-window.el (hmouse-alist): Extended hmouse-drag-between-windows to
@@ -812,11 +825,11 @@
       changes to "hui-mouse", "hui-window", "hibtypes" or "hactypes", most 
notably changes to
       hkey-alist and hmouse-alist.
 
-* hui-mouse.el (hkey-alist, smart-outline-char-invisible-p, smart-eolp): 
+* hui-mouse.el (hkey-alist, smart-outline-char-invisible-p, smart-eolp):
     Added and used to improve and narrow matching of end-of-lines.  
Previously, did not handle
     new-style Emacs outlines properly nor helm section header lines.
 
-* kotl/kotl-mode.el (kotl-mode:action-key, kotl-mode:assist-key): 
+* kotl/kotl-mode.el (kotl-mode:action-key, kotl-mode:assist-key):
   hui-mouse.el (smart-outline, smart-outline-assist): Changed to invoke 
action/assist-key-eol-function
     for end-of-line scrolling, eliminating hard-coded call.
   man/hyperbole.texi (Smart Key - Emacs Outline Mode): Documented this change.
@@ -906,7 +919,7 @@
     button choice when customizing this.
                 (hibtypes-social-hashtag-alist, 
hibtypes-social-username-alist): Added
     github user and commit lookup via social link syntax.
-                (hibtypes-social-github-default-user): 
+                (hibtypes-social-github-default-user):
                 (hibtypes-social-github-default-project)
                 (github-commit-reference): Added this new action and its
     above default values.
@@ -988,7 +1001,7 @@ hyrolo.el: Added basic commentary to the file header.
     match item actions prior to invoking them.  The smart-helm function
     behaves similarly to the {C-j} and {C-z} key bindings that helm mode
     provides when a helm completion is active. If helm is not active,
-    Hyperbole resumes the prior helm session before triggering the action. 
+    Hyperbole resumes the prior helm session before triggering the action.
     The smart-helm-assist function displays the match item and its associated
     action.
 
@@ -1039,7 +1052,7 @@ Python (case-sensitive).
 * hbut.el (ebut:map): Changed to ignore explicit button matches in
     programming languages when outside of a comment.  For example, syntax like
     this in a Rust buffer had been improperly matched: fn parse_kv(kv_list:
-    Vec<(syn::Ident, syn::StrLit)>, function: &Function) -> LispFnArgs 
+    Vec<(syn::Ident, syn::StrLit)>, function: &Function) -> LispFnArgs
 
 2017-08-25  Bob Weiner  <address@hidden>
 
@@ -1049,13 +1062,13 @@ Python (case-sensitive).
 
 * hpath.el (hpath:remote-at-p): For Emacs 26 where
     tramp-file-name-structure is now a function instead of a variable, call
-    the function. 
+    the function.
 
 * hyrolo.el (hyrolo-kill): Triggered error if FILE contains a '*' character,
     mainly in case a buffer name is passed as an argument.
             (hyrolo-file-list-initialize): Added this function so can
     re-initialize the hyrolo-file-list later if BBDB or Google Contacts
-    support is loaded after the Hyperbole Rolo is initialized. 
+    support is loaded after the Hyperbole Rolo is initialized.
 
 * hbut.el (hbut:source): Allowed for spaces in buffer names.
 
@@ -1095,10 +1108,10 @@ Python (case-sensitive).
 2016-08-17  Bob Weiner  <address@hidden>
 
 * README: Added Summary section with a description of Hyperbole since this 
file may be shown prior to
-    download in the Emacs package manager. 
+    download in the Emacs package manager.
 
 * kotl/kexport.el (kexport:label-html-font-attributes): Fixed improper 
'defvar' definition which should
-    have been a 'defcustom'. 
+    have been a 'defcustom'.
 
 2016-08-16  Bob Weiner  <address@hidden>
 
@@ -1136,8 +1149,8 @@ Python (case-sensitive).
 
 * hyperbole.el (Maintainer): Changed back to single line so ELPA parses it 
correctly.
 
-* hib-debbugs.el (debbugs-gnu-query:list): 
-  hyperbole.el (hkey-global-set-key, Info-directory-list): 
+* hib-debbugs.el (debbugs-gnu-query:list):
+  hyperbole.el (hkey-global-set-key, Info-directory-list):
   hvar.el (var:append): Removed improper function quoting of variable.
 
 ==============================================================================
@@ -1340,7 +1353,7 @@ V6.0.2 changes ^^^^:
     man/version.texi used in hyperbole.texi.
 
 * README.md: Added this, a markdown formatted introduction combining README,
-    INSTALL and HY-ABOUT. 
+    INSTALL and HY-ABOUT.
 
 2016-07-26  Mats Lidell  <address@hidden>
 
@@ -1419,7 +1432,7 @@ V6.0.2 changes ^^^^:
     then skip setup to generate hyperbole-autoloads with autoloads from the 
kotl/
     subdirectory.
 
-* hib-social.el (social-reference): 
+* hib-social.el (social-reference):
   hibtypes.el (mail-address-at-p): Let case-fold-search be t since 
mail-addresses
     are case-insensitive.
 
diff --git a/DEMO b/DEMO
index f3cdb6f..c650ae7 100644
--- a/DEMO
+++ b/DEMO
@@ -202,6 +202,8 @@ frames and windows, the minor modes of HyControl, with a 
modeline indicator
 of either "HyFrm" or HyWin" depending on which type of control is active.  See
 "(hyperbole)HyControl" for full usage information.
 
+** Frame Commands
+
 Let's try some of the more interesting commands.  You can either type the
 following key sequences (ignoring the braces) for practice or simply press
 the Action Key within them to see what they look like.
@@ -226,6 +228,8 @@ the argument is used to adjust one dimension of the frame.
 { F }        - tear off the selected window (if more than one window)
                into a new frame
 
+** Windows Grid
+
 The address@hidden command splits a frame into a grid of up to 9 rows by 9 
columns of
 windows, showing a different buffer in each window, if available.  First
 let's expand our frame to full screen with the {.1 %} command and then show
diff --git a/HY-NEWS b/HY-NEWS
index 4308d0e..3321248 100644
--- a/HY-NEWS
+++ b/HY-NEWS
@@ -7,21 +7,319 @@
 
         (See the "Changes" file for even more details of changes).
 
-  BUTTONS
+  BUTTONS AND SMART (ACTION AND ASSIST) KEYS
+
+    - Extensive new support for cross-window and cross-frame drags of the
+      Action and Assist Mouse Keys.  See "DEMO#Smart Mouse Keys" and the Info
+      manual section, "(hyperbole)Smart Mouse Key Drags" for details.  These
+      actions allow for rapid display of buffers, windows and frames wherever
+      you like.
+
+      Major features include:
+
+        * Dragging items from Dired or the Buffer Menu for display in existing
+          or new windows and frames.  Action Key drag from the first line (or
+          header line) to another window to move the listing buffer itself.
+          Visual pulsing of source and destination to highlight the transfer
+          taking place (hmouse-pulse-flag controls this).  A following click on
+          an item displays it in the source window, replacing the Dired or
+          Buffer Menu listing.
+
+        * Dragging from a buffer or an item to a modeline splits the window of
+          the modeline and displays the buffer/item dragged in the leftmost
+         or uppermost of the split windows.
+
+        * Cloning or moving an Emacs window to a similarly sized new frame or
+         another existing frame.
+
+        * Displaying a buffer in specific other windows.
+
+        * With Emacs 26 on macOS, Hyperbole detects the window of any drag
+          release or whether the release was outside of Emacs, e.g. in another
+         application whose window is atop an Emacs frame (uses a Python script
+         included with Hyperbole, so Python must be available or this will do
+         nothing).
+
+          The hmouse-verify-release-window-flag (default is t) controls whether
+          checking for non-Emacs areas on macOS is done or not, as this slows
+          Smart Key action handling at least 1/3 of a second in a number of 
cases.
+
+    - {}-delimited Key Sequence Implicit Buttons have been greatly expanded.
+      An Action Key press on the following, all execute the associated 
commands:
+        {M-x occur RET}                 - M-x extended commands
+        {M-x apropos RET hyperbole RET} - commands with arguments
+       {C-x 2 C-x 3}                   - sequences of commands
+
+    - Pathname Environment Variables: Implicit Buttons may contain environment
+      variables such as "${PATH}/python" and Hyperbole resolves them to the
+      first matching directory with an Action Key press.
+
+    - Prefixed URLs: Partial URLs with prefixes such as, url:photos.google.com
+      or url=calendar.google.com, can now be displayed with Action Key presses
+      even though they lack a www site name or an http protocol prefix.
+
+    - Link to File: When modifying an explicit file link button, a variable in
+      a pathname is maintained as is any prior in-file location when prompting
+      for changes.
+
+    - EWW Support: Added Action and Assist Key support for browsing links in
+      eww (the Emacs web browser) and for activating history links in the eww
+      history buffer.
+
+    - Open Office Documents: An Action Key press on an Open Office pathname
+      displays it in Open Office.  See hpath:external-open-office-suffixes for
+      file suffixes supported.
+
+    - macOS Apps: An Action Key press on a pathname that ends in ".app" on a
+      macOS system will run the app externally (previously it would have been
+      browsed as a directory).
+
+    - File Page Browsing: Dynamic table-of-contents-type browsing for files
+      separated into pages with form-feed (Control-L) page separators.  Use
+      {M-x pages-directory RET} to generate the listing of pages and then press
+      the Action Key on any entry to jump to it.
+
+    - Explicit Buttons in Comments: Explicit buttons in programming languages
+      are now matched only within comments to avoid language syntax that looks
+      like the delimiters of an explicit button, e.g. in Rust.
+
+    - New hproperty:but-highlight-flag: This controls whether Hyperbole
+      explicit buttons are highlighted with a special colored face or not.  By
+      default, they are.
+
+    - Git References: New implicit button and action type with a compact syntax
+        that displays many types of git entities, e.g. git#commit/55a1f0.  Such
+        references work across all git repositories on your local disks.
+
+        See "DEMO#Git (Local) References" or the commentary at the top of the
+        "hib-social.el" file for extensive examples of these references.  {C-h
+        f git-reference RET} explains its syntax.
+
+    - Github References: New implicit button and action type with a compact
+        syntax that displays many types of github entities,
+        e.g. gh#emacs-helm/helm/1878, displays issue #1878 for user emacs-helm
+        and project helm.  See "DEMO#Github (Remote) References" or the
+        commentary at the top of the "hib-social.el" file for extensive
+        examples of these references.  {C-h f github-reference RET} explains
+        its syntax.
+
+    - Python PDB Backtraces: Action Key presses jump to the associated source
+      line.
+
+    - Python Symbols: Action Key presses now look these up in any buffer whose
+      name includes Pydoc: or Python, mainly help buffers.
+
+    - Compressed File Grep: {C-h h f g} now uses zgrep when available to
+      handle compressed source files.
+
+    - Grep -A Support: The grep -A option produces context lines around any
+      matched lines but uses a different syntax for separating line numbers at
+      the beginning of lines.  The Action Key now supports jumping to the
+      source of any such lines.
+
+    - Dired Quit: An Action Key press at the end of the first line in a Dired
+      buffer nows quit and execute requested actions, just as presses at the
+      end of the buffer do.
+
+    - Image Thumbnail Browsing: See the Info manual section,
+      "(emacs)Image-Dired", for how to create a buffer of image thumbnails.
+      Once created, the Action Key displays a scaled version of the original
+      image in an Emacs window.  The Assist Key displays the original image in
+      an external viewer.
+
+    - Emacs Push-buttons: An Assist Key press on an Emacs push-button 
previously
+      displayed its keyboard-action help string but not its mouse-action help 
string.
+      Now it displays the mouse-action when appropriate.
 
-    - 
+    - Texinfo References: An Action Key press on an Emacs Lisp @findex
+      (function) or @vindex (variable) entry displays the documentation for
+      that entry.
+
+    - Debbugs Issues: Eliminated match of #id-number as a bug reference; 'bug' 
or
+      similar prefix is now required so there is no ambiguity with social 
references
+      including 'git #commit-number'.
+
+  CUSTOMIZATON
+
+    - Smart Key Hooks: New hooks run before and after Smart Key depress and
+      release events: action-key-depress-hook, action-key-release-hook,
+      assist-key-depress-hook and assist-key-release-hook.
 
   DOCUMENTATION
 
-    - 
+    - Hyperbole HTML Manual: The HTML version of the Hyperbole Manual now uses
+      a css stylesheet similar to that used for the Hyperbole Home page, making
+      it look much better and easier to navigate.
+
+    - Drags: Updated Hyperbole Manual with all new Smart Mouse Key drag 
actions.
+
+    - Smart Key Help: Improved help documentation for Smart Keys when they
+      contain multiple clauses connected with 'or' logic, e.g. do 'a' or 'b' or
+      'c'.
+
+    - New Hyperbole Manual Sections:
+        * Smart Mouse Key Drags
+        * Smart Mouse Drags outside a Window
+        * Smart Key - Image Thumbnails
+       * Future Work - Direct Manipulation
+
+    - Git References: In the Implicit Buttons section of the Hyperbole Manual,
+      added documentation for git-reference, git-commit-reference and 
github-reference.
+
+    - Toggle Key Bindings: In the Smart Key Bindings section of the Hyperbole 
Manual,
+      explained hyperbole-toggle-bindings (toggles keyboard and mouse keys) 
rather
+      than hmouse-toggle-bindings (toggles only mouse keys).  Moved the latter 
to
+      the Global Key Bindings appendix.
+
+    - Other Hyperbole Manual Section Changes:
+        * Manual Overview: Improved pointer to DEMO.
+        * Koutliner: Centralized all key binding index entries under 
"koutliner, ".
+        * HyControl: Added Concept Index entries.
+        * Glossary: Added Windows Grid entry.
+
+    - New DEMO File Sections:
+        * Dragging Buffers, Windows and Items
+        * HyControl Frame Commands and Windows Grid subsections
+        * Running Dired on the Current Directory
+
+  HYCONTROL
+
+    - HyControl Minor Modes: HyControl is now two minor modes, one for frames
+      and one for windows.  It uses standard key bindings and standard Emacs
+      event processing instead of its own event loop, so any keys not bound
+      in a HyControl mode now work normally.  HyControl Windows Mode displays
+      HyWin in the modeline and HyControl Frames Mode displays HyFrm while
+      active.  Both modes invert the modeline colors so you don't forget you
+      are in a special mode.
+
+    - address@hidden is an incredible new key binding and command that creates 
a grid
+      of windows within a frame by splitting the frame into a number of equally
+      sized windows specified by a number of rows and columns (typically as
+      prefix arg digits).  Each window shows a different buffer, if possible,
+      with a prefix arg of 0 prompting for a major mode and first displaying
+      buffers of that mode.
+
+      The same address@hidden command works in Dired, Buffer Menu and IBuffer 
modes and
+      first displays any items marked for display in the windows grid,
+      i.e. marked with the {m} command.
+
+      Hyperbole also supplies the global key binding {C-c @} so this command
+      can be used at any time.
+
+      The variable, hycontrol-display-buffer-predicate-list, determines which
+      buffers are first displayed in the grid except when filtering by major
+      mode or by items marked in a listing buffer.
+
+      {M-x hycontrol-windows-grid-repeatedly RET} allows rapid visual testing
+      of different grid layouts or filters as it prompts you for a grid size,
+      displays it and then prompts you again until your press RET without 
giving
+      a size.
+
+      See "Demo#Windows Grid" for example use.
+
+    - {a} adjusts the selected frame width by cycling through a list of common
+      fixed percentages such as 25% and 50% (given by the variable,
+      hycontrol-frame-widths.
+
+      {A} does the same for the selected frame's height, using
+      hycontrol-frame-heights.
+
+    - {f} now clones a window to a new frame without deleting the source window
+      {F} moves a window to a new frame and deletes the the source window
+
+    - {i}, {j}, {k}, {m} first expand the selected frame to an edge based on
+      their respective positions on a U.S. keyboard, e.g. {i} expands the frame
+      to the top edge; with further invocations, they keep the frame at that 
edge
+      but cut its perpendicular dimension in half (or to any percentage 
specified
+      as an argument), leaving the particular edge fixed.  This allows both 
rapid
+      expansion and contraction of frames with just 4 keys whenever needed.
+
+      It is easiest to understand by simply trying the keys. See "Demo#Frame
+      Commands" for example use.
+
+    - {c} for frame edge location cycling now is available in HyControl Windows
+      mode.
+
+    - {p <num>} displays a virtual numeric keypad and moves the selected frame
+      to the screen edge position based on the numeric keypad layout, e.g. 3
+      moves it to the southeast corner of the screen.  This is for keyboards
+      that do not have a physical numeric keypad.  Before a number is selected,
+      {C-g} or {q} will exit and return to the top-level of the active
+      HyControl mode.
+
+    - {-} in HyControl Windows mode minimizes a window size while trying to
+      display its entire buffer.  Now it will resize the window to 1 line
+      if it cannot display all lines or if all lines are already displayed.
+
+    - Minibuffer Help: Improved help strings shown in the minibuffer while
+      HyControl is active.  Added {?} key which toggles this display on and 
off.
+      
+    - ESC: Removed this as a quit key since now that regular key sequences are
+      supported, this is often used as a meta key prefix.  Use {q} to quit.
+
+    - Minibuffer Prompts: Automatically quit from any HyControl mode whenever a
+      minibuffer prompt becomes active so that arguments may be typed normally.
+      Examples include use of {M-:} for Lisp expression evaluation and M-x for
+      entering commands by name.
+
+  HYROLO
+
+    - Google Contacts: New support for searching your Google Contacts with the
+      HyRolo Contact Manager; for advanced users only.  Requires use of the
+      Emacs google-contacts package and the non-Emacs gpg public key package to
+      support Google services authorization.  Once configured, these contacts
+      are automatically searched together with local HyRolo files any time a
+      contact search is performed.  See the Google Contacts Integration section
+      in "hyrolo.el".
+
+    - Dynamic HyRolo List: The HyRolo list of files to search is now computed
+      dynamically so you can enable Big Brother Database (BBDB) or Google
+      Contacts support after HyRolo is initialized and these contacts will also
+      be searched.
 
   KEYS
 
-    - 
+    - Unshifted Mouse Keys: By default, Hyperbole mouse keys are Shift-Middle
+      (Action Key) and Shift-Right (Assist Key).  For frequent mouse users,
+      there is now {M-x hmouse-add-unshifted-smart-keys RET} which additionally
+      makes the Middle mouse key the Action Key and the Right mouse key the
+      Assist Key, replacing their default Emacs functions.  {M-x
+      hmouse-toggle-bindings RET} will toggle between the Emacs and Hyperbole
+      mouse bindings.
+
+    - Smart Key Reload: If you ever edit any of the Smart Key contexts or
+      actions in "hui-mouse.el", "hui-window.el", "hibtypes.el" or
+      "hactypes.el" and re-byte-compile those files, then you may reload your
+      new settings with {M-x hmouse-update-smart-keys RET}.  No need to reload
+      or restart Hyperbole.
+
+    - Find Web: Added Find Web key binding entry to Hyperbole menus.  This key
+      displays the Hyperbole Web search menu.
+
+    - Jump Thing: Added Jump Thing key binding entry to Hyperbole menus.  This
+      key jumps between the start and end of a matching delimiter or tag pair.
+
+    - Mod Mouse Keys: Disallowed this feature meant to enable one hand on the
+      keyboard while the other hand pressed the mouse keys as Control and Meta
+      modifier keys.  Use would conflict with Emacs bindings of Control and
+      Meta mouse keys.
+
+  KOUTLINER
+
+    - `e' Viewspec: Removed ellipses viewspec because ellipses can no longer be
+      turned off with modern Emacs outlining.
 
   MENUS
 
-    -
+    - Prefix Arguments: Prefix arguments may now be given to any Hyperbole menu
+      command that accepts them.
+
+    - Action Doc Strings: If a menu item has no help string but its action is a
+      function with a doc string, then that doc string will be used to display
+      help for the menu item.
+
+    - Key Bindings: The pulldown menu, Hyperbole/Options/Change-Key-Bindings
+      now displays the current keys bound to each command for easy reference.
 
 ===========================================================================
 *                                  V6.0.2
diff --git a/hsettings.el b/hsettings.el
index 3810dd7..4200046 100644
--- a/hsettings.el
+++ b/hsettings.el
@@ -202,9 +202,12 @@ obtained search string."
        ;; appeal to you. See "hui-em-but.el" for how this works.
        (hproperty:cycle-but-color nil)
        ;;
+       ;; Non-nil means highlight all explict buttons with 
`hproperty:but-face'.
+       (setq hproperty:but-highlight-flag t)
+       ;;
        ;; Non-nil means visually emphasize that button under mouse cursor is
        ;; selectable.
-       (setq hproperty:but-emphasize-p nil)
+       (setq hproperty:but-emphasize-flag nil)
        ;;
        ;; If you find that the Hyperbole button flash time is too slow
        ;; or too fast, adjust it here.
@@ -224,6 +227,9 @@ obtained search string."
        ;; appeal to you. See "hui-xe-but.el" for how this works.
        (hproperty:cycle-but-color nil)
        ;;
+       ;; Non-nil means highlight all explict buttons with 
`hproperty:but-face'.
+       (setq hproperty:but-highlight-flag t)
+       ;;
        ;; Non-nil means visually emphasize that button under mouse cursor is
        ;; selectable.
        (setq hproperty:but-emphasize-p nil)
diff --git a/hui-em-but.el b/hui-em-but.el
index 2608445..572679d 100644
--- a/hui-em-but.el
+++ b/hui-em-but.el
@@ -46,12 +46,12 @@
 ;;; Public variables
 ;;; ************************************************************************
 
-(defcustom hproperty:but-highlight-p t
+(defcustom hproperty:but-highlight-flag t
   "*Non-nil (default value) means highlight all explict buttons with 
`hproperty:but-face'."
   :type 'boolean
   :group 'hyperbole-buttons)
 
-(defcustom hproperty:but-emphasize-p nil
+(defcustom hproperty:but-emphasize-flag nil
   "*Non-nil means visually emphasize that button under mouse cursor is 
selectable."
   :type 'boolean
   :group 'hyperbole-buttons)
@@ -79,11 +79,11 @@ Call (hproperty:set-item-highlight <color>) to change 
value."
 
 (defun hproperty:but-add (start end face)
   "Add between START and END a button using FACE in current buffer.
-If `hproperty:but-emphasize-p' is non-nil when this is called, emphasize that
-button is selectable whenever the mouse cursor moves over it."
+If `hproperty:but-emphasize-flag' is non-nil when this is called, emphasize
+that button is selectable whenever the mouse cursor moves over it."
   (let ((but (make-overlay start end)))
     (overlay-put but 'face face)
-    (if hproperty:but-emphasize-p (overlay-put but 'mouse-face 'highlight))))
+    (if hproperty:but-emphasize-flag (overlay-put but 'mouse-face 
'highlight))))
 
 (defun hproperty:but-color ()
   "Return current color of buffer's buttons."
@@ -110,8 +110,8 @@ expression which matches an entire button string.
 If REGEXP-MATCH is non-nil, only buttons matching this argument are
 highlighted.
 
-If `hproperty:but-emphasize-p' is non-nil when this is called, emphasize that
-button is selectable whenever the mouse cursor moves over it."
+If `hproperty:but-emphasize-flag' is non-nil when this is called, emphasize
+that button is selectable whenever the mouse cursor moves over it."
   (interactive)
   (hproperty:but-clear)
   (hproperty:but-create-all start-delim end-delim regexp-match))
@@ -123,7 +123,7 @@ If END-DELIM is a symbol, e.g. t, then START-DELIM is taken 
as a regular
 expression which matches an entire button string.
 If REGEXP-MATCH is non-nil, only buttons matching this argument are
 highlighted."
-  (when hproperty:but-highlight-p
+  (when hproperty:but-highlight-flag
     (ebut:map (lambda (lbl start end)
                (hproperty:but-add start end hproperty:but-face))
              start-delim end-delim regexp-match 'include-delims)))
diff --git a/hui-xe-but.el b/hui-xe-but.el
index dcde64a..a3210db 100644
--- a/hui-xe-but.el
+++ b/hui-xe-but.el
@@ -44,12 +44,12 @@
 ;;; Public variables
 ;;; ************************************************************************
 
-(defcustom hproperty:but-highlight-p t
+(defcustom hproperty:but-highlight-flag t
   "*Non-nil (default value) means highlight all explict buttons with 
`hproperty:but-face'."
   :type 'boolean
   :group 'hyperbole-buttons)
 
-(defcustom hproperty:but-emphasize-p nil
+(defcustom hproperty:but-emphasize-flag nil
   "*Non-nil means visually emphasize that button under mouse cursor is 
selectable."
   :type 'boolean
   :group 'hyperbole-buttons)
@@ -72,11 +72,11 @@ Call (hproperty:set-item-highlight <color>) to change 
value."
 
 (defun hproperty:but-add (start end face)
   "Add between START and END a button using FACE in current buffer.
-If `hproperty:but-emphasize-p' is non-nil when this is called, emphasize that
-button is selectable whenever the mouse cursor moves over it."
+If `hproperty:but-emphasize-flag' is non-nil when this is called, emphasize
+that button is selectable whenever the mouse cursor moves over it."
   (let ((but (make-extent start end)))
     (set-extent-face but face)
-    (set-extent-property but 'highlight hproperty:but-emphasize-p)))
+    (set-extent-property but 'highlight hproperty:but-emphasize-flag)))
 
 (defun hproperty:but-color ()
   "Return current color of buffer's buttons."
@@ -99,8 +99,8 @@ expression which matches an entire button string.
 If REGEXP-MATCH is non-nil, only buttons matching this argument are
 highlighted.
 
-If `hproperty:but-emphasize-p' is non-nil when this is called, emphasize that
-button is selectable whenever the mouse cursor moves over it."
+If `hproperty:but-emphasize-flag' is non-nil when this is called, emphasize
+that button is selectable whenever the mouse cursor moves over it."
   (interactive)
   (hproperty:but-clear)
   (hproperty:but-create-all start-delim end-delim regexp-match))
@@ -112,7 +112,7 @@ If END-DELIM is a symbol, e.g. t, then START-DELIM is taken 
as a regular
 expression which matches an entire button string.
 If REGEXP-MATCH is non-nil, only buttons matching this argument are
 highlighted."
-  (when hproperty:but-highlight-p
+  (when hproperty:but-highlight-flag
     (ebut:map (lambda (lbl start end)
                (hproperty:but-add start end hproperty:but-face))
              start-delim end-delim regexp-match 'include-delims)))
diff --git a/hyrolo.el b/hyrolo.el
index d213dc9..134b78c 100644
--- a/hyrolo.el
+++ b/hyrolo.el
@@ -1217,7 +1217,7 @@ HYROLO-BUF may be a file-name, buffer-name, or buffer."
 (defun hyrolo-highlight-matches (regexp start end)
   "Highlight matches for REGEXP in region from START to END."
   (if (fboundp 'hproperty:but-add)
-      (let ((hproperty:but-emphasize-p))
+      (let ((hproperty:but-emphasize-flag))
        (save-excursion
          (goto-char start)
          (while (re-search-forward regexp nil t)
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index eb3c329..3f9a7f6 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -5140,6 +5140,15 @@ any personal Hyperbole type definitions or key bindings 
you might have.
 It is run after Hyperbole support code is loaded but before Hyperbole is
 initialized, i.e. prior to keyboard and mouse bindings.
 
address@hidden action-key-depress-hook
address@hidden assist-key-depress-hook
+Run after an Action or Assist Mouse Key depress is detected.
+
address@hidden action-key-release-hook
address@hidden assist-key-release-hook
+Run after an Action or Assist Mouse Key release is detected, before
+any associated action is executed.
+
 @vindex hbut:current
 @item action-act-hook
 Run before each Hyperbole button activation.
@@ -6430,7 +6439,9 @@ you in deciding whether or not to modify the value of
 @subsection  Configuring Button Colors
 @cindex Emacs support
 @cindex button highlighting
address@hidden highlighting buttons
 @cindex button flashing
address@hidden flashing buttons
 @vindex file, hui-ep*.el
 @vindex file, hsettings.el
 @findex hproperty:cycle-but-color
@@ -6443,12 +6454,12 @@ code which supports this behavior.  A call
 to @code{(hproperty:cycle-but-color)} in the @file{hsettings.el} file
 changes the color used to highlight and flash explicit buttons.
 
address@hidden button emphasis
address@hidden hproperty:but-emphasize-p
-Additionally, if @code{hproperty:but-emphasize-p} is set to @samp{t},
-then whenever the mouse pointer moves over an explicit button, it will
-be emphasized in a different color or style.  This emphasis is in
-addition to any non-mouse-sensitive button highlighting.
address@hidden hproperty:but-highlight-flag
+Whether or not buttons are highlighted is controlled
+by @code{hproperty:but-highlight-flag}, which defaults to @samp{t}.
+To disable highlighting, change this setting in @file{hsettings.el} or
+use Hyperbole menu item, Cust/All-Options, and select the Hyperbole
+Buttons group to edit its options.
 
 @cindex button highlighting, forcing
 @findex hproperty:but-create
@@ -6457,6 +6468,13 @@ these buttons won't be highlighted.  Load Hyperbole and 
then use
 @bkbd{M-x hproperty:but-create @key{RET}} to highlight the buttons in
 the current buffer.
 
address@hidden button emphasis
address@hidden hproperty:but-emphasize-flag
+Additionally, if @code{hproperty:but-emphasize-flag} is set to @samp{t},
+then whenever the mouse pointer moves over an explicit button, it will
+be emphasized in a different color or style.  This emphasis is in
+addition to any non-mouse-sensitive button highlighting.
+
 
 @node Global Key Bindings, Koutliner Keys, Setup, Top
 @appendix Global Key Bindings



reply via email to

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