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 -- _______________________________________________ Hyperbole-users mailing list [email protected] https://lists.gnu.org/mailman/listinfo/hyperbole-users
