[Hyperbole-users] ANNOUNCE: GNU Hyperbole 5.13, a significant update, is released for testing and use

[Robert Weiner]

GNU Hyperbole 5.13 is now available for testing and use with many new features
as described below.  Instructions on how to download and install it as an Emacs
package are included after the What's New section.

The first new feature, integration with the debbugs issues tracker, may be
of particular interest to Emacs developers.

The next release likely will be the first public release of this new
generation of Hyperbole, so we want any level of feedback you can
provide about what you like and don't like or anything you don't
understand.  So if you are thinking of trying Hyperbole, now is the
time.

The GNU Hyperbole project home page gives a more extensive description
for those unfamiliar:  https://www.gnu.org/software/hyperbole/

=======================================================================
*    What's New in GNU Hyperbole V5.13
=======================================================================

  BUTTONS

    - Instant Bug Lookups and Queries: New Gnu Debbugs bug/issue tracking
      implicit button type that jumps to the description and discussion of
      issues by issue number and displays an issue's status.  This works for
      the GNU Hyperbole issue tracker as well as many other GNU projects.  All
      of these button formats may be embedded within any text:

          #id-number
          bug#id-number, bug# id-number, bug #id-number or bug id-number
          bug?attr1=val1&attr2=val2&attr3=val3
          bug#id-number?attr1=val1&attr2=val2&attr3=val3

      Note that `issue' or `debbugs' may be used in place of `bug'.

      See the documentation at the start of "hib-debbugs.el" for more
      information.

    - During the creation of link-to-Info-node explicit buttons with an
      argument of the type (filename)nodename, full completion is offered for
      both the filename and the node name; just type ? to list completions
      after typing a few characters.  You now can drop the .info suffix from
      filenames as well, so "(hyperbole)Smart Keys" works fine as a node
      reference.

    - Implicit links from the output of the UNIX apropos command now work
      properly in Emacs 25.

    - Implicit pathname matches now handle compressed Emacs Lisp files found
      anywhere within the directories of `load-path' and do not try to expand
      paths that begin with a ~.

    - New variable, `hpath:info-suffix', is a regular expression of Info
      filename suffixes which may be ommitted when using parenthesized Info
      filenames in links; this allows for compressed Info file matches and Info
      pathnames of the form "(Hyperbole)" to work.  That displays the top node
      of the Hyperbole Manual in the Info browser.

    - Pathnames ending in .mp3, .wav or .ogg are played as music files rather
      than displayed if your Emacs has support for this.  Modify the value of
      the variable, `hpath:internal-display-alist' to add more formats.

    - New per-window system association list variables determine what if any
      file types within Hyperbole hyperlinks are displayed by external programs
      outside of Emacs.  See the values of and documentation for:
      `hpath:external-display-alist-macos',
`hpath:external-display-alist-mswindows',
      and `hpath:external-display-alist-x'.

    - Added support for &, ~, and ^ as identifier characters in Lisp tags and
      removed #.

  DOCUMENTATION

    - DEMO File: Major updates to reflect the latest Hyperbole features.  Added
      sections on HyControl, Creating and Modifying Explicit Buttons and
      Path Suffixes and Variables.  Try it out with {C-h h d d}.

    - Hyperbole Manual
        - Updated all screenshots in the manual; thanks to Mats L.
        - In the "(hyperbole)Internal Viewers" section, added a description of
          the file formats supported by the default setting of the
          `hpath:internal-display-alist' variable.
        - Added sections "(hyperbole)Smart Key Modifiers" and
"(hyperbole)Smart Key Modeline".
        - Added a "(hyperbole)Glossary" entry for Chord Keyboard.
        - In "(hyperbole)Smart Key Thing Selection", added documentation of the
          {C-c RET} key for syntactical region marking and the {C-c .} key for
          delimited thing jumping between start and end.
        - In the Cust/ menu section of "(hyperbole)Menus" which lists all
          Hyperbole key bindings, indicated which keys are bound only if not
          bound prior to loading Hyperbole.

  HYCONTROL

    - Frame placement calculations now account for window system decorations
      around frame, leading to improved placement offsets around screen edges.
      See the documentation for `hycontrol-set-screen-offsets'.

  MENUS

    - On the Hyperbole menubar menu, the Types submenu which shows
      documentation for Hyperbole types has been moved below the Documentation
      menu to match the Hyperbole minibuffer menu location.  Also added a Types
      menu item under the Explicit-Button menu to match the one under the
      Implicit-Button menu.

    - On the Hyperbole Customize/Change-Key-Bindings menubar menu, renamed
      these entries and added Mark-Think-Key.  Similar updates done to the
      minibuffer menu.

  MOUSE AND SMART KEY SUPPORT

    - An Action Key press on a Hyperbole minibuffer menu key sequence now
      invokes the associated menu action.  Try it with {C-h h d g} to see the
      Hyperbole glossary.  An Assist Key press shows help for the menu item.

    - Changed the `assist-key-default-function' which applies in an unrecognized
      context to trigger an error by default to match the behavior of the
      Action Key.  Its prior value, toggle display of or hide the Smart Key
      summary, is performed by an Assist Key click in the right of a modeline
      or via minibuffer menu with {C-h h d s}.

    - Point is now left within the Smart Key summary by default and it is in
      help mode so you can page through it with SPC and DEL keys and then quit
      from it with {q}.

    - A click of the Action Mouse Key within an inactive minibuffer menu
      displays the Hyperbole minibuffer menu, allowing you to invoke menu
      entries with the mouse.  A click of the Assist Key in the same place
      displays the buffer, window and frame jump menu just as does a click
      within the middle of a modeline since it is easy to miss by a little and
      click on one or the other.  These behaviors are controlled by the new
      variables, `action-key-minibuffer-function' and
      `assist-key-minibuffer-function'.

    - Distributed Window System Support: Previously, Hyperbole supported mouse
      control only on the screen on which it was launched.  If you used
      emacsclient or other means to create a frame on another screen or outside
      of a terminal, that frame would not have Hyperbole mouse support even
      though it was under a window system.  Now each frame receives mouse
      support whenever its window system has mouse support.

    - Improved support for using the Action and Assist Mouse Keys as Control-
      and Meta- modifier keys, mainly for use with a chord keyboard or to
      balance hand use to reduce carpal tunnel stress.  Made `hmouse-mod-mode'
      a regular minor mode.  See "(hyperbole)Smart Key Modifiers" for more
      details.

  ROLO

    - Fixed entry sorting to work with Emacs 25.

=======================================================================
*  Simple Installation as an Emacs Package
=======================================================================


By far, the simplest and quickest way to obtain and to install Hyperbole is
to use the Emacs Package Manager.  If you are not familiar with it, see the
Packages section of the GNU Emacs Manual, "(emacs)Packages".

If you have Hyperbole 5.10 or higher already installed and simply want to
upgrade it, invoke the Emacs Package Manager with {M-x list-packages RET},
then use the {U} followed by the {x} key to upgrade all out-of-date
packages, Hyperbole among them.  Then skip the next section and move on to
Invocation.

Otherwise, to download and install the Hyperbole package, add the following
lines to your personal Emacs initialization file, typically "~/.emacs".

(require 'package)
(setq package-check-signature nil
      package-enable-at-startup nil) ;; Prevent double loading of libraries
(add-to-list 'package-archives '("RSW-Packages" .
"http://www.plasmas.biz/rswe/";) t)
(package-initialize)
(unless (package-installed-p 'hyperbole)
  (package-refresh-contents)
  (package-install 'hyperbole))
(require 'hyperbole)

Then restart Emacs and if no errors occur, the latest version of Hyperbole
will be downloaded, built and then available for use.  When it is ready,
you will see a Hyperbole menu on your menubar and {C-h h} will display a
Hyperbole menu in the minibuffer for quick keyboard-based selection.

When Hyperbole is ready for use, you will see a Hyperbole menu on your
menubar and {C-h h} will display a Hyperbole menu in the minibuffer for
quick keyboard-based selection.  Select an item from this menu by typing
the item's first letter.  Use {q} to quit from the menu.

The Hyperbole Manual is included in the "man/" subdirectory of
the Hyperbole package directory in four forms:

"man/hyperbole.info"   - online Info browser version
"man/hyperbole.html"   - web HTML version
"man/hyperbole.pdf"    - printable version
"man/hyperbole.texi"   - source form

The Hyperbole package installation places the Info version of this
manual where needed and adds an entry for Hyperbole into the Info
directory under the Emacs category.  {C-h h d i} will let you
browse the manual.  For web browsing, point your browser
at "${hyperb:dir}/man/hyperbole.html", wherever the
Hyperbole package directory is on your system, often this
is: "~/.emacs.d/elpa/hyperbole-${hyperb:version}/".

=======================================================================
*    Invocation
=======================================================================

Once Hyperbole has been installed for use at your site, you can invoke its
commands in one of three ways:

   use the Hyperbole entry on your menubar;

   type {C-h h} or {M-x hyperbole RET} to bring up the Hyperbole main menu
   in the minibuffer window;

   use a specific Hyperbole command such as an Action Key click {M-RET} on
   a pathname to display the associated file or directory.

Read the Hyperbole Manual, "(hyperbole)Top", to learn all about it.  A
press of {M-RET} within the above double quotes will display the manual.

-- End --