From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: joakim@verona.se Newsgroups: gmane.emacs.devel,gmane.emacs.hyperbole.user Subject: Re: ANNOUNCE: GNU Hyperbole 5.15 is released for testing and use Date: Fri, 08 Jul 2016 10:33:24 +0200 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1467966891 5232 80.91.229.3 (8 Jul 2016 08:34:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 8 Jul 2016 08:34:51 +0000 (UTC) Cc: rswgnu@gmail.com, hyperbole-users , emacs-devel To: Robert Weiner Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jul 08 10:34:40 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1bLRF8-00054w-RB for ged-emacs-devel@m.gmane.org; Fri, 08 Jul 2016 10:34:39 +0200 Original-Received: from localhost ([::1]:44257 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bLRF7-0002MB-51 for ged-emacs-devel@m.gmane.org; Fri, 08 Jul 2016 04:34:37 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35097) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bLRET-0002M6-JB for emacs-devel@gnu.org; Fri, 08 Jul 2016 04:33:59 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bLREO-0006aC-JV for emacs-devel@gnu.org; Fri, 08 Jul 2016 04:33:57 -0400 Original-Received: from mx6.bahnhof.se ([213.80.101.16]:64745) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bLREO-0006ZR-8w; Fri, 08 Jul 2016 04:33:52 -0400 Original-Received: from localhost (mf.bahnhof.se [213.80.101.20]) by mx6-reinject (Postfix) with ESMTP id ADFA6445E7; Fri, 8 Jul 2016 10:33:50 +0200 (CEST) X-Virus-Scanned: by amavisd-new using ClamAV at bahnhof.se (MF3) Original-Received: from mf3.bahnhof.se ([127.0.0.1]) by localhost (mf3.bahnhof.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id P3BFLdaPguZA; Fri, 8 Jul 2016 10:33:40 +0200 (CEST) Original-Received: from mta.verona.se (h-235-62.a149.priv.bahnhof.se [85.24.235.62]) by mf3.bahnhof.se (Postfix) with ESMTP id 581AE3E8D02; Fri, 8 Jul 2016 10:33:39 +0200 (CEST) Original-Received: from localhost (unknown [127.0.0.1]) by mta.verona.se (Postfix) with ESMTP id D982D4F59AD; Fri, 8 Jul 2016 08:33:39 +0000 (UTC) X-Virus-Scanned: amavisd-new at verona.se Original-Received: from mta.verona.se ([127.0.0.1]) by localhost (exodia.verona.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ilPCtXcNrdiU; Fri, 8 Jul 2016 10:33:24 +0200 (CEST) Original-Received: from exodia.verona.se (www.verona.se [192.168.200.15]) by mta.verona.se (Postfix) with ESMTP id 220D14F59AA; Fri, 8 Jul 2016 10:33:24 +0200 (CEST) In-Reply-To: (Robert Weiner's message of "Thu, 7 Jul 2016 19:24:30 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.93 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 213.80.101.16 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:205414 gmane.emacs.hyperbole.user:27 Archived-At: Robert Weiner 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