ANNOUNCE: GNU Hyperbole 5.15 is released for testing and use

ANNOUNCE: GNU Hyperbole 5.15 is released for testing and use

[Robert Weiner]

GNU Hyperbole 5.15 is now available for testing and use with a number
of 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 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.15
===========================================================================

  BUTTONS

    - New Implicit Button Type, debbugs-gnu-mode: When on a GNU Debbugs listing
      entry in debbugs-gnu-mode, an Action Key press displays the discussion of
      the selected issue; an Assist Key press pretty prints the status of the
      issue to a window below the listing window.  This augments the
      debbugs-gnu-query implicit button type from V5.14 which recognizes
      bug/issue ids and queries in any buffer.

    - Initial Org Mode Support: The new implicit button type, org-mode, follows
      Org mode hyperlinks and cycles display views of Org mode outline headings.
      When on a heading, the Action Key cycles the view of the subtree at point
      and the Assist Key cycles the view of all headings in the buffer.

      Suggest other good ideas for Smart Key actions on Org entities and we'll
      likely implement them.

    - Links to Info Manual Index Items: You can now drag between windows with
      the Action Mouse Key depressed to an Info Manual index menu entry to
      create an explicit button link to it (or use {C-h h e c} with an action
      type of link-to-Info-index-item).  Then the button will always take you
      to the line in the manual referenced by that index item.  This also works
      with other Info menu items and cross-references.  Implicit buttons that
      reference index items work too, like "(hyperbole)C-c C-m"!  And when you
      are creating the link, full completion of the file name (within
      parentheses) and the index item name is provided; just type ? to list
      completions after typing a few characters.  Since Emacs and most GNU
      programs include Info manuals, you now have a simple way to link to and
      jump to any marked item within any manual.

      Previously, when creating a link to an Info manual node, Hyperbole would
      ignore cross-references and menu items and just link directly to the node
      rather than anything it referenced.  To get that behavior now, simply
      link to a place in the node that does not reference another place.

    - Link Button Creation: Hyperbole now shows you what you linked to at
      global or explicit link button creation time.  Previously, it showed you
      only the type of the link.  So if you drag across windows from a button
      label to an Info index item now, you will know that the link goes to the
      index item entry and not to the index node containing the item reference.

    - New Implicit Button Type, pathname-line-and-column: A whitespace or quote
      delimited existing pathname followed by a :line-num and an optional
      :column-num displays the path at line-num and column-num.  So
      "~/.emacs:10:40" shows your Emacs initialization file at line 10 and
      column 40. The column number is optional.

    - GNU Info Manual Key Sequences: Previously, Hyperbole recognized key
      sequences delimited by curly braces only, {}.  Now it recognizes the
      quotation marks used in GNU Info manuals as well and can execute them
      with an Action Key press within Info buffers.

    - Imenu Item Recognition: When the Emacs imenu library is in use and an
      identifier menu has been generated for the current buffer, an Action Key
      press on an identifier at point jumps to the identifier definition
      within the current buffer; an Assist Key press prompts with completion
      for an identifier defined within the buffer and then jumps to its
      definition.

  DOCUMENTATION

    - Smart Key Debugging: Added a section, "(hyperbole)Smart Key Debugging",
      to the Hyperbole Manual, documenting the usage of the Customize Menu
      option, Toggle-Smart-Key-Debug (minibuffer menu Cust/Debug-Toggle,
      {C-h h c d}).

  KEYS

    - Toggle Hyperbole Keys: The new command, {M-x hyperbole-toggle-bindings
      RET}, toggles Hyperbole mouse and keyboard keys off and on.  This is not
      bound to a key because it will make Hyperbole unusable until the keys are
      re-established with another toggle.  This forces you to know what you are
      doing before you utilize this feature.

  MENUS

    - Minibuffer Keyboard Direct Selection:  You have always been able to click
      with your mouse on a minibuffer menu item to directly select it.  Now
      Hyperbole has the keys {TAB} or {M-f} to move to the next menu item and
      {Shift-TAB}, {M-TAB} or {M-b} to move to the previous item, with each
      cycling back when it reaches the end or beginning of the menu.  The
      fastest way to select minibuffer menu items from the keyboard remains
      typing the first letter (case-insensitive) of the menu item.

    - Minibuffer Menu Navigation Changes: A press of {RET} with point at the
      end of a menu, quits from the menu.  {RET} with point in a menu prefix
      (before the '>' character), returns to the top-level Hyperbole menu.
      Clicks of the Action Mouse Key do the same thing, so now you can
      navigate and quit from menus with just the Action Mouse Key.

===========================================================================
*   Package Installation
===========================================================================

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, installed and available for use.

Skip the next section and move on to Invocation.

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

Once Hyperbole has been installed for use at your site and loaded into your
Emacs session, it 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.

You can invoke Hyperbole commands in one of three ways:

   use the Hyperbole menu on your menubar;

   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}
   to quit from the menu.

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

Use {C-h h d d} for an interactive demonstration of standard Hyperbole
button capabilities.

{C-h h k e} offers a interactive demonstration of the Koutliner,
Hyperbole's multi-level autonumbered hypertextual outliner.

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
them.

The above are the best interactive ways to learn about Hyperbole.  The
Hyperbole Manual is a reference manual, not a simple introduction.  It 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}/".

-- The End --

RE: ANNOUNCE: GNU Hyperbole 5.15 is released for testing and use

[Drew Adams]

info-gnu-emacs@gnu.org?

Re: ANNOUNCE: GNU Hyperbole 5.15 is released for testing and use

[Robert Weiner]

On Thu, Jul 7, 2016 at 7:37 PM, Drew Adams <drew.adams-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org> wrote:
> info-gnu-emacs-mXXj517/zsQ@public.gmane.org?

I think Hyperbole is pretty far along now.  The main thing it is
lacking is the addition of defcustoms to replace user variables.  We
plan to do this in the next release and this is the main and only reason
left that we have not yet made a full public release.

So my question to you is this: should we make a public release of the current
version 5.15 or will the user-level change of having customizations saved to
their Emacs be so significant that we should wait and just release it when those
are added?

I have not used defcustoms much, so I would like your thoughts on this.

Bob

Re: ANNOUNCE: GNU Hyperbole 5.15 is released for testing and use

[joakim]

Robert Weiner <rsw@gnu.org> writes:

> GNU Hyperbole 5.15 is now available for testing and use with a number
> of 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 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.15
> ===========================================================================
>
>   BUTTONS
>
>     - New Implicit Button Type, debbugs-gnu-mode: When on a GNU Debbugs listing
>       entry in debbugs-gnu-mode, an Action Key press displays the discussion of
>       the selected issue; an Assist Key press pretty prints the status of the
>       issue to a window below the listing window.  This augments the
>       debbugs-gnu-query implicit button type from V5.14 which recognizes
>       bug/issue ids and queries in any buffer.
>
>     - Initial Org Mode Support: The new implicit button type, org-mode, follows
>       Org mode hyperlinks and cycles display views of Org mode outline headings.
>       When on a heading, the Action Key cycles the view of the subtree at point
>       and the Assist Key cycles the view of all headings in the buffer.

Org mode support sounds very interesting, I will give Hyperbole a test!

>
>       Suggest other good ideas for Smart Key actions on Org entities and we'll
>       likely implement them.
>
>     - Links to Info Manual Index Items: You can now drag between windows with
>       the Action Mouse Key depressed to an Info Manual index menu entry to
>       create an explicit button link to it (or use {C-h h e c} with an action
>       type of link-to-Info-index-item).  Then the button will always take you
>       to the line in the manual referenced by that index item.  This also works
>       with other Info menu items and cross-references.  Implicit buttons that
>       reference index items work too, like "(hyperbole)C-c C-m"!  And when you
>       are creating the link, full completion of the file name (within
>       parentheses) and the index item name is provided; just type ? to list
>       completions after typing a few characters.  Since Emacs and most GNU
>       programs include Info manuals, you now have a simple way to link to and
>       jump to any marked item within any manual.
>
>       Previously, when creating a link to an Info manual node, Hyperbole would
>       ignore cross-references and menu items and just link directly to the node
>       rather than anything it referenced.  To get that behavior now, simply
>       link to a place in the node that does not reference another place.
>
>     - Link Button Creation: Hyperbole now shows you what you linked to at
>       global or explicit link button creation time.  Previously, it showed you
>       only the type of the link.  So if you drag across windows from a button
>       label to an Info index item now, you will know that the link goes to the
>       index item entry and not to the index node containing the item reference.
>
>     - New Implicit Button Type, pathname-line-and-column: A whitespace or quote
>       delimited existing pathname followed by a :line-num and an optional
>       :column-num displays the path at line-num and column-num.  So
>       "~/.emacs:10:40" shows your Emacs initialization file at line 10 and
>       column 40. The column number is optional.
>
>     - GNU Info Manual Key Sequences: Previously, Hyperbole recognized key
>       sequences delimited by curly braces only, {}.  Now it recognizes the
>       quotation marks used in GNU Info manuals as well and can execute them
>       with an Action Key press within Info buffers.
>
>     - Imenu Item Recognition: When the Emacs imenu library is in use and an
>       identifier menu has been generated for the current buffer, an Action Key
>       press on an identifier at point jumps to the identifier definition
>       within the current buffer; an Assist Key press prompts with completion
>       for an identifier defined within the buffer and then jumps to its
>       definition.
>
>   DOCUMENTATION
>
>     - Smart Key Debugging: Added a section, "(hyperbole)Smart Key Debugging",
>       to the Hyperbole Manual, documenting the usage of the Customize Menu
>       option, Toggle-Smart-Key-Debug (minibuffer menu Cust/Debug-Toggle,
>       {C-h h c d}).
>
>   KEYS
>
>     - Toggle Hyperbole Keys: The new command, {M-x hyperbole-toggle-bindings
>       RET}, toggles Hyperbole mouse and keyboard keys off and on.  This is not
>       bound to a key because it will make Hyperbole unusable until the keys are
>       re-established with another toggle.  This forces you to know what you are
>       doing before you utilize this feature.
>
>   MENUS
>
>     - Minibuffer Keyboard Direct Selection:  You have always been able to click
>       with your mouse on a minibuffer menu item to directly select it.  Now
>       Hyperbole has the keys {TAB} or {M-f} to move to the next menu item and
>       {Shift-TAB}, {M-TAB} or {M-b} to move to the previous item, with each
>       cycling back when it reaches the end or beginning of the menu.  The
>       fastest way to select minibuffer menu items from the keyboard remains
>       typing the first letter (case-insensitive) of the menu item.
>
>     - Minibuffer Menu Navigation Changes: A press of {RET} with point at the
>       end of a menu, quits from the menu.  {RET} with point in a menu prefix
>       (before the '>' character), returns to the top-level Hyperbole menu.
>       Clicks of the Action Mouse Key do the same thing, so now you can
>       navigate and quit from menus with just the Action Mouse Key.
>
> ===========================================================================
> *   Package Installation
> ===========================================================================
>
> 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, installed and available for use.
>
> Skip the next section and move on to Invocation.
>
> ===========================================================================
> *    Invocation
> ===========================================================================
>
> Once Hyperbole has been installed for use at your site and loaded into your
> Emacs session, it 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.
>
> You can invoke Hyperbole commands in one of three ways:
>
>    use the Hyperbole menu on your menubar;
>
>    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}
>    to quit from the menu.
>
>    use a specific Hyperbole command such as an Action Key click {M-RET} on
>    a pathname to display the associated file or directory.
>
> Use {C-h h d d} for an interactive demonstration of standard Hyperbole
> button capabilities.
>
> {C-h h k e} offers a interactive demonstration of the Koutliner,
> Hyperbole's multi-level autonumbered hypertextual outliner.
>
> 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
> them.
>
> The above are the best interactive ways to learn about Hyperbole.  The
> Hyperbole Manual is a reference manual, not a simple introduction.  It 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}/".
>
> -- The End --
>

-- 
Joakim Verona