From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Robert Weiner Newsgroups: gmane.emacs.hyperbole.user,gmane.emacs.devel Subject: ANNOUNCE: GNU Hyperbole 5.15 is released for testing and use Date: Thu, 7 Jul 2016 19:24:30 -0400 Message-ID: Reply-To: rswgnu-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1467933921 6215 80.91.229.3 (7 Jul 2016 23:25:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 7 Jul 2016 23:25:21 +0000 (UTC) To: hyperbole-users , emacs-devel Original-X-From: hyperbole-users-bounces+gehu-hyperbole-users=m.gmane.org-mXXj517/zsQ@public.gmane.org Fri Jul 08 01:25:12 2016 Return-path: Envelope-to: gehu-hyperbole-users@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 1bLIfP-0006A2-Eb for gehu-hyperbole-users@m.gmane.org; Fri, 08 Jul 2016 01:25:11 +0200 Original-Received: from localhost ([::1]:42730 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bLIfO-0004xF-2l for gehu-hyperbole-users@m.gmane.org; Thu, 07 Jul 2016 19:25:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37468) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bLIfK-0004wN-Qn for hyperbole-users-mXXj517/zsQ@public.gmane.org; Thu, 07 Jul 2016 19:25:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bLIfH-0002b0-KD for hyperbole-users-mXXj517/zsQ@public.gmane.org; Thu, 07 Jul 2016 19:25:06 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:34977) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bLIfH-0002ab-Gx; Thu, 07 Jul 2016 19:25:03 -0400 Original-Received: from mail-oi0-f47.google.com ([209.85.218.47]:34332) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bLIfF-0000Gd-D6; Thu, 07 Jul 2016 19:25:01 -0400 Original-Received: by mail-oi0-f47.google.com with SMTP id s66so44486020oif.1; Thu, 07 Jul 2016 16:25:01 -0700 (PDT) X-Gm-Message-State: ALyK8tKqYUOrxeD1uMoipg9RJRBwB4hmNXwc/R+XUvJp1YOxAj9nHMebX8ZUUNGgv2z27sB68qoLN5SsJHebOw== X-Received: by 10.202.192.214 with SMTP id q205mr1652485oif.176.1467933900313; Thu, 07 Jul 2016 16:25:00 -0700 (PDT) Original-Received: by 10.202.212.143 with HTTP; Thu, 7 Jul 2016 16:24:30 -0700 (PDT) X-Gmail-Original-Message-ID: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: hyperbole-users-mXXj517/zsQ@public.gmane.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: User list for GNU Hyperbole List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: hyperbole-users-bounces+gehu-hyperbole-users=m.gmane.org-mXXj517/zsQ@public.gmane.org Original-Sender: "Hyperbole-users" Xref: news.gmane.org gmane.emacs.hyperbole.user:24 gmane.emacs.devel:205388 Archived-At: 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 --