[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/hyperbole ad16470 13/50: Document Koutline Org table su
|
From: |
Stefan Monnier |
|
Subject: |
[elpa] externals/hyperbole ad16470 13/50: Document Koutline Org table support; allow ibtype reprioritization |
|
Date: |
Wed, 17 Mar 2021 18:44:14 -0400 (EDT) |
branch: externals/hyperbole
commit ad16470e2edb2994f2871a5d73a1107b79fe13f0
Author: Bob Weiner <rsw@gnu.org>
Commit: Bob Weiner <rsw@gnu.org>
Document Koutline Org table support; allow ibtype reprioritization
---
Changes | 15 +
HY-ABOUT | 2 +-
HY-NEWS | 17 +-
Makefile | 2 +-
README.md | 2 +-
README.md.html | 915 ++++++++++++++++++++++++++---------------------------
hact.el | 4 +
hargs.el | 2 +-
hib-debbugs.el | 9 +-
hib-kbd.el | 6 +-
hibtypes.el | 79 +++--
hpath.el | 2 +-
hversion.el | 2 +-
hyperbole.el | 4 +-
man/hyperbole.html | 133 ++++----
man/hyperbole.info | Bin 534000 -> 534039 bytes
man/hyperbole.pdf | Bin 1289960 -> 1289865 bytes
man/hyperbole.texi | 131 ++++----
man/version.texi | 8 +-
19 files changed, 694 insertions(+), 639 deletions(-)
diff --git a/Changes b/Changes
index ef22b51..a624e46 100644
--- a/Changes
+++ b/Changes
@@ -1,3 +1,18 @@
+2020-10-25 Bob Weiner <rsw@gnu.org>
+
+* hibtypes.el:
+ man/hyperbole.texi (Implicit Button Types): Updated doc.
+
+2020-10-22 Bob Weiner <rsw@gnu.org>
+
+* hact.el (symset:clear): Added to empty a symset like ibtypes to reset
+ ibtype priorities.
+ hibtypes.el: Changed require to load for all hibtype files so are always
+ added when the ibtype priority list is reset.
+
+* hibtypes.el (hib-org): Moved Org links to lowest priority so
+ all implicit button types can be used in Org mode.
+
2020-10-18 Bob Weiner <rsw@gnu.org>
* hypb.el (hypb:replace-match-string):
diff --git a/HY-ABOUT b/HY-ABOUT
index afed370..d15d94f 100644
--- a/HY-ABOUT
+++ b/HY-ABOUT
@@ -3,7 +3,7 @@
Designed and Written by Bob Weiner
Maintained by Mats Lidell and Bob Weiner
https://www.gnu.org/software/hyperbole/
- Version 7.1.3
+ Version 7.1.4
Say thanks or send a testimonial if you like Hyperbole:
Email: <rsw@gnu.org>
diff --git a/HY-NEWS b/HY-NEWS
index 175f539..9eaa6c6 100644
--- a/HY-NEWS
+++ b/HY-NEWS
@@ -7,11 +7,11 @@
KOUTLINER
- * Org Table Support: Org table editing now automatically works in the
+ - Org Table Support: Org table editing now automatically works in the
Koutliner via Org table minor mode. Use {M-x orgtbl-mode RET} to
toggle this on and off. See "(Org)Tables" for details.
- * New Tree Demotion/Promotion Keys: Tree promotion and demotion keys now
+ - New Tree Demotion/Promotion Keys: Tree promotion and demotion keys now
match the defaults in Org mode and Outline mode, plus some easier to
type ones. The tables below summarize which keys work whether inside
an Org table or outside.
@@ -28,6 +28,19 @@
| C-c C-, | C-c C-. |
| C-c C-< | C-c C-> |
+ SMART (ACTION AND ASSIST) KEYS
+
+ - Implicit Button Types Reprioritization: Modified hibtypes.el so if
+ evaluate: (symset:clear 'ibtypes) and then reload hibtypes.{el,elc},
+ the priority order of all implicit button types is reset.
+
+ - Org Mode: Lowered to near bottom implicit button priority so that all
+ implicit button types will work in Org mode.
+
+ - Pathname Implicit Buttons: Variable substitutions are now made with
+ fixed case, so that the case of a value with both upper and lower
+ case characters is never changed, for example a value of ${HOME}.
+
===========================================================================
* V7.1.3
===========================================================================
diff --git a/Makefile b/Makefile
index b4ea0a8..feb8cba 100644
--- a/Makefile
+++ b/Makefile
@@ -63,7 +63,7 @@
# This ver setup won't work under any make except GNU make, so set it manually.
#HYPB_VERSION = "`head -3 hversion.el | tail -1 | sed -e 's/.*|\(.*\)|.*/\1/'`"
-HYPB_VERSION = 7.1.3
+HYPB_VERSION = 7.1.4
# Emacs executable used to byte-compile .el files into .elc's.
# Possibilities include: emacs, infodock, etc.
diff --git a/README.md b/README.md
index b866918..0066ff7 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# GNU Hyperbole 7.1.3 - The Everyday Hypertextual Information Manager
+# GNU Hyperbole 7.1.4 - The Everyday Hypertextual Information Manager
[Say thanks or send a testimonial if you like Hyperbole.(mailto:rsw@gnu.org)]
diff --git a/README.md.html b/README.md.html
index 6609767..4e8d69d 100644
--- a/README.md.html
+++ b/README.md.html
@@ -1,147 +1,147 @@
<h1>
-<a
id="user-content-gnu-hyperbole-713---the-everyday-hypertextual-information-manager"
class="anchor"
href="#gnu-hyperbole-713---the-everyday-hypertextual-information-manager"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>GNU Hyperbole 7.1.3 - The Everyday Hypertextual
Information Manager</h1>
+ <a
id="user-content-gnu-hyperbole-713---the-everyday-hypertextual-information-manager"
class="anchor"
href="#gnu-hyperbole-713---the-everyday-hypertextual-information-manager"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>GNU Hyperbole 7.1.4 - The Everyday Hypertextual
Information Manager</h1>
<p>[Say thanks or send a testimonial if you like Hyperbole.(mailto:<a
href="mailto:rsw@gnu.org";>rsw@gnu.org</a>)]</p>
<p><strong>Table of Contents</strong></p>
<ul>
-<li><a href="#summary">Summary</a></li>
-<li><a href="#mailing-lists">Mailing Lists</a></li>
-<li><a href="#ftp-and-git-repository-downloads">Ftp and Git Repository
Downloads</a></li>
-<li><a href="#installation">Installation</a></li>
-<li><a href="#invocation">Invocation</a></li>
-<li><a href="#hyperbole-components">Hyperbole Components</a></li>
-<li><a href="#hyperbole-buttons">Hyperbole Buttons</a></li>
-<li><a href="#important-features">Important Features</a></li>
-<li><a href="#hyperbole-uses">Hyperbole Uses</a></li>
-<li><a href="#files">Files</a></li>
-<li><a href="#programmer-quick-reference">Programmer Quick Reference</a></li>
-<li><a href="#user-quotes">User Quotes</a></li>
-<li><a href="#why-was-hyperbole-developed">Why was Hyperbole
developed?</a></li>
+ <li><a href="#summary">Summary</a></li>
+ <li><a href="#mailing-lists">Mailing Lists</a></li>
+ <li><a href="#ftp-and-git-repository-downloads">Ftp and Git Repository
Downloads</a></li>
+ <li><a href="#installation">Installation</a></li>
+ <li><a href="#invocation">Invocation</a></li>
+ <li><a href="#hyperbole-components">Hyperbole Components</a></li>
+ <li><a href="#hyperbole-buttons">Hyperbole Buttons</a></li>
+ <li><a href="#important-features">Important Features</a></li>
+ <li><a href="#hyperbole-uses">Hyperbole Uses</a></li>
+ <li><a href="#files">Files</a></li>
+ <li><a href="#programmer-quick-reference">Programmer Quick Reference</a></li>
+ <li><a href="#user-quotes">User Quotes</a></li>
+ <li><a href="#why-was-hyperbole-developed">Why was Hyperbole
developed?</a></li>
</ul>
<p><a href="man/im/hyperbole-cv.png" target="_blank" rel="noopener
noreferrer"><img src="man/im/hyperbole-cv.png" alt="Hyperbole screenshot of the
Koutliner, DEMO file and HyRolo" style="max-width:100%;"></a></p>
<h2>
-<a id="user-content-summary" class="anchor" href="#summary"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Summary</h2>
+ <a id="user-content-summary" class="anchor" href="#summary"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Summary</h2>
<p><code>GNU Hyperbole</code> (pronounced Ga-new Hi-per-bo-lee), or just
<code>Hyperbole</code>,
-is an easy-to-use, yet powerful and programmable hypertextual information
-management system implemented as a GNU Emacs package. It offers rapid views
-and interlinking of all kinds of textual information, utilizing Emacs for
-editing. It can dramatically increase your productivity and greatly reduce
-the number of keyboard/mouse keys you'll need to work efficiently.</p>
+ is an easy-to-use, yet powerful and programmable hypertextual information
+ management system implemented as a GNU Emacs package. It offers rapid views
+ and interlinking of all kinds of textual information, utilizing Emacs for
+ editing. It can dramatically increase your productivity and greatly reduce
+ the number of keyboard/mouse keys you'll need to work efficiently.</p>
<p>Hyperbole lets you:</p>
<ol>
-<li>
-<p>Quickly create hyperlink buttons either from the keyboard or by dragging
-between a source and destination window with a mouse button depressed.
-Later, activate buttons by pressing/clicking on them or by giving the
-name of the button.</p>
-</li>
-<li>
-<p>Activate many kinds of <code>implicit buttons</code> recognized by context
-within text buffers, e.g. URLs, grep output lines, and git commits.
-A single key or mouse button automatically does the right thing in
-dozens of contexts; just press and go.</p>
-</li>
-<li>
-<p>Build outlines with multi-level numbered outline nodes, e.g. 1.4.8.6,
-that all renumber automatically as any node or tree is moved in the
-outline. Each node also has a permanent hyperlink anchor that you can
-reference from any other node;</p>
-</li>
-<li>
-<p>Manage all your contacts quickly with hierarchical categories and
-embed hyperlinks within each entry. Or create an archive of documents
-with hierarchical entries and use the same search mechanism to quickly
-find any matching entry;</p>
-</li>
-<li>
-<p>Use single keys to easily manage your Emacs windows or frames and
-quickly retrieve saved window and frame configurations;</p>
-</li>
-<li>
-<p>Search for things in your current buffers, in a directory tree or
-across major web search engines with the touch of a few keys.</p>
-</li>
+ <li>
+ <p>Quickly create hyperlink buttons either from the keyboard or by dragging
+ between a source and destination window with a mouse button depressed.
+ Later, activate buttons by pressing/clicking on them or by giving the
+ name of the button.</p>
+ </li>
+ <li>
+ <p>Activate many kinds of <code>implicit buttons</code> recognized by
context
+ within text buffers, e.g. URLs, grep output lines, and git commits.
+ A single key or mouse button automatically does the right thing in
+ dozens of contexts; just press and go.</p>
+ </li>
+ <li>
+ <p>Build outlines with multi-level numbered outline nodes, e.g. 1.4.8.6,
+ that all renumber automatically as any node or tree is moved in the
+ outline. Each node also has a permanent hyperlink anchor that you can
+ reference from any other node;</p>
+ </li>
+ <li>
+ <p>Manage all your contacts quickly with hierarchical categories and
+ embed hyperlinks within each entry. Or create an archive of documents
+ with hierarchical entries and use the same search mechanism to quickly
+ find any matching entry;</p>
+ </li>
+ <li>
+ <p>Use single keys to easily manage your Emacs windows or frames and
+ quickly retrieve saved window and frame configurations;</p>
+ </li>
+ <li>
+ <p>Search for things in your current buffers, in a directory tree or
+ across major web search engines with the touch of a few keys.</p>
+ </li>
</ol>
<p>The common thread in all these features is making retrieval,
-management and display of information fast and easy. That is
-Hyperbole's purpose. It may be broad but it works amazingly well. If
-it is textual information, Hyperbole can work with it. In contrast to
-Org mode, Hyperbole works across all Emacs modes and speeds your work
-by turning all kinds of references into clickable hyperlinks and
-allowing you to create new hyperlinks by dragging between two windows.
-The <a href="https://www.emacswiki.org/emacs/Hyperbole";
rel="nofollow">Hyperbole wiki page</a>
-explains the many ways it differs from and is complementary to Org
-mode.</p>
+ management and display of information fast and easy. That is
+ Hyperbole's purpose. It may be broad but it works amazingly well. If
+ it is textual information, Hyperbole can work with it. In contrast to
+ Org mode, Hyperbole works across all Emacs modes and speeds your work
+ by turning all kinds of references into clickable hyperlinks and
+ allowing you to create new hyperlinks by dragging between two windows.
+ The <a href="https://www.emacswiki.org/emacs/Hyperbole";
rel="nofollow">Hyperbole wiki page</a>
+ explains the many ways it differs from and is complementary to Org
+ mode.</p>
<p>Hyperbole allows hypertext buttons to be embedded within unstructured
-and structured files, mail messages and news articles. It offers
-intuitive keyboard and mouse-based control of information display
-within multiple windows. It also provides point-and-click access to
-World-Wide Web URLs, Info manuals, ftp archives, etc.</p>
+ and structured files, mail messages and news articles. It offers
+ intuitive keyboard and mouse-based control of information display
+ within multiple windows. It also provides point-and-click access to
+ World-Wide Web URLs, Info manuals, ftp archives, etc.</p>
<p>Hyperbole includes easy-to-use, powerful hypertextual button types
-without the need to learn a markup language. Hyperbole's button types
-are written in Lisp and can be wholly independent of the web, i.e. web
-links are one type of Hyperbole link, not fundamental to its link
-architecture. However, Hyperbole is a great assistant when editing
-HTML or Javascript or when browsing web pages and links.</p>
+ without the need to learn a markup language. Hyperbole's button types
+ are written in Lisp and can be wholly independent of the web, i.e. web
+ links are one type of Hyperbole link, not fundamental to its link
+ architecture. However, Hyperbole is a great assistant when editing
+ HTML or Javascript or when browsing web pages and links.</p>
<p>Hyperbole is something to be experienced and interacted with, not
-understood from reading alone. If you like an Emacs package to do
-only one thing than Hyperbole is not for you, but if you would
-rather learn fewer packages and get more work done faster, then
-Hyperbole is for you.</p>
+ understood from reading alone. If you like an Emacs package to do
+ only one thing than Hyperbole is not for you, but if you would
+ rather learn fewer packages and get more work done faster, then
+ Hyperbole is for you.</p>
<p>Hyperbole works well on GNU Emacs 24.4 or above. It is designed and
-written by Bob Weiner. It is maintained by him and Mats Lidell. Its
-main distribution site is: <a href="https://www.gnu.org/software/hyperbole/";
rel="nofollow">https://www.gnu.org/software/hyperbole/</a>.
-If any term in here is new or unfamiliar to you, you can look it up in the
-<a href="man/hyperbole.html#Glossary">Hyperbole Glossary</a>.</p>
+ written by Bob Weiner. It is maintained by him and Mats Lidell. Its
+ main distribution site is: <a href="https://www.gnu.org/software/hyperbole/";
rel="nofollow">https://www.gnu.org/software/hyperbole/</a>.
+ If any term in here is new or unfamiliar to you, you can look it up in the
+ <a href="man/hyperbole.html#Glossary">Hyperbole Glossary</a>.</p>
<p>Hyperbole is available for <a href="#installation">download and
installation</a>
-through the GNU Emacs package manager.</p>
+ through the GNU Emacs package manager.</p>
<h2>
-<a id="user-content-mailing-lists" class="anchor" href="#mailing-lists"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Mailing Lists</h2>
+ <a id="user-content-mailing-lists" class="anchor" href="#mailing-lists"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Mailing Lists</h2>
<ul>
-<li>
-<p><strong><a
href="mailto:hyperbole-users@gnu.org";>hyperbole-users@gnu.org</a></strong> -
User list for GNU Hyperbole</p>
-</li>
-<li>
-<p><strong><a
href="mailto:bug-hyperbole@gnu.org";>bug-hyperbole@gnu.org</a></strong> - List
for bug reporting</p>
-</li>
+ <li>
+ <p><strong><a
href="mailto:hyperbole-users@gnu.org";>hyperbole-users@gnu.org</a></strong> -
User list for GNU Hyperbole</p>
+ </li>
+ <li>
+ <p><strong><a
href="mailto:bug-hyperbole@gnu.org";>bug-hyperbole@gnu.org</a></strong> - List
for bug reporting</p>
+ </li>
</ul>
<h2>
-<a id="user-content-ftp-and-git-repository-downloads" class="anchor"
href="#ftp-and-git-repository-downloads" aria-hidden="true"><span
aria-hidden="true" class="octicon octicon-link"></span></a>Ftp and Git
Repository Downloads</h2>
+ <a id="user-content-ftp-and-git-repository-downloads" class="anchor"
href="#ftp-and-git-repository-downloads" aria-hidden="true"><span
aria-hidden="true" class="octicon octicon-link"></span></a>Ftp and Git
Repository Downloads</h2>
<p>To inspect the Hyperbole source code online rather than installing it for
-use (which will also give you the source code), open a web page to:</p>
+ use (which will also give you the source code), open a web page to:</p>
<ul>
-<li><a href="https://git.savannah.gnu.org/cgit/hyperbole.git/tree/";
rel="nofollow">https://git.savannah.gnu.org/cgit/hyperbole.git/tree/</a></li>
+ <li><a href="https://git.savannah.gnu.org/cgit/hyperbole.git/tree/";
rel="nofollow">https://git.savannah.gnu.org/cgit/hyperbole.git/tree/</a></li>
</ul>
<p>Alternatively, you may download a tar.gz source archive from either:</p>
<ul>
-<li>
-<p><a href="ftp://ftp.gnu.org/gnu/hyperbole/";
rel="nofollow">ftp://ftp.gnu.org/gnu/hyperbole/</a></p>
-</li>
-<li>
-<p><a href="http://ftpmirror.gnu.org/hyperbole/";
rel="nofollow">http://ftpmirror.gnu.org/hyperbole/</a></p>
-</li>
+ <li>
+ <p><a href="ftp://ftp.gnu.org/gnu/hyperbole/";
rel="nofollow">ftp://ftp.gnu.org/gnu/hyperbole/</a></p>
+ </li>
+ <li>
+ <p><a href="http://ftpmirror.gnu.org/hyperbole/";
rel="nofollow">http://ftpmirror.gnu.org/hyperbole/</a></p>
+ </li>
</ul>
<p>which will find the closest mirror of the GNU ftp site and show it to
you.</p>
<p>If you want to follow along with Hyperbole development and maintain a
-copy/clone of the current version-controlled git tree, use a
-<a href="https://savannah.gnu.org/git/?group=hyperbole"; rel="nofollow">command
listed here</a>
-to clone the Hyperbole project tree.</p>
+ copy/clone of the current version-controlled git tree, use a
+ <a href="https://savannah.gnu.org/git/?group=hyperbole";
rel="nofollow">command listed here</a>
+ to clone the Hyperbole project tree.</p>
<h2>
-<a id="user-content-installation" class="anchor" href="#installation"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Installation</h2>
+ <a id="user-content-installation" class="anchor" href="#installation"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Installation</h2>
<p>Once you have Emacs set up at your site, GNU Hyperbole may be
-installed by using the Emacs Package Manager. If you are not
-familiar with it, see the Packages section of the GNU Emacs Manual,
-<a
href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html";
rel="nofollow">Emacs Packages</a>.</p>
+ installed by using the Emacs Package Manager. If you are not
+ familiar with it, see the Packages section of the GNU Emacs Manual,
+ <a
href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html";
rel="nofollow">Emacs Packages</a>.</p>
<p>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} key followed by the {x} key to upgrade all out-of-date
-packages, Hyperbole among them. Then skip the text below and move on to
-the next section, <a href="#invocation">Invocation</a>.</p>
+ upgrade it, invoke the Emacs Package Manager with {M-x list-packages RET},
+ then use the {U} key followed by the {x} key to upgrade all out-of-date
+ packages, Hyperbole among them. Then skip the text below and move on to
+ the next section, <a href="#invocation">Invocation</a>.</p>
<p>Otherwise, to download and install the Hyperbole package, you should
-add several lines to your personal Emacs initialization file,
-typically "~/.emacs". For further details, see <a
href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Init-File.html";
rel="nofollow">Emacs Init
-File</a>.</p>
+ add several lines to your personal Emacs initialization file,
+ typically "~/.emacs". For further details, see <a
href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Init-File.html";
rel="nofollow">Emacs Init
+ File</a>.</p>
<p>Below are the lines to add:</p>
<pre><code>(require 'package)
(setq package-enable-at-startup nil) ;; Prevent double loading of libraries
@@ -153,281 +153,281 @@ File</a>.</p>
</code></pre>
<hr>
<p>Now save the file and then restart Emacs. Hyperbole will then be
-downloaded and compiled for use with your version of Emacs; give it a
-minute or two. You may see a bunch of compilation warnings but these
-can be safely ignored.</p>
+ downloaded and compiled for use with your version of Emacs; give it a
+ minute or two. You may see a bunch of compilation warnings but these
+ can be safely ignored.</p>
<h2>
-<a id="user-content-invocation" class="anchor" href="#invocation"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Invocation</h2>
+ <a id="user-content-invocation" class="anchor" href="#invocation"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Invocation</h2>
<p>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.</p>
+ 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.</p>
<p>You can invoke Hyperbole commands in one of three ways:</p>
<p>use the Hyperbole menu on your menubar;</p>
<p><a href="man/im/menu-hyperbole.png" target="_blank" rel="noopener
noreferrer"><img src="man/im/menu-hyperbole.png" alt="Hyperbole Menubar Menu"
style="max-width:100%;"></a></p>
<p>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.</p>
+ 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.</p>
<p>use a specific Hyperbole command such as an Action Key click {M-RET} on
-a pathname to display the associated file or directory.</p>
+ a pathname to display the associated file or directory.</p>
<p>Use {C-h h d d} for an interactive demonstration of standard Hyperbole
-button capabilities.</p>
+ button capabilities.</p>
<p><a href="man/im/demo.png" target="_blank" rel="noopener noreferrer"><img
src="man/im/demo.png" alt="Hyperbole screenshot of the DEMO"
style="max-width:100%;"></a></p>
<p>{C-h h k e} offers an interactive demonstration of the Koutliner,
-Hyperbole's multi-level autonumbered hypertextual outliner.</p>
+ Hyperbole's multi-level autonumbered hypertextual outliner.</p>
<p><a href="man/im/koutliner.png" target="_blank" rel="noopener
noreferrer"><img src="man/im/koutliner.png" alt="Hyperbole screenshot of the
Koutliner" style="max-width:100%;"></a></p>
<p>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. Hyperbole also binds {C-c } for quick access to HyControl's
-window control menu if it was not already bound prior to Hyperbole's
-initialization. A long video demonstrating many of HyControl's
-features is available at <a href="https://youtu.be/M3-aMh1ccJk";
rel="nofollow">https://youtu.be/M3-aMh1ccJk</a>.</p>
+ 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. Hyperbole also binds {C-c } for quick access to HyControl's
+ window control menu if it was not already bound prior to Hyperbole's
+ initialization. A long video demonstrating many of HyControl's
+ features is available at <a href="https://youtu.be/M3-aMh1ccJk";
rel="nofollow">https://youtu.be/M3-aMh1ccJk</a>.</p>
<p>The above are the best interactive ways to learn about Hyperbole.
-Hyperbole also includes the Hyperbole Manual, a full reference manual,
-not a simple introduction. It is included in the "man/" subdirectory
-of the Hyperbole package directory in four forms:</p>
+ Hyperbole also includes the Hyperbole Manual, a full reference manual,
+ not a simple introduction. It is included in the "man/" subdirectory
+ of the Hyperbole package directory in four forms:</p>
<p><a href="man/hyperbole.info">hyperbole.info</a> - online Info browser
version<br>
-<a href="man/hyperbole.html">hyperbole.html</a> - web HTML version<br>
-<a href="man/hyperbole.pdf">hyperbole.pdf</a> - printable version<br>
-<a href="man/hyperbole.texi">hyperbole.texi</a> - source form</p>
+ <a href="man/hyperbole.html">hyperbole.html</a> - web HTML version<br>
+ <a href="man/hyperbole.pdf">hyperbole.pdf</a> - printable version<br>
+ <a href="man/hyperbole.texi">hyperbole.texi</a> - source form</p>
<p>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}/".</p>
+ 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}/".</p>
<h2>
-<a id="user-content-hyperbole-components" class="anchor"
href="#hyperbole-components" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Hyperbole Components</h2>
+ <a id="user-content-hyperbole-components" class="anchor"
href="#hyperbole-components" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Hyperbole Components</h2>
<p>Hyperbole consists of five parts:</p>
<ol>
-<li>
-<p><strong>Buttons and Smart Keys</strong>: A set of hyperbutton types which
supply
-core hypertext and other behaviors. Buttons may be added to
-documents (explicit buttons) with a simple drag between windows,
-no markup language needed. Implicit buttons are patterns
-automatically recognized within text that perform actions,
-e.g. bug#24568 displays the bug status information for that bug
-number.</p>
-<p>These actions may be links or arbitrary Lisp expressions. So
-for example, you could create your own button type of
-Wikipedia searches that jumped to the named Wikipedia page
-whenever point was within text of the form [wp].
-You define the pattern so {} might do the same
-thing if you preferred. And this works within any Emacs
-buffer you want it to, regardless of major or minor mode.</p>
-<p>Buttons are accessed by clicking on them or referenced by name
-(global buttons), so they can be activated regardless of what is
-on screen. Users can make simple changes to button types and
-those familiar with Emacs Lisp can prototype and deliver new
-types quickly with just a few lines of code.</p>
-<p>Hyperbole includes two special `Smart Keys', the Action Key
-and the Assist Key, that perform an extensive array of
-context-sensitive operations across emacs usage, including
-activating and showing help for Hyperbole buttons. In many
-popular Emacs modes, they allow you to perform common, sometimes
-complex operations without having to use a different key for each
-operation. Just press a Smart Key and the right thing happens;</p>
-</li>
-<li>
-<p><strong>Contact and Text Finder</strong>: an interactive textual information
-management interface, including fast, flexible file and text
-finding commands. A powerful, hierarchical contact manager,
-HyRolo, which anyone can use is also included. It is easy to
-learn to use since it introduces only a few new mechanisms and
-has a menu interface, which may be operated from the keyboard or
-the mouse.</p>
-<p><a href="man/im/menu-rolo.png" target="_blank" rel="noopener
noreferrer"><img src="man/im/menu-rolo.png" alt="HyRolo Menubar Menu"
style="max-width:100%;"></a></p>
-</li>
-<li>
-<p><strong>Screen Control</strong>: Hyperbole includes HyControl, the fastest,
-easiest-to-use window and frame control available for GNU
-Emacs. With just a few keystrokes, you can shift from
-increasing a window's height by 5 lines to moving a frame by
-220 pixels or immediately moving it to a screen corner. Text
-in each window or frame may be enlarged or shrunk (zoomed) for
-easy viewing, plus many other features;</p>
-<p>The broader vision for HyControl is to support persistent
-window and frame configurations as link targets. Then a user
-will be able to create the views of information he wants and
-store them as links for rapid display. Work remains to
-implement this feature but it helps explain the connection of
-HyControl to the rest of Hyperbole;</p>
-</li>
-<li>
-<p><strong>The Koutliner</strong>: an advanced outliner with multi-level
-autonumbering and permanent ids attached to each outline node for
-use as hypertext link anchors, per node properties and flexible
-view specifications that can be embedded within links or used
-interactively;</p>
-</li>
-<li>
-<p><strong>Programming Library</strong>: a set of programming library classes
for
-system developers who want to integrate Hyperbole with another
-user interface or as a back-end to a distinct system. (All of
-Hyperbole is written in Emacs Lisp for ease of modification.
-Hyperbole has been engineered for real-world usage and is well
-structured).</p>
-</li>
+ <li>
+ <p><strong>Buttons and Smart Keys</strong>: A set of hyperbutton types
which supply
+ core hypertext and other behaviors. Buttons may be added to
+ documents (explicit buttons) with a simple drag between windows,
+ no markup language needed. Implicit buttons are patterns
+ automatically recognized within text that perform actions,
+ e.g. bug#24568 displays the bug status information for that bug
+ number.</p>
+ <p>These actions may be links or arbitrary Lisp expressions. So
+ for example, you could create your own button type of
+ Wikipedia searches that jumped to the named Wikipedia page
+ whenever point was within text of the form [wp].
+ You define the pattern so {} might do the same
+ thing if you preferred. And this works within any Emacs
+ buffer you want it to, regardless of major or minor mode.</p>
+ <p>Buttons are accessed by clicking on them or referenced by name
+ (global buttons), so they can be activated regardless of what is
+ on screen. Users can make simple changes to button types and
+ those familiar with Emacs Lisp can prototype and deliver new
+ types quickly with just a few lines of code.</p>
+ <p>Hyperbole includes two special `Smart Keys', the Action Key
+ and the Assist Key, that perform an extensive array of
+ context-sensitive operations across emacs usage, including
+ activating and showing help for Hyperbole buttons. In many
+ popular Emacs modes, they allow you to perform common, sometimes
+ complex operations without having to use a different key for each
+ operation. Just press a Smart Key and the right thing happens;</p>
+ </li>
+ <li>
+ <p><strong>Contact and Text Finder</strong>: an interactive textual
information
+ management interface, including fast, flexible file and text
+ finding commands. A powerful, hierarchical contact manager,
+ HyRolo, which anyone can use is also included. It is easy to
+ learn to use since it introduces only a few new mechanisms and
+ has a menu interface, which may be operated from the keyboard or
+ the mouse.</p>
+ <p><a href="man/im/menu-rolo.png" target="_blank" rel="noopener
noreferrer"><img src="man/im/menu-rolo.png" alt="HyRolo Menubar Menu"
style="max-width:100%;"></a></p>
+ </li>
+ <li>
+ <p><strong>Screen Control</strong>: Hyperbole includes HyControl, the
fastest,
+ easiest-to-use window and frame control available for GNU
+ Emacs. With just a few keystrokes, you can shift from
+ increasing a window's height by 5 lines to moving a frame by
+ 220 pixels or immediately moving it to a screen corner. Text
+ in each window or frame may be enlarged or shrunk (zoomed) for
+ easy viewing, plus many other features;</p>
+ <p>The broader vision for HyControl is to support persistent
+ window and frame configurations as link targets. Then a user
+ will be able to create the views of information he wants and
+ store them as links for rapid display. Work remains to
+ implement this feature but it helps explain the connection of
+ HyControl to the rest of Hyperbole;</p>
+ </li>
+ <li>
+ <p><strong>The Koutliner</strong>: an advanced outliner with multi-level
+ autonumbering and permanent ids attached to each outline node for
+ use as hypertext link anchors, per node properties and flexible
+ view specifications that can be embedded within links or used
+ interactively;</p>
+ </li>
+ <li>
+ <p><strong>Programming Library</strong>: a set of programming library
classes for
+ system developers who want to integrate Hyperbole with another
+ user interface or as a back-end to a distinct system. (All of
+ Hyperbole is written in Emacs Lisp for ease of modification.
+ Hyperbole has been engineered for real-world usage and is well
+ structured).</p>
+ </li>
</ol>
<p>We find Hyperbole's parts are more powerful as one package, i.e. the
-sum is greater than the parts, so we don't offer them separately.
-Hyperbole is free software, however, so you may modify it as you see
-fit.</p>
+ sum is greater than the parts, so we don't offer them separately.
+ Hyperbole is free software, however, so you may modify it as you see
+ fit.</p>
<h2>
-<a id="user-content-hyperbole-buttons" class="anchor"
href="#hyperbole-buttons" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Hyperbole Buttons</h2>
+ <a id="user-content-hyperbole-buttons" class="anchor"
href="#hyperbole-buttons" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Hyperbole Buttons</h2>
<p>A Hyperbole hypertext user works with buttons; he may create, modify, move
-or delete buttons. Each button performs a specific action, such as linking
-to a file or executing a shell command.</p>
+ or delete buttons. Each button performs a specific action, such as linking
+ to a file or executing a shell command.</p>
<p>There are three categories of Hyperbole buttons:</p>
<ol>
-<li>
-<p><em>Explicit Buttons</em>
-created by Hyperbole, accessible from within a single document;</p>
-</li>
-<li>
-<p><em>Global Buttons</em>
-created by Hyperbole, accessible anywhere within a user's
-network of documents;</p>
-</li>
-<li>
-<p><em>Implicit Buttons</em>
-buttons created and managed by other programs or embedded
-within the structure of a document, accessible from within a
-single document. Hyperbole recognizes implicit buttons by
-contextual patterns given in their type specifications.</p>
-</li>
+ <li>
+ <p><em>Explicit Buttons</em>
+ created by Hyperbole, accessible from within a single document;</p>
+ </li>
+ <li>
+ <p><em>Global Buttons</em>
+ created by Hyperbole, accessible anywhere within a user's
+ network of documents;</p>
+ </li>
+ <li>
+ <p><em>Implicit Buttons</em>
+ buttons created and managed by other programs or embedded
+ within the structure of a document, accessible from within a
+ single document. Hyperbole recognizes implicit buttons by
+ contextual patterns given in their type specifications.</p>
+ </li>
</ol>
<p>Hyperbole buttons may be clicked upon with a mouse to activate them or to
-describe their actions. Thus, a user can always check how a button will act
-before activating it. Buttons may also be activated from a keyboard. (In
-fact, virtually all Hyperbole operations, including menu usage, may be
-performed from any standard terminal interface, so one can use it on distant
-machines that provide limited display access).</p>
+ describe their actions. Thus, a user can always check how a button will act
+ before activating it. Buttons may also be activated from a keyboard. (In
+ fact, virtually all Hyperbole operations, including menu usage, may be
+ performed from any standard terminal interface, so one can use it on distant
+ machines that provide limited display access).</p>
<p>Hyperbole does not enforce any particular hypertext or information
-management model, but instead allows you to organize your information in
-large or small chunks as you see fit, organizing each bit as time allows.
-The Hyperbole Koutliner and HyRolo tools organize textual hierarchies and
-may also contain links to external information sources.</p>
+ management model, but instead allows you to organize your information in
+ large or small chunks as you see fit, organizing each bit as time allows.
+ The Hyperbole Koutliner and HyRolo tools organize textual hierarchies and
+ may also contain links to external information sources.</p>
<h2>
-<a id="user-content-important-features" class="anchor"
href="#important-features" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Important Features</h2>
+ <a id="user-content-important-features" class="anchor"
href="#important-features" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Important Features</h2>
<p>Some of Hyperbole's most important features include:</p>
<ul>
-<li>
-<p>Buttons may link to information or may execute commands, such as
-computing a complex value or communicating with external programs;</p>
-</li>
-<li>
-<p>Buttons are quick and easy to create with no programming nor
-markup needed. One simply drags between a button source location
-and a link destination to create or to modify a link button. The
-same result can be achieved from the keyboard.</p>
-</li>
-<li>
-<p>Buttons may be embedded within email messages and activated from
-Emacs mail readers; hyperlinks may include variables so that they
-work at different locations where the variable settings differ;</p>
-</li>
-<li>
-<p>Koutlines allow rapid browsing, editing and movement of chunks of
-information organized into trees (hierarchies) and offer links
-that include viewspecs which determine how documents are to be
-displayed, e.g. show just the first two lines of all levels in a
-Koutline;</p>
-</li>
-<li>
-<p>Other hypertext and information retrieval systems may be
-encapsulated under a Hyperbole user interface very easily.</p>
-</li>
+ <li>
+ <p>Buttons may link to information or may execute commands, such as
+ computing a complex value or communicating with external programs;</p>
+ </li>
+ <li>
+ <p>Buttons are quick and easy to create with no programming nor
+ markup needed. One simply drags between a button source location
+ and a link destination to create or to modify a link button. The
+ same result can be achieved from the keyboard.</p>
+ </li>
+ <li>
+ <p>Buttons may be embedded within email messages and activated from
+ Emacs mail readers; hyperlinks may include variables so that they
+ work at different locations where the variable settings differ;</p>
+ </li>
+ <li>
+ <p>Koutlines allow rapid browsing, editing and movement of chunks of
+ information organized into trees (hierarchies) and offer links
+ that include viewspecs which determine how documents are to be
+ displayed, e.g. show just the first two lines of all levels in a
+ Koutline;</p>
+ </li>
+ <li>
+ <p>Other hypertext and information retrieval systems may be
+ encapsulated under a Hyperbole user interface very easily.</p>
+ </li>
</ul>
<h2>
-<a id="user-content-hyperbole-uses" class="anchor" href="#hyperbole-uses"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Hyperbole Uses</h2>
+ <a id="user-content-hyperbole-uses" class="anchor" href="#hyperbole-uses"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Hyperbole Uses</h2>
<p>Typical Hyperbole applications include:</p>
<ul>
-<li>
-<p><em>Personal Information Management</em><br>
-Overlapping link paths provide a variety of views into an
-information space. A single key press activates buttons
-regardless of their types, making navigation easy.</p>
-<p>A search facility locates buttons in context and permits quick
-selection.</p>
-</li>
-<li>
-<p><em>Documentation Browsing</em><br>
-Embedding cross-references in a favorite documentation format.</p>
-<p>Addition of a point-and-click interface to existing documentation.</p>
-<p>Linkage of code and design documents. Jumping to the definition
-of an identifier from its use within code or its reference within
-documentation.</p>
-</li>
-<li>
-<p><em>Brainstorming</em><br>
-Capture of ideas and then quick reorganization with the Hyperbole
-Koutliner. Link to related ideas, eliminating the need to copy
-and paste information into a single place.</p>
-</li>
-<li>
-<p><em>Help/Training Systems</em><br>
-Creation of tutorials with embedded buttons that show students how
-things work while explaining the concepts, e.g. an introduction
-to UNIX commands. This technique can be much more effective than
-descriptions alone.</p>
-</li>
-<li>
-<p><em>Archive Managers</em><br>
-Supplementation of programs that manage archives from incoming
-information stream, having them add topic-based buttons that
-link to the archive holdings. Users can then search and create
-their own links to archive entries.</p>
-</li>
+ <li>
+ <p><em>Personal Information Management</em><br>
+ Overlapping link paths provide a variety of views into an
+ information space. A single key press activates buttons
+ regardless of their types, making navigation easy.</p>
+ <p>A search facility locates buttons in context and permits quick
+ selection.</p>
+ </li>
+ <li>
+ <p><em>Documentation Browsing</em><br>
+ Embedding cross-references in a favorite documentation format.</p>
+ <p>Addition of a point-and-click interface to existing documentation.</p>
+ <p>Linkage of code and design documents. Jumping to the definition
+ of an identifier from its use within code or its reference within
+ documentation.</p>
+ </li>
+ <li>
+ <p><em>Brainstorming</em><br>
+ Capture of ideas and then quick reorganization with the Hyperbole
+ Koutliner. Link to related ideas, eliminating the need to copy
+ and paste information into a single place.</p>
+ </li>
+ <li>
+ <p><em>Help/Training Systems</em><br>
+ Creation of tutorials with embedded buttons that show students how
+ things work while explaining the concepts, e.g. an introduction
+ to UNIX commands. This technique can be much more effective than
+ descriptions alone.</p>
+ </li>
+ <li>
+ <p><em>Archive Managers</em><br>
+ Supplementation of programs that manage archives from incoming
+ information stream, having them add topic-based buttons that
+ link to the archive holdings. Users can then search and create
+ their own links to archive entries.</p>
+ </li>
</ul>
<h2>
-<a id="user-content-files" class="anchor" href="#files"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Files</h2>
+ <a id="user-content-files" class="anchor" href="#files"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>Files</h2>
<p>See the <a href="HY-ABOUT">HY-ABOUT</a> file for a description and overview
of Hyperbole.</p>
<p>See the <a href="HY-NEWS">HY-NEWS</a> file for a summary of new features in
this release.</p>
<p>See the <a href="INSTALL">INSTALL</a> file for installation and invocation
instructions.</p>
<p>See the <a href="HY-COPY">HY-COPY</a> and <a href="COPYING">COPYING</a>
files for license information.</p>
<p>See the <a href="MANIFEST">MANIFEST</a> file for summaries of Hyperbole
distribution files.</p>
<p>See <a href="DEMO">DEMO</a> for a demonstration of standard Hyperbole
button capabilities.
-This is the best way to initially interactively learn about Hyperbole after
-installing it.</p>
+ This is the best way to initially interactively learn about Hyperbole after
+ installing it.</p>
<p>Various forms of the Hyperbole are below the "man/" subdirectory.</p>
<h2>
-<a id="user-content-programmer-quick-reference" class="anchor"
href="#programmer-quick-reference" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Programmer Quick Reference</h2>
+ <a id="user-content-programmer-quick-reference" class="anchor"
href="#programmer-quick-reference" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Programmer Quick Reference</h2>
<p><a href="MANIFEST">MANIFEST</a> summarizes most of the files in the
distribution.</p>
<p>See <a href="DEMO">DEMO</a> for a demonstration of standard Hyperbole button
-capabilities. This is the best way to initially interactively learn
-about Hyperbole. The Hyperbole Manual is a reference manual, not a
-simple introduction.</p>
+ capabilities. This is the best way to initially interactively learn
+ about Hyperbole. The Hyperbole Manual is a reference manual, not a
+ simple introduction.</p>
<p>Naming conventions:</p>
<ul>
-<li>
-<p>All Hyperbole-specific code files begin with an 'h', aside from the
-Koutliner files which are in the kotl/ subdirectory and begin with a 'k'.</p>
-</li>
-<li>
-<p>Hyperbole user-interface files begin with 'hui-' or 'hmous'.</p>
-</li>
-<li>
-<p>Files that define implicit button types begin with 'hib'.</p>
-</li>
-<li>
-<p>Encapsulations of foreign systems begin with 'hsys-'.</p>
-</li>
+ <li>
+ <p>All Hyperbole-specific code files begin with an 'h', aside from the
+ Koutliner files which are in the kotl/ subdirectory and begin with a
'k'.</p>
+ </li>
+ <li>
+ <p>Hyperbole user-interface files begin with 'hui-' or 'hmous'.</p>
+ </li>
+ <li>
+ <p>Files that define implicit button types begin with 'hib'.</p>
+ </li>
+ <li>
+ <p>Encapsulations of foreign systems begin with 'hsys-'.</p>
+ </li>
</ul>
<p>Most of the standard Emacs user interface for Hyperbole is located in
-<a href="hui.el">hui.el</a>. Most of the Hyperbole application programming
-interface can be found in <a href="hbut.el">hbut.el</a>. <a
href="hbdata.el">hbdata.el</a>
-encapsulates the button attribute storage implemented by Hyperbole.
-<a href="hmail.el">hmail.el</a> provides a basic abstract interface for
-integrating mail readers other than Rmail into Hyperbole.</p>
+ <a href="hui.el">hui.el</a>. Most of the Hyperbole application programming
+ interface can be found in <a href="hbut.el">hbut.el</a>. <a
href="hbdata.el">hbdata.el</a>
+ encapsulates the button attribute storage implemented by Hyperbole.
+ <a href="hmail.el">hmail.el</a> provides a basic abstract interface for
+ integrating mail readers other than Rmail into Hyperbole.</p>
<p>See the [Hyperbole Questions and Answers](man/hyperbole.html#Questions
-and Answers) appendix in the Hyperbole manual for information on how
-to alter the default context-sensitive Hyperbole key bindings (Smart
-Keys).</p>
+ and Answers) appendix in the Hyperbole manual for information on how
+ to alter the default context-sensitive Hyperbole key bindings (Smart
+ Keys).</p>
<h2>
-<a id="user-content-user-quotes" class="anchor" href="#user-quotes"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>User Quotes</h2>
+ <a id="user-content-user-quotes" class="anchor" href="#user-quotes"
aria-hidden="true"><span aria-hidden="true" class="octicon
octicon-link"></span></a>User Quotes</h2>
<p>*** MAN I love Hyperbole!!! Wow! ***</p>
<pre><code> -- Ken Olstad
Cheyenne Software, Inc.
@@ -439,182 +439,181 @@ Keys).</p>
</code></pre>
<hr>
<p>One of the nicest things about Hyperbole is that it's available
-everywhere. Org-mode is a mode and its features are only available in
-Org files. For instance if you dropped into <code>eshell' or </code>ansi-term'
and
-did `ls', you can move point to any of the directory's contents, do M-RET
-(or Shift-Button2) and jump to that file. And that's just one example.
-Note that this means that all Hyperbole functionality is available in
-Org files as well. To me, except for the Hyperbole outliner, that means
-complementary not conflicting. It's Hyperbole <em>and</em> org-mode, not
-Hyperbole vs. org-mode.</p>
+ everywhere. Org-mode is a mode and its features are only available in
+ Org files. For instance if you dropped into <code>eshell' or
</code>ansi-term' and
+ did `ls', you can move point to any of the directory's contents, do M-RET
+ (or Shift-Button2) and jump to that file. And that's just one example.
+ Note that this means that all Hyperbole functionality is available in
+ Org files as well. To me, except for the Hyperbole outliner, that means
+ complementary not conflicting. It's Hyperbole <em>and</em> org-mode, not
+ Hyperbole vs. org-mode.</p>
<p>Additionally, off the bat, I found it very well documented and for me
-that's a proxy for the quality of a package. The maintainers are quite
-responsive. There's plenty more functionality that I haven't uncovered yet
-but due to the ease of installation and the quality of the documentation,
-digging into it is actually fun.</p>
+ that's a proxy for the quality of a package. The maintainers are quite
+ responsive. There's plenty more functionality that I haven't uncovered yet
+ but due to the ease of installation and the quality of the documentation,
+ digging into it is actually fun.</p>
<pre><code> -- Aditya Siram
</code></pre>
<hr>
<p>For me, Emacs isn't Emacs without Hyperbole. I have depended on Hyperbole
-daily since 1992, when I first started using it to manage my development
-environment. It didn't take long before I could summon almost any
-information I needed directly from within my editing environment with an
-implicit button. Since I almost never have to slow down to look for
-things--one context-dependent button usually produces exactly what I need
---I am able to maintain focus on the task I am working on and complete it
-more quickly. With its gestural interface, seamless integration with other
-Emacs packages and incredibly useful set of core features. I think that
-Hyperbole is one of the best designed and most easily extensible software
-products I have ever come across. It is certainly the one which has made
-the biggest improvement in my personal productivity.</p>
+ daily since 1992, when I first started using it to manage my development
+ environment. It didn't take long before I could summon almost any
+ information I needed directly from within my editing environment with an
+ implicit button. Since I almost never have to slow down to look for
+ things--one context-dependent button usually produces exactly what I need
+ --I am able to maintain focus on the task I am working on and complete it
+ more quickly. With its gestural interface, seamless integration with other
+ Emacs packages and incredibly useful set of core features. I think that
+ Hyperbole is one of the best designed and most easily extensible software
+ products I have ever come across. It is certainly the one which has made
+ the biggest improvement in my personal productivity.</p>
<p>My Hyperbole button file is my start page in Emacs. It's a quickly
-searchable index with links to countless resources. We also have a
-library of implicit buttons that enable rapid navigation from references
-in our code to our issue tracking system, so clicking a reference like
-Client6502 opens the relevant conversation. Hyperbole provides a really
-useful set of power tools. If Emacs is your preferred productivity
-environment, it's definitely worth getting familiar with it.</p>
+ searchable index with links to countless resources. We also have a
+ library of implicit buttons that enable rapid navigation from references
+ in our code to our issue tracking system, so clicking a reference like
+ Client6502 opens the relevant conversation. Hyperbole provides a really
+ useful set of power tools. If Emacs is your preferred productivity
+ environment, it's definitely worth getting familiar with it.</p>
<pre><code> -- Chris Nuzum
Co-founder, Traction Softwarea, Inc.
</code></pre>
<hr>
<p>I've found Hyperbole (in conjunction with XEmacs) to be very useful
-for signal processing algorithm development.</p>
+ for signal processing algorithm development.</p>
<p>For me, it has almost completely obsoleted the engineering notebook:
-I keep a set of files with ideas, algorithms, and results, linked
-together and to the implementation in C++ files. Using XEmacs'
-support for embedding graphics, I've written a mode that accepts
-image tags (formatted like HTML), and reads in GIF files to display
-plots. I have another program that converts the file to HTML (not
-perfect, but adequate), so I can put any aspect of development on
-our internal web for others to see.</p>
+ I keep a set of files with ideas, algorithms, and results, linked
+ together and to the implementation in C++ files. Using XEmacs'
+ support for embedding graphics, I've written a mode that accepts
+ image tags (formatted like HTML), and reads in GIF files to display
+ plots. I have another program that converts the file to HTML (not
+ perfect, but adequate), so I can put any aspect of development on
+ our internal web for others to see.</p>
<pre><code> -- Farzin Guilak
Protocol Systems, Inc., Engineer
</code></pre>
<hr>
<p>I am blind and have been using Hyperbole since 1992. I used to use a PC as
-a talking terminal attached to a UNIX system, but then I developed
-Emacspeak which lets me use Emacs and Hyperbole from standard UNIX
-workstations with an attached voice synthesizer.</p>
+ a talking terminal attached to a UNIX system, but then I developed
+ Emacspeak which lets me use Emacs and Hyperbole from standard UNIX
+ workstations with an attached voice synthesizer.</p>
<p>My main uses are:</p>
<ol>
-<li>
-<p>Global and implicit buttons for jumping to ftp sites.</p>
-</li>
-<li>
-<p>The contact manager with Emacspeak support.</p>
-</li>
-<li>
-<p>Explicit buttons as part of comments made about a structured document.
-Each button jumps to the document section referred to by the comment.
-This is very, very useful.</p>
-</li>
-<li>
-<p>The Hyperbole Koutliner, which I find a very useful tool. I've
-implemented Emacspeak extensions to support it.</p>
-<pre><code> -- TV Raman
+ <li>
+ <p>Global and implicit buttons for jumping to ftp sites.</p>
+ </li>
+ <li>
+ <p>The contact manager with Emacspeak support.</p>
+ </li>
+ <li>
+ <p>Explicit buttons as part of comments made about a structured document.
+ Each button jumps to the document section referred to by the comment.
+ This is very, very useful.</p>
+ </li>
+ <li>
+ <p>The Hyperbole Koutliner, which I find a very useful tool. I've
+ implemented Emacspeak extensions to support it.</p>
+ <pre><code> -- TV Raman
Google Inc.
-</code></pre>
-</li>
+ </code></pre>
+ </li>
</ol>
<hr>
<p>I've been a grateful Hyperbole user for a few years now. Hyperbole's
-flexibility and ease of use is a marvel.</p>
+ flexibility and ease of use is a marvel.</p>
<p>Mainly, I write easy little implicit button types (and corresponding action
-types) to make my life easier. For example, I have an implicit button type
-to bury certain buffers when I click at their bottoms, one that recognizes
-a bug report record in various contexts and edits it, one that links pieces
-of test output in a log file to the corresponding test case source code
-(EXTREMELY helpful in interpreting test output), others that support our
-homegrown test framework, one that handles tree dired mode the way I'd
-like, one that completely handles wico menus (I've also overloaded the
-wconfig actions triggered by diagonal mouse drags with wicos actions), and
-a couple that support interaction with BBDB.</p>
+ types) to make my life easier. For example, I have an implicit button type
+ to bury certain buffers when I click at their bottoms, one that recognizes
+ a bug report record in various contexts and edits it, one that links pieces
+ of test output in a log file to the corresponding test case source code
+ (EXTREMELY helpful in interpreting test output), others that support our
+ homegrown test framework, one that handles tree dired mode the way I'd
+ like, one that completely handles wico menus (I've also overloaded the
+ wconfig actions triggered by diagonal mouse drags with wicos actions), and
+ a couple that support interaction with BBDB.</p>
<p>Other than that, I keep a global button file with 30 or so explicit buttons
-that do various little things, and I index saved mail messages by putting
-explicit link-to-mail buttons in an outline file.</p>
+ that do various little things, and I index saved mail messages by putting
+ explicit link-to-mail buttons in an outline file.</p>
<pre><code> -- Ken Olstad
Cheyenne Software, Inc.
</code></pre>
<hr>
<p>In general, Hyperbole is an embeddable, highly extensible hypertext
-tool. As such, I find it very useful. As it stands now, Hyperbole is
-particularly helpful for organizing ill-structured or loosely coupled
-information, in part because there are few tools geared for this purpose.
-Hyperbole also possesses a lot of potential in supporting a wider
-spectrum of structuredness, ranging from unstructured to highly
-structured environments, as well as structural changes over time.</p>
+ tool. As such, I find it very useful. As it stands now, Hyperbole is
+ particularly helpful for organizing ill-structured or loosely coupled
+ information, in part because there are few tools geared for this purpose.
+ Hyperbole also possesses a lot of potential in supporting a wider
+ spectrum of structuredness, ranging from unstructured to highly
+ structured environments, as well as structural changes over time.</p>
<p>Major Uses:</p>
<ul>
-<li>
-<p>Menu interface to our own collaborative support environment called
-CoReView: This interface brings together all top-level user commands
-into a single partitioned screen, and allows the end user to interact
-with the system using simple mouse-clicking instead of the meta-x key.</p>
-</li>
-<li>
-<p>Gateway to internet resources: this includes links to major Internet
-archive sites of various types of information. Links are made at both
-directory and file levels.</p>
-</li>
-<li>
-<p>Alternative directory organizer: The hierarchical nature of the Unix
-file system sometimes makes it difficult to find things quickly and
-easily using directory navigational tools such as dired. Hyperbole
-enables me to create various "profile" views of my directory tree, with
-entries in these views referring to files anywhere in the hierarchy.</p>
-</li>
-<li>
-<p>Organizing and viewing online documentation: using Hyperbole along with
-Hyper-man and Info makes it truly easy to look up online documentation.</p>
-</li>
-<li>
-<p>Other desktop organization tasks: including links to various mail
-folders, saved newsgroup conversation threads, online note-taker,
-emacs-command invocations, etc.</p>
-<pre><code> -- Dadong Wan
+ <li>
+ <p>Menu interface to our own collaborative support environment called
+ CoReView: This interface brings together all top-level user commands
+ into a single partitioned screen, and allows the end user to interact
+ with the system using simple mouse-clicking instead of the meta-x
key.</p>
+ </li>
+ <li>
+ <p>Gateway to internet resources: this includes links to major Internet
+ archive sites of various types of information. Links are made at both
+ directory and file levels.</p>
+ </li>
+ <li>
+ <p>Alternative directory organizer: The hierarchical nature of the Unix
+ file system sometimes makes it difficult to find things quickly and
+ easily using directory navigational tools such as dired. Hyperbole
+ enables me to create various "profile" views of my directory tree, with
+ entries in these views referring to files anywhere in the hierarchy.</p>
+ </li>
+ <li>
+ <p>Organizing and viewing online documentation: using Hyperbole along with
+ Hyper-man and Info makes it truly easy to look up online
documentation.</p>
+ </li>
+ <li>
+ <p>Other desktop organization tasks: including links to various mail
+ folders, saved newsgroup conversation threads, online note-taker,
+ emacs-command invocations, etc.</p>
+ <pre><code> -- Dadong Wan
University of Hawaii
-</code></pre>
-</li>
+ </code></pre>
+ </li>
</ul>
<hr>
<p>Hyperbole is the first hyper-link system I've run across that is
-actually part of the environment I use regularly, namely Emacs. The
-complete flexibility of the links is both impressive and expected -- the
-idea of making the link itself programmable is clever, and given that one
-assumes the full power of Emacs. Being able to send email with buttons
-in it is a very powerful capability. Using ange-ftp mode, one can make
-file references "across the world" as easily as normal file references.</p>
+ actually part of the environment I use regularly, namely Emacs. The
+ complete flexibility of the links is both impressive and expected -- the
+ idea of making the link itself programmable is clever, and given that one
+ assumes the full power of Emacs. Being able to send email with buttons
+ in it is a very powerful capability. Using ange-ftp mode, one can make
+ file references "across the world" as easily as normal file references.</p>
<pre><code> -- Mark Eichin
Cygnus Support
</code></pre>
<hr>
<p>I just wanted to say how much I enjoy using the Hyperbole Koutliner.
-It is a great way to quickly construct very readable technical documents
-that I can pass around to others. Thanks for the great work.</p>
+ It is a great way to quickly construct very readable technical documents
+ that I can pass around to others. Thanks for the great work.</p>
<pre><code> -- Jeff Fried
Informix
</code></pre>
<hr>
<p>The Hyperbole system provides a nice interface to exploring corners of
-Unix that I didn't know existed before.</p>
+ Unix that I didn't know existed before.</p>
<pre><code> -- Craig Smith
</code></pre>
<h2>
-<a id="user-content-why-was-hyperbole-developed" class="anchor"
href="#why-was-hyperbole-developed" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Why was Hyperbole developed?</h2>
+ <a id="user-content-why-was-hyperbole-developed" class="anchor"
href="#why-was-hyperbole-developed" aria-hidden="true"><span aria-hidden="true"
class="octicon octicon-link"></span></a>Why was Hyperbole developed?</h2>
<p>Hyperbole was originally designed to aid in research aimed at Personalized
-Information production/retrieval Environments (PIEs). Hyperbole was a
-PIE Manager that provided services to PIE Tools. PIEmail, a mail reader was
-the only PIE Tool developed as part of this research but Hyperbole has
-greatly expanded since then and has long been a production quality toolset.</p>
+ Information production/retrieval Environments (PIEs). Hyperbole was a
+ PIE Manager that provided services to PIE Tools. PIEmail, a mail reader was
+ the only PIE Tool developed as part of this research but Hyperbole has
+ greatly expanded since then and has long been a production quality
toolset.</p>
<p>An examination of many hypertext environments as background research did
-not turn up any that seemed suitable for the research envisioned, mainly
-due to the lack of rich, portable programmer and user environments. We also
-tired of trying to manage our own distributed information pools with standard
-UNIX tools. And so Hyperbole was conceived and raved about until it
-got its name.</p>
+ not turn up any that seemed suitable for the research envisioned, mainly
+ due to the lack of rich, portable programmer and user environments. We also
+ tired of trying to manage our own distributed information pools with standard
+ UNIX tools. And so Hyperbole was conceived and raved about until it
+ got its name.</p>
<p>Since then Hyperbole has proved indispensible at improving information
-access and organization in daily use over many years. Why not start
-improving your information handling efficiency today?</p>
+ access and organization in daily use over many years. Why not start
+ improving your information handling efficiency today?</p>
<p>-- The End --</p>
-
diff --git a/hact.el b/hact.el
index aa52a76..bc10596 100644
--- a/hact.el
+++ b/hact.el
@@ -160,6 +160,10 @@ Use `eq' for comparison."
(new-set (set:add elt set)))
(and new-set (put symbol property new-set))))
+(defun symset:clear (symbol)
+ "Set SYMBOL's symset to nil."
+ (setf (symbol-plist symbol) nil))
+
(defalias 'symset:delete 'symset:remove)
(defun symset:get (symbol property)
diff --git a/hargs.el b/hargs.el
index 42311ee..cb18fc1 100644
--- a/hargs.el
+++ b/hargs.el
@@ -104,7 +104,7 @@ START-DELIM and END-DELIM are strings that specify the
argument
delimiters. With optional START-REGEXP-FLAG non-nil, START-DELIM is
treated as a regular expression. END-REGEXP-FLAG is similar.
With optional LIST-POSITIONS-FLAG, return list of (string-matched start-pos
end-pos).
-With optional EXCLUDE-REGEXP, any matched string is ignored if it this regexp."
+With optional EXCLUDE-REGEXP, any matched string is ignored if it matches this
regexp."
(let* ((opoint (point))
(limit (if start-regexp-flag opoint
(+ opoint (1- (length start-delim)))))
diff --git a/hib-debbugs.el b/hib-debbugs.el
index 916353c..81d440b 100644
--- a/hib-debbugs.el
+++ b/hib-debbugs.el
@@ -83,10 +83,11 @@
;;; ************************************************************************
(defib debbugs-gnu-query ()
- "Display the results of a Gnu debbugs query based on the string at point.
-If the query includes a single id number, display the original message
-submission for that id and allow browsing of the followup discussion.
-Accept the following buffer text formats (with point prior to any
+ "Display the results of a Debbugs query based on a bug reference string
around point.
+This works in most types of buffers. If the query includes a
+single id number, display the original message submission for
+that id and allow browsing of the followup discussion. Accepts
+the following buffer text formats (with point prior to any
attribute):
bug#id-number or bug# id-number or bug #id-number
diff --git a/hib-kbd.el b/hib-kbd.el
index 8b2c516..ee519ff 100644
--- a/hib-kbd.el
+++ b/hib-kbd.el
@@ -56,8 +56,8 @@ Group 1 matches to the set of modifier keys. Group 3 matches
to the unmodified
;;; ************************************************************************
(defact kbd-key (key-series)
- "Execute a normalized key sequence without curly braces, {}.
-KEY-SERIES must be a string of one of the following:
+ "Execute a normalized KEY-SERIES (series of key sequences) without curly
braces, {}.
+Each key sequence within KEY-SERIES must be a string of one of the following:
a Hyperbole minibuffer menu item key sequence,
a HyControl key sequence,
a M-x extended command,
@@ -68,7 +68,7 @@ Return t if the sequence appears to be valid, else nil."
(kbd-key:act key-series))
(defib kbd-key ()
- "Execute a key sequence found around point, delimited by curly braces, {},
if any.
+ "Execute a key series (series of key sequences) around point, delimited by
curly braces, {}.
Key sequences should be in human readable form, e.g. {C-x C-b}, or what
`key-description' returns.
Forms such as {\C-b}, {\^b}, and {^M} will not be recognized.
diff --git a/hibtypes.el b/hibtypes.el
index da8b254..46bde4c 100644
--- a/hibtypes.el
+++ b/hibtypes.el
@@ -10,9 +10,23 @@
;; This file is part of GNU Hyperbole.
;;; Commentary:
;;
-;; Implicit button types in this file are defined in increasing
-;; order of priority within this file (last one is highest
-;; priority).
+;; Implicit button types (ibtypes) in this file are defined in increasing
+;; order of priority within this file (last one is highest priority).
+;;
+;; To return a list of the implicit button types in priority order (highest
+;; to lowest), evaluate:
+;;
+;; (symset:get 'ibtypes 'symbols)
+;;
+;; If you need to reset the priorities of all ibtypes, evaluate:
+;;
+;; (symset:clear 'ibtypes)
+;;
+;; and then reload this file.
+;;
+;; To get a list of all loaded action types, evaluate:
+;;
+;; (symset:get 'actypes 'symbols)
;;; Code:
;;; ************************************************************************
@@ -64,11 +78,24 @@
(run-hooks 'hibtypes-begin-load-hook)
+;; Don't use require below here for any libraries with ibtypes in
+;; them. Use load instead to ensure are reloaded when resetting
+;; ibtype priorities.
+
+;;; ========================================================================
+;;; Follows Org mode links and radio targets and cycles Org heading views
+;;; ========================================================================
+
+(load "hib-org")
+
+;; If you want to to disable ALL Hyperbole support within Org major
+;; and minor modes, set the custom option `inhibit-hsys-org' non-nil.
+
;;; ========================================================================
;;; Follows URLs by invoking a web browser.
;;; ========================================================================
-(require 'hsys-www)
+(load "hsys-www")
;;; ========================================================================
;;; Follows Org links that are in non-Org mode buffers
@@ -85,7 +112,7 @@ handle any links they recognize first."
(hsys-org-set-ibut-label start-end)
(hact 'org-open-at-point-global)))))
-;; Org links in Org mode are handled at a higher priority in "hib-org.el"
+;; Org links in Org mode are handled at a lower priority in "hib-org.el"
;;; ========================================================================
;;; Composes mail, in another window, to the e-mail address at point.
@@ -268,7 +295,7 @@ must have an attached file."
;;; Handles social media hashtag and username references, e.g.
twitter#myhashtag
;;; ========================================================================
-(require 'hib-social)
+(load "hib-social")
;;; ========================================================================
;;; Displays in-file Markdown link referents.
@@ -514,9 +541,9 @@ anything."
File name must contain DEMO, README or TUTORIAL and there must be a `Table
of Contents' or `Contents' label on a line by itself (it may begin with
an asterisk), preceding the table of contents. Each toc entry must begin
-with some whitespace followed by one or more asterisk characters. Each
-file section name line must start with one or more asterisk characters at
-the very beginning of the line."
+with some whitespace followed by one or more asterisk characters.
+Each section header linked to by the toc must start with one or more
+asterisk characters at the very beginning of the line."
(let (section)
(when (and (string-match "DEMO\\|README\\|TUTORIAL" (buffer-name))
(save-excursion
@@ -559,20 +586,20 @@ spaces and then another non-space, non-parenthesis,
non-brace character."
;;; Handles Gnu debbugs issue ids, e.g. bug#45678 or just 45678.
;;; ========================================================================
-(require 'hib-debbugs)
+(load "hib-debbugs")
;;; ========================================================================
;;; Executes or documents command bindings of brace delimited key sequences.
;;; ========================================================================
-(require 'hib-kbd)
+(load "hib-kbd")
;;; ========================================================================
;;; Makes Internet RFC references retrieve the RFC.
;;; ========================================================================
(defib rfc ()
- "Retrieve and display an Internet rfc referenced at point.
+ "Retrieve and display an Internet Request for Comments (RFC) at point.
The following formats are recognized: RFC822, rfc-822, and RFC 822. The
`hpath:rfc' variable specifies the location from which to retrieve RFCs.
Requires the Emacs builtin Tramp library for ftp file retrievals."
@@ -622,7 +649,7 @@ Requires the Emacs builtin Tramp library for ftp file
retrievals."
;;; Follows links to Hyperbole Koutliner cells.
;;; ========================================================================
-(require 'klink)
+(load "klink")
;;; ========================================================================
;;; Links to Hyperbole button types
@@ -674,7 +701,8 @@ Requires the Emacs builtin Tramp library for ftp file
retrievals."
(defib elink ()
"At point, activate a link to an explicit button.
-Execute The explicit button's action in the context of the current buffer.
+This executes the linked to explicit button's action in the
+context of the current buffer.
Recognizes the format '<elink:' button_label [':' button_file_path] '>',
where : button_file_path is given only when the link is to another file,
@@ -688,7 +716,8 @@ e.g. <elink: project-list: ~/projs>."
(defib glink ()
"At point, activates a link to a global button.
-Execulte the global button's action in the context of the current buffer.
+This executes the linked to global button's action in the context
+of the current buffer.
Recognizes the format '<glink:' button_label '>',
e.g. <glink: open todos>."
@@ -700,8 +729,9 @@ e.g. <glink: open todos>."
"String matching the end of a link to a Hyperbole implicit button.")
(defib ilink ()
- "At point, activates a link to a labeled implicit button.
-Execute the implicit button's action in the context of the current buffer.
+ "At point, activate a link to a labeled implicit button.
+This executes the linked to implicit button's action in the context of the
+current buffer.
Recognizes the format '<ilink:' button_label [':' button_file_path] '>',
where button_file_path is given only when the link is to another file,
@@ -714,7 +744,7 @@ e.g. <ilink: my series of keys: ${hyperb:dir}/HYPB>."
;;; ========================================================================
(defib ipython-stack-frame ()
- "Jump to line associated with an ipython stack frame line numbered msg.
+ "Jump to the line associated with an ipython stack frame line numbered msg.
ipython outputs each pathname once followed by all matching lines in that
pathname.
Messages are recognized in any buffer (other than a helm completion
buffer)."
@@ -756,7 +786,7 @@ buffer)."
(hact 'link-to-file-line file line-num)))))))))
(defib ripgrep-msg ()
- "Jump to line associated with a ripgrep (rg) line numbered msg.
+ "Jump to the line associated with a ripgrep (rg) line numbered msg.
Ripgrep outputs each pathname once followed by all matching lines in that
pathname.
Messages are recognized in any buffer (other than a helm completion
buffer)."
@@ -799,7 +829,7 @@ buffer)."
(hact 'link-to-file-line file line-num)))))))))
(defib grep-msg ()
- "Jump to line associated with line numbered grep or compilation error msgs.
+ "Jump to the line associated with line numbered grep or compilation error
msgs.
Messages are recognized in any buffer (other than a helm completion
buffer) except for grep -A<num> context lines which are matched only
in grep and shell buffers."
@@ -1294,15 +1324,6 @@ arg1 ... argN '>'. For example, <mail nil
\"user@somewhere.org\">."
(apply hrule:action actype (mapcar #'eval args))))))))
;;; ========================================================================
-;;; Follows Org mode links and radio targets and cycles Org heading views
-;;; ========================================================================
-
-(require 'hib-org)
-
-;; If you want to to disable ALL Hyperbole support within Org major
-;; and minor modes, set the custom option `inhibit-hsys-org' non-nil.
-
-;;; ========================================================================
;;; Inserts completion into minibuffer or other window.
;;; ========================================================================
diff --git a/hpath.el b/hpath.el
index b6fb209..58d5dc4 100644
--- a/hpath.el
+++ b/hpath.el
@@ -1104,7 +1104,7 @@ See also `hpath:internal-display-alist' for internal,
`window-system' independen
(cons "next"
hpath:external-display-alist-macos)))))))
(defun hpath:is-p (path &optional type non-exist)
- "Return normalized PATH as a URL if PATH is a Posix or MSWindows path, else
nil.
+ "Return normalized PATH if PATH is a Posix or MSWindows path, else nil.
If optional TYPE is the symbol 'file or 'directory, then only that path type
is accepted as a match. The existence of the path is checked only for
locally reachable paths (Info paths are not checked). With optional NON-EXIST,
diff --git a/hversion.el b/hversion.el
index 0c99601..a97809b 100644
--- a/hversion.el
+++ b/hversion.el
@@ -23,7 +23,7 @@
;;; Public variables
;;; ************************************************************************
-(defconst hyperb:version "7.1.3a" "GNU Hyperbole revision number.")
+(defconst hyperb:version "7.1.4" "GNU Hyperbole revision number.")
;;;###autoload
(defvar hyperb:microsoft-os-p
diff --git a/hyperbole.el b/hyperbole.el
index 7d3d4d6..7d6e4f4 100644
--- a/hyperbole.el
+++ b/hyperbole.el
@@ -5,8 +5,8 @@
;; Author: Bob Weiner
;; Maintainer: Bob Weiner <rsw@gnu.org>, Mats Lidell <matsl@gnu.org>
;; Created: 06-Oct-92 at 11:52:51
-;; Released: 18-Oct-20
-;; Version: 7.1.3a
+;; Released: 25-Oct-20
+;; Version: 7.1.4 (pre-release)
;; Keywords: comm, convenience, files, frames, hypermedia, languages,
mail, matching, mouse, multimedia, outlines, tools, wp
;; Package: hyperbole
;; Package-Requires: ((emacs "24.4"))
diff --git a/man/hyperbole.html b/man/hyperbole.html
index 79a9062..5a4e4e5 100644
--- a/man/hyperbole.html
+++ b/man/hyperbole.html
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<html>
<!-- This manual is for GNU Hyperbole
-(Edition 7.1.3, Published August, 2020).
+(Edition 7.1.4, Published October, 2020).
Copyright (C) 1989-2020 Free Software Foundation, Inc.
@@ -346,8 +346,8 @@ WITHOUT ANY WARRANTY, without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
-Edition 7.1.3
-Printed August 1, 2020.
+Edition 7.1.4
+Printed October 25, 2020.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -820,7 +820,7 @@ Next: <a href="#Smart-Keys" accesskey="n" rel="next">Smart
Keys</a>, Previous: <
<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
<p>This edition of the GNU Hyperbole Manual is for use with any version
-7.1.3 or greater of GNU Hyperbole. Hyperbole runs atop GNU Emacs 24.3
+7.1.4 or greater of GNU Hyperbole. Hyperbole runs atop GNU Emacs 24.3
or higher. It will trigger an error if your Emacs is older.
</p>
<p>This chapter summarizes the structure of the rest of the manual,
@@ -2464,10 +2464,10 @@ buffer behaves the same as the corresponding button in
the original
<dd><p>Within a mail or Usenet news composer window, make a Hyperbole
support/discussion e-mail address insert Hyperbole environment and
version information. This is useful when sending mail to a Hyperbole
-discussion mail list. See also the documentation
-for <code>actypes::hyp-config</code>. For example, an Action Mouse Key
-click on <hyperbole-users@gnu.org> in a mail composer window would
-activate this implicit button type.
+discussion mail list. See also the documentation for
+<code>actypes::hyp-config</code>. For example, a click of an Action Mouse
+Key on <hyperbole-users@gnu.org> in a mail composer window
+would activate this implicit button type.
</p>
<span id="index-ibtypes-Info_002dnode"></span>
<span id="index-Info-node"></span>
@@ -2478,20 +2478,6 @@ Also make a "(filename)itemname" button
display the associated Info
index item. Examples are "(hyperbole)Implicit Buttons" and
“(hyperbole)C-c /”.
</p>
-<span id="index-ibtypes-www_002durl"></span>
-<span id="index-URL"></span>
-<span id="index-World_002dwide-Web"></span>
-<span id="index-WWW"></span>
-<span id="index-Action-Key_002c-web-browsing"></span>
-<span id="index-Action-Key_002c-web-browsing-1"></span>
-<span id="index-browse_002durl_002dbrowser_002dfunction"></span>
-</dd>
-<dt><code>www-url</code></dt>
-<dd><p>When not in an Emacs web browser buffer, follow any non-ftp URL (link)
at point.
-The variable, <code>browse-url-browser-function</code>, may be used to
customize
-which URL browser is called. Terse URLs which lack a protocol prefix,
-like www.gnu.org, are also recognized.
-</p>
<span id="index-ibtypes-gnus_002dpush_002dbutton"></span>
<span id="index-GNUS-push_002dbuttons"></span>
<span id="index-hiding-signatures"></span>
@@ -2540,9 +2526,8 @@ program. Patch applies diffs to source code.
<span id="index-compiler-error"></span>
</dd>
<dt><code>elisp-compiler-msg</code></dt>
-<dd><p>Jump to the source code for a definition associated with an Emacs
-Lisp byte-compiler error message. Works when activated anywhere
-within an error line.
+<dd><p>Jump to the source code for a definition associated with an Emacs Lisp
+byte-compiler error message. This works anywhere within an error line.
</p>
<span id="index-ibtypes-debugger_002dsource"></span>
<span id="index-gdb"></span>
@@ -2563,8 +2548,8 @@ recognized in any buffer.
<span id="index-match-lines"></span>
</dd>
<dt><code>ripgrep-msg</code></dt>
-<dd><p>Jump to line associated with a ripgrep (rg) line numbered msg.
-Ripgrep outputs each pathname once followed by all matching lines in
+<dd><p>Jump to a line associated with a ripgrep (rg) line numbered msg.
+Ripgrep outputs each pathname once, followed by all matching lines in
that pathname. Messages are recognized in any buffer (other than a
helm completion buffer).
</p>
@@ -2573,10 +2558,10 @@ helm completion buffer).
<span id="index-stack-frame-1"></span>
</dd>
<dt><code>ipython-stack-frame</code></dt>
-<dd><p>Jump to line associated with an ipython stack frame line numbered msg.
-ipython outputs each pathname once followed by all matching lines in that
-pathname. Messages are recognized in any buffer (other than a helm completion
-buffer).
+<dd><p>Jump to the line associated with an ipython stack frame line numbered
+msg. ipython outputs each pathname once followed by all matching
+lines in that pathname. Messages are recognized in any buffer (other
+than a helm completion buffer).
</p>
<span id="index-ibtypes-grep_002dmsg"></span>
<span id="index-grep-1"></span>
@@ -2584,7 +2569,7 @@ buffer).
<span id="index-match-lines-1"></span>
</dd>
<dt><code>grep-msg</code></dt>
-<dd><p>Jump to a line associated with a grep or compilation error message.
+<dd><p>Jump to the line associated with a grep or compilation error message.
Messages are recognized in any buffer.
</p>
<span id="index-ibtypes-ilink"></span>
@@ -2593,22 +2578,22 @@ Messages are recognized in any buffer.
<span id="index-ilink"></span>
</dd>
<dt><code>link-to-ibut <ilink></code></dt>
-<dd><p>At point, activate a link to an implicit button within the current
buffer.
-Execute the implicit button’s action in the context of the current
buffer.
+<dd><p>At point, activate a link to an implicit button within the current
+buffer. This executes the linked to implicit button’s action in the
+context of the current buffer.
</p>
<p>Recognizes the format ’<ilink:’ button_label
[’:’ button_file_path] ’>’,
where button_file_path is given only when the link is to another file,
e.g. <ilink: my series of keys: ${hyperb:dir}/HYPB>.
</p>
-
<span id="index-ibtypes-glink"></span>
<span id="index-global-button-link"></span>
<span id="index-link-to-global-button"></span>
<span id="index-glink"></span>
</dd>
<dt><code>link-to-gbut <glink></code></dt>
-<dd><p>At point, activate a link to a global button.
-Execulte the global button’s action in the context of the current buffer.
+<dd><p>At point, activate a link to a global button. This executes the
+linked to global button’s action in the context of the current buffer.
</p>
<p>Recognizes the format ’<glink:’ button_label
’>’, e.g. <glink: open todos>.
</p>
@@ -2618,8 +2603,9 @@ Execulte the global button’s action in the context
of the current buffer.
<span id="index-elink"></span>
</dd>
<dt><code>link-to-ebut <elink></code></dt>
-<dd><p>At point, activate a link to an explicit button within the current
buffer.
-Execute The explicit button’s action in the context of the current
buffer.
+<dd><p>At point, activate a link to an explicit button within the current
+buffer. This executes the linked to explicit button’s action in the
+context of the current buffer.
</p>
<p>Recognizes the format ’<elink:’ button_label
[’:’ button_file_path] ’>’,
where : button_file_path is given only when the link is to another file,
@@ -2652,19 +2638,19 @@ when selected.
<span id="index-ftp"></span>
</dd>
<dt><code>rfc</code></dt>
-<dd><p>Retrieve and display an Internet rfc referenced at point. The
-following formats are recognized: RFC822, rfc-822, and RFC 822. The
-<code>hpath:rfc</code> variable specifies the location from which to
-retrieve RFCs. Requires the Emacs builtin Tramp library for ftp file
-retrievals.
+<dd><p>Retrieve and display an Internet Request for Comments (RFC) standards
+document referenced at point. The following formats are recognized:
+RFC822, rfc-822, and RFC 822. The <code>hpath:rfc</code> variable specifies
+the location from which to retrieve RFCs. Requires the Emacs builtin
+Tramp library for ftp file retrievals.
</p>
<span id="index-ibtypes-kbd_002dkey"></span>
<span id="index-key-sequence"></span>
<span id="index-sequence-of-keys"></span>
</dd>
<dt><code>kbd-key</code></dt>
-<dd><p>Execute a key series (series of key sequences) found around point,
-delimited by curly braces, {}, if any. Key series should be in
+<dd><p>Execute a key series (series of key sequences) around point,
+delimited by curly braces, {}. Key series should be in
human readable form, e.g. <kbd>{C-x C-b}</kbd>. Formats such as {^x^b}
will not be recognized.
</p>
@@ -2691,14 +2677,14 @@ non-brace character.
<span id="index-toc-implicit-button-type"></span>
</dd>
<dt><code>text-toc</code></dt>
-<dd><p>Jump to the text file section referenced by a table of contents entry
-at point. The filename of the current buffer must contain
+<dd><p>Jump to the text file section referenced by a table of contents (toc)
+entry at point. The filename of the current buffer must contain
<samp>README</samp> and there must be a ‘Table of Contents’ or
‘Contents’
-label on a line by itself (it may begin with an asterisk), preceding the
-table of contents. Each toc entry must begin with some whitespace
-followed by one or more asterisk characters. Each line which begins a
-new file section must start with one or more asterisk characters at the
-very beginning of the line.
+label on a line by itself (it may begin with an asterisk), preceding
+the table of contents. Each toc entry must begin with some whitespace
+followed by one or more asterisk characters. Each section header
+linked to by the toc must start with one or more asterisk characters
+at the very beginning of the line.
</p>
<span id="index-ibtypes-cscope"></span>
<span id="index-C_002fC_002b_002b-call-trees"></span>
@@ -2941,12 +2927,12 @@ window.
<span id="index-ibtypes-debbugs_002dgnu_002dquery"></span>
</dd>
<dt><code>debbugs-gnu-query</code></dt>
-<dd><p>Debbugs queries may be issued by activating this implicit button type.
-It displays the results of a Gnu debbugs query based on the string at
-point and works in most kinds of buffers. If the query includes a
-single id number, it displays the original message submission for that
-id and allows browsing of the followup discussion. The following
-buffer text formats are accepted (with point prior to any attribute):
+<dd><p>Display the results of a Debbugs query based on a bug reference string
+around point. This works in most types of buffers. If the query
+includes a single id number, it displays the original message
+submission for that id and allows browsing of the followup discussion.
+The following buffer text formats are accepted (with point prior to
+any attribute):
</p>
<div class="example">
<pre class="example">bug#id-number, bug# id-number, bug #id-number or bug
id-number
@@ -2977,7 +2963,7 @@ whose names begin with a ‘ ’ or
‘*’ character.
</dd>
<dt><code>function-in-buffer</code></dt>
<dd><p>Return the function name defined within this buffer that point is
-within or after, else ‘<samp>nil</samp>’. This triggers only when
the
+within or after, else <code>nil</code>. This triggers only when the
func-menu library has been loaded and the current major mode is one
handled by func-menu.
</p>
@@ -2987,12 +2973,11 @@ handled by func-menu.
<span id="index-ibtypes-pathname_002dline_002dand_002dcolumn"></span>
</dd>
<dt><code>pathname-line-and-column</code></dt>
-<dd><p>Make a valid pathname:line-num[:column-num] pattern display the path
-at line-num and optional column-num. Also works for remote pathnames.
-May also contain hash-style link references with the following format:
-<samp><path>[#<link-anchor>]:<line-num>[:<column-num>]</samp>.
+<dd><p>Make a valid <samp>pathname:line-num[:column-num]</samp> pattern
display the
+path at <em>line-num</em> and optional <em>column-num</em>. Also works
+for remote pathnames. May also contain hash-style link references
+with the following format:
<samp><path>[#<link-anchor>]:<line-num>[:<column-num>]</samp>.
</p>
-
<span id="index-ibtypes-pathname"></span>
<span id="index-hpath_003aat_002dp"></span>
<span id="index-hpath_003afind"></span>
@@ -3027,6 +3012,20 @@ suffixes that are added to or removed from the pathname
when searching
for a valid match. See the function documentation for <code>hpath:find</code>
for special file display options.
</p>
+<span id="index-ibtypes-www_002durl"></span>
+<span id="index-URL"></span>
+<span id="index-World_002dwide-Web"></span>
+<span id="index-WWW"></span>
+<span id="index-Action-Key_002c-web-browsing"></span>
+<span id="index-Action-Key_002c-web-browsing-1"></span>
+<span id="index-browse_002durl_002dbrowser_002dfunction"></span>
+</dd>
+<dt><code>www-url</code></dt>
+<dd><p>When not in an Emacs web browser buffer, follow any non-ftp URL (link)
at point.
+The variable, <code>browse-url-browser-function</code>, may be used to
customize
+which URL browser is called. Terse URLs which lack a protocol prefix,
+like www.gnu.org, are also recognized.
+</p>
<span id="index-ibtypes-org_002dmode"></span>
<span id="index-Org_002dmode"></span>
<span id="index-radio-target"></span>
@@ -3067,9 +3066,11 @@ the Org-mode standard binding of <kbd>{M-<span
class="key">RET</span>}</kbd>, <c
<p>To disable ALL Hyperbole support within Org major and minor modes, set
the custom option <code>inhibit-hsys-org</code> to <code>t</code>. Then in
Org modes,
the Action Key will simply invoke <code>org-meta-return</code>.
-</p></dd>
+</p>
+</dd>
</dl>
+
<hr>
<span id="Action-Buttons"></span><div class="header">
<p>
diff --git a/man/hyperbole.info b/man/hyperbole.info
index 2295f51..fce66c6 100644
Binary files a/man/hyperbole.info and b/man/hyperbole.info differ
diff --git a/man/hyperbole.pdf b/man/hyperbole.pdf
index 77ec449..258d275 100644
Binary files a/man/hyperbole.pdf and b/man/hyperbole.pdf differ
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index a3e293a..398179c 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -154,8 +154,8 @@ WITHOUT ANY WARRANTY, without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
-Edition 7.1.3
-Printed August 1, 2020.
+Edition 7.1.4
+Printed October 25, 2020.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -196,8 +196,8 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
@sp 2
@example
-Edition 7.1.3
-August 1, 2020
+Edition 7.1.4
+October 25, 2020
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -484,7 +484,7 @@ Smart Keyboard Keys
@chapter Introduction
This edition of the GNU Hyperbole Manual is for use with any version
-7.1.3 or greater of GNU Hyperbole. Hyperbole runs atop GNU Emacs 24.3
+7.1.4 or greater of GNU Hyperbole. Hyperbole runs atop GNU Emacs 24.3
or higher. It will trigger an error if your Emacs is older.
This chapter summarizes the structure of the rest of the manual,
@@ -1917,10 +1917,10 @@ buffer behaves the same as the corresponding button in
the original
Within a mail or Usenet news composer window, make a Hyperbole
support/discussion e-mail address insert Hyperbole environment and
version information. This is useful when sending mail to a Hyperbole
-discussion mail list. See also the documentation
-for @code{actypes::hyp-config}. For example, an Action Mouse Key
-click on <hyperbole-users@@gnu.org> in a mail composer window would
-activate this implicit button type.
+discussion mail list. See also the documentation for
+@code{actypes::hyp-config}. For example, a click of an Action Mouse
+Key on <hyperbole-users@@gnu.org> in a mail composer window
+would activate this implicit button type.
@findex ibtypes Info-node
@cindex Info node
@@ -1930,19 +1930,6 @@ Also make a "(filename)itemname" button display the
associated Info
index item. Examples are "(hyperbole)Implicit Buttons" and
``(hyperbole)C-c /''.
-@findex ibtypes www-url
-@cindex URL
-@cindex World-wide Web
-@cindex WWW
-@cindex Action Key, web browsing
-@kindex Action Key, web browsing
-@vindex browse-url-browser-function
-@item www-url
-When not in an Emacs web browser buffer, follow any non-ftp URL (link) at
point.
-The variable, @code{browse-url-browser-function}, may be used to customize
-which URL browser is called. Terse URLs which lack a protocol prefix,
-like www.gnu.org, are also recognized.
-
@findex ibtypes gnus-push-button
@cindex GNUS push-buttons
@cindex hiding signatures
@@ -1986,9 +1973,8 @@ program. Patch applies diffs to source code.
@cindex Emacs Lisp compiler error
@cindex compiler error
@item elisp-compiler-msg
-Jump to the source code for a definition associated with an Emacs
-Lisp byte-compiler error message. Works when activated anywhere
-within an error line.
+Jump to the source code for a definition associated with an Emacs Lisp
+byte-compiler error message. This works anywhere within an error line.
@findex ibtypes debugger-source
@cindex gdb
@@ -2007,8 +1993,8 @@ recognized in any buffer.
@cindex ripgrep
@cindex match lines
@item ripgrep-msg
-Jump to line associated with a ripgrep (rg) line numbered msg.
-Ripgrep outputs each pathname once followed by all matching lines in
+Jump to a line associated with a ripgrep (rg) line numbered msg.
+Ripgrep outputs each pathname once, followed by all matching lines in
that pathname. Messages are recognized in any buffer (other than a
helm completion buffer).
@@ -2016,17 +2002,17 @@ helm completion buffer).
@cindex ipython
@cindex stack frame
@item ipython-stack-frame
-Jump to line associated with an ipython stack frame line numbered msg.
-ipython outputs each pathname once followed by all matching lines in that
-pathname. Messages are recognized in any buffer (other than a helm completion
-buffer).
+Jump to the line associated with an ipython stack frame line numbered
+msg. ipython outputs each pathname once followed by all matching
+lines in that pathname. Messages are recognized in any buffer (other
+than a helm completion buffer).
@findex ibtypes grep-msg
@cindex grep
@cindex compiler error
@cindex match lines
@item grep-msg
-Jump to a line associated with a grep or compilation error message.
+Jump to the line associated with a grep or compilation error message.
Messages are recognized in any buffer.
@findex ibtypes ilink
@@ -2034,21 +2020,21 @@ Messages are recognized in any buffer.
@cindex link to implicit button
@cindex ilink
@item link-to-ibut <ilink>
-At point, activate a link to an implicit button within the current buffer.
-Execute the implicit button's action in the context of the current buffer.
+At point, activate a link to an implicit button within the current
+buffer. This executes the linked to implicit button's action in the
+context of the current buffer.
Recognizes the format '<ilink:' button_label [':' button_file_path] '>',
where button_file_path is given only when the link is to another file,
e.g. <ilink: my series of keys: $@{hyperb:dir@}/HYPB>.
-
@findex ibtypes glink
@cindex global button link
@cindex link to global button
@cindex glink
@item link-to-gbut <glink>
-At point, activate a link to a global button.
-Execulte the global button's action in the context of the current buffer.
+At point, activate a link to a global button. This executes the
+linked to global button's action in the context of the current buffer.
Recognizes the format '<glink:' button_label '>', e.g. <glink: open todos>.
@@ -2057,8 +2043,9 @@ Recognizes the format '<glink:' button_label '>', e.g.
<glink: open todos>.
@cindex link to explicit button
@cindex elink
@item link-to-ebut <elink>
-At point, activate a link to an explicit button within the current buffer.
-Execute The explicit button's action in the context of the current buffer.
+At point, activate a link to an explicit button within the current
+buffer. This executes the linked to explicit button's action in the
+context of the current buffer.
Recognizes the format '<elink:' button_label [':' button_file_path] '>',
where : button_file_path is given only when the link is to another file,
@@ -2088,18 +2075,18 @@ when selected.
@cindex remote file
@cindex ftp
@item rfc
-Retrieve and display an Internet rfc referenced at point. The
-following formats are recognized: RFC822, rfc-822, and RFC 822. The
-@code{hpath:rfc} variable specifies the location from which to
-retrieve RFCs. Requires the Emacs builtin Tramp library for ftp file
-retrievals.
+Retrieve and display an Internet Request for Comments (RFC) standards
+document referenced at point. The following formats are recognized:
+RFC822, rfc-822, and RFC 822. The @code{hpath:rfc} variable specifies
+the location from which to retrieve RFCs. Requires the Emacs builtin
+Tramp library for ftp file retrievals.
@findex ibtypes kbd-key
@cindex key sequence
@cindex sequence of keys
@item kbd-key
-Execute a key series (series of key sequences) found around point,
-delimited by curly braces, @{@}, if any. Key series should be in
+Execute a key series (series of key sequences) around point,
+delimited by curly braces, @{@}. Key series should be in
human readable form, e.g.@: @bkbd{C-x C-b}. Formats such as @{^x^b@}
will not be recognized.
@@ -2124,14 +2111,14 @@ non-brace character.
@cindex table of contents
@cindex toc implicit button type
@item text-toc
-Jump to the text file section referenced by a table of contents entry
-at point. The filename of the current buffer must contain
+Jump to the text file section referenced by a table of contents (toc)
+entry at point. The filename of the current buffer must contain
@file{README} and there must be a `Table of Contents' or `Contents'
-label on a line by itself (it may begin with an asterisk), preceding the
-table of contents. Each toc entry must begin with some whitespace
-followed by one or more asterisk characters. Each line which begins a
-new file section must start with one or more asterisk characters at the
-very beginning of the line.
+label on a line by itself (it may begin with an asterisk), preceding
+the table of contents. Each toc entry must begin with some whitespace
+followed by one or more asterisk characters. Each section header
+linked to by the toc must start with one or more asterisk characters
+at the very beginning of the line.
@findex ibtypes cscope
@cindex C/C++ call trees
@@ -2347,12 +2334,12 @@ window.
@findex ibtypes debbugs-gnu-query
@item debbugs-gnu-query
-Debbugs queries may be issued by activating this implicit button type.
-It displays the results of a Gnu debbugs query based on the string at
-point and works in most kinds of buffers. If the query includes a
-single id number, it displays the original message submission for that
-id and allows browsing of the followup discussion. The following
-buffer text formats are accepted (with point prior to any attribute):
+Display the results of a Debbugs query based on a bug reference string
+around point. This works in most types of buffers. If the query
+includes a single id number, it displays the original message
+submission for that id and allows browsing of the followup discussion.
+The following buffer text formats are accepted (with point prior to
+any attribute):
@smallexample
bug#id-number, bug# id-number, bug #id-number or bug id-number
@@ -2390,7 +2377,7 @@ whose names begin with a ` ' or `*' character.
@cindex func-menu
@item function-in-buffer
Return the function name defined within this buffer that point is
-within or after, else @samp{nil}. This triggers only when the
+within or after, else @code{nil}. This triggers only when the
func-menu library has been loaded and the current major mode is one
handled by func-menu.
@@ -2399,11 +2386,10 @@ handled by func-menu.
@cindex pathname, line and column
@findex ibtypes pathname-line-and-column
@item pathname-line-and-column
-Make a valid pathname:line-num[:column-num] pattern display the path
-at line-num and optional column-num. Also works for remote pathnames.
-May also contain hash-style link references with the following format:
-@file{<path>[#<link-anchor>]:<line-num>[:<column-num>]}.
-
+Make a valid @file{pathname:line-num[:column-num]} pattern display the
+path at @emph{line-num} and optional @emph{column-num}. Also works
+for remote pathnames. May also contain hash-style link references
+with the following format:
@file{<path>[#<link-anchor>]:<line-num>[:<column-num>]}.
@findex ibtypes pathname
@findex hpath:at-p
@@ -2440,6 +2426,19 @@ suffixes that are added to or removed from the pathname
when searching
for a valid match. See the function documentation for @code{hpath:find}
for special file display options.
+@findex ibtypes www-url
+@cindex URL
+@cindex World-wide Web
+@cindex WWW
+@cindex Action Key, web browsing
+@kindex Action Key, web browsing
+@vindex browse-url-browser-function
+@item www-url
+When not in an Emacs web browser buffer, follow any non-ftp URL (link) at
point.
+The variable, @code{browse-url-browser-function}, may be used to customize
+which URL browser is called. Terse URLs which lack a protocol prefix,
+like www.gnu.org, are also recognized.
+
@findex ibtypes org-mode
@cindex Org-mode
@cindex radio target
@@ -2479,8 +2478,10 @@ the Org-mode standard binding of @bkbd{M-@key{RET}},
@code{org-meta-return}.
To disable ALL Hyperbole support within Org major and minor modes, set
the custom option @code{inhibit-hsys-org} to @code{t}. Then in Org modes,
the Action Key will simply invoke @code{org-meta-return}.
+
@end table
+
@node Action Buttons, , Implicit Button Types, Implicit Buttons
@subsection Action Buttons
diff --git a/man/version.texi b/man/version.texi
index 3df53c8..e79040f 100644
--- a/man/version.texi
+++ b/man/version.texi
@@ -1,4 +1,4 @@
-@set UPDATED August, 2020
-@set UPDATED-MONTH August 2020
-@set EDITION 7.1.3
-@set VERSION 7.1.3
+@set UPDATED October, 2020
+@set UPDATED-MONTH October 2020
+@set EDITION 7.1.4
+@set VERSION 7.1.4
- [elpa] externals/hyperbole c1ac392 05/50: Use emacs lisp for updating the web repo, (continued)
- [elpa] externals/hyperbole c1ac392 05/50: Use emacs lisp for updating the web repo, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 357a098 06/50: Initial org-tbl support, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 0e8d33e 03/50: Add Makefile.maintenance, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole de9e60f 09/50: Fix bug#43692, failed to do substitute fixed case for path variables, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 66b35cc 07/50: Add kotl/kotl-orgtbl.el, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 8d77205 08/50: 7.1.3a - Add key bindings and finish Kotl Org table mode support, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 4ddeaf6 10/50: Remove Makefile.maintenance, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 28a1e0c 18/50: Use xdg-open to dispatch to user preferences for display alist (#40), Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 7b92152 11/50: Merge pull request #39 from rswgnu/add-maintenance-makefile-with-web-site-support, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 7be77e0 12/50: Update git cache interactively, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole ad16470 13/50: Document Koutline Org table support; allow ibtype reprioritization,
Stefan Monnier <=
- [elpa] externals/hyperbole 9f5a787 14/50: Add hypb-maintenance.el, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole e914edb 15/50: Add hypb-maintenance.el to MANIFEST, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole b4f7e49 16/50: Move HY-TALK.org button data to HY-TALK/.hypb, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 781bbb5 17/50: Merge pull request #41 from rswgnu/update-git-repo-cache-interactively, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 22439e6 20/50: Add klink ref cmds, ebut:program and defiblink for programmatic creation, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole e999fc7 21/50: Stop man-apropos from matching to log file entries, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole cfc61a3 22/50: Eliminate a number of order-based byte-compilation warnings, Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole e3544c8 23/50: Revert improper application of "Use \\0 for matched Nth substitution", Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole f1b2cba 24/50: Add dependency on hvar to resolve use of var:remove-all (#43), Stefan Monnier, 2021/03/17
- [elpa] externals/hyperbole 312c858 25/50: kexport.el - use lowercase HTML tags; mail-address ibtype allow trigger in any major mode, Stefan Monnier, 2021/03/17