[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/hyperbole 621b780629: Add HyRolo entry auto-exposure; d
From: |
ELPA Syncer |
Subject: |
[elpa] externals/hyperbole 621b780629: Add HyRolo entry auto-exposure; doc Installation and Org tables |
Date: |
Mon, 17 Jan 2022 13:57:32 -0500 (EST) |
branch: externals/hyperbole
commit 621b780629c4b4c65736fc0fca378e706654c1d9
Author: Robert Weiner <rsw@gnu.org>
Commit: Robert Weiner <rsw@gnu.org>
Add HyRolo entry auto-exposure; doc Installation and Org tables
Rebuild Texinfo manual formats and add Usage chapter near front.
---
ChangeLog | 31 +-
HY-NEWS | 96 +++-
INSTALL | 72 ++-
hibtypes.el | 4 +-
hyrolo.el | 57 +-
man/hyperbole.html | 1486 +++++++++++++++++++++++++++++++++-------------------
man/hyperbole.info | Bin 554080 -> 571131 bytes
man/hyperbole.pdf | Bin 1310127 -> 1324835 bytes
man/hyperbole.texi | 488 ++++++++++-------
9 files changed, 1460 insertions(+), 774 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index df0e3e3b8c..f3e5b811d2 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,22 @@
+2022-01-16 Bob Weiner <rsw@gnu.org>
+
+* EXAMPLE.kotl: Add section on Org table-handling support.
+
+* hyrolo.el (hyrolo-mode): Add use of reveal minor mode.
+ (hyrolo-hide-subtree): Add and bound to {h} to work with reveal
mode.
+ (hyrolo-overview):
+ (hyrolo-top-level): Ensure reveal-mode does not expand current
entry.
+
+* hibtypes.el (Info-node): Tighten match to disallow whitespace in filenames
and reduce
+ false matches.
+
+* install-test/: Update to error if Emacs version < 27 since then Hyperbole
cannot run.
+ Also, indicate that Hyperbole has been activated ater running script.
+* man/hyperbole.texi (Elpa In-Development Package Installation): Add this
section.
+ INSTALL (The Latest Development Snapshot): Add this section.
+ man/hyperbole.texi (Usage): Addes this chapter and included Invocation
section that
+ had been in the Setup Appendix.
+
2022-01-15 Mats Lidell <matsl@gnu.org>
* Makefile (test-ert, test-all): Turn off auto-save.
@@ -886,7 +905,7 @@ Delete knode.el and integrate functionality into kcell.el.
* kotl/kotl-mode.el (kotl-mode:example): Update to allow for
an optional directory or absolute file path. Prompt for
- the path when interactive and given a prefix argument,
+ the path when interactive. Given a prefix argument,
archive any existing file and start with a fresh EXAMPLE.kotl
file. Programmatically, give a 2nd arg of t to force
archiving of any existing file and starting with a fresh
@@ -926,7 +945,7 @@ Delete knode.el and integrate functionality into kcell.el.
* kotl/kotl-mode.el (kotl-mode):
hyperbole.el (fboundp): Do not use with-suppressed-warnings since not
- available in Emacs 26
+ available in all versions of Emacs 27
2021-05-17 Mats Lidell <matsl@gnu.org>
@@ -980,7 +999,7 @@ Delete knode.el and integrate functionality into kcell.el.
* Makefile (version): Do version number check in a portable way.
-* hyperbole.el (hyperb:maybe-load-autoloads, hyperb:maybe-load-autoloads):
+* hyperbole.el (hyperb:maybe-load-autoloads):
Only load autoloads if present.
* hypb.el (hypb:function-copy): Remove XEmacs compatibility code for
@@ -1081,7 +1100,7 @@ Delete knode.el and integrate functionality into kcell.el.
2021-05-12 Mats Lidell <matsl@gnu.org>
* kotl/kotl-mode.el (kotl-mode:backward-paragraph): Remove XEmacs
zmacs-region-stays.
- (kotl-mode): Silence warning about unused filladapt-mode and supress
+ (kotl-mode): Silence warning about unused filladapt-mode and suppress
warning for free vars.
* hui-treemacs.el (treemacs, treemacs-current-button)
@@ -1164,7 +1183,7 @@ Delete knode.el and integrate functionality into kcell.el.
allow for a key series, not just a single bound
key sequence.
(kbd-key:execute): Add to programmatically
- or interactively execute a non-normalized key sequence
+ or interactively execute a non-normalized key series
stored in a string. Also, improve library commentary
and mention this new command.
@@ -1503,7 +1522,7 @@ Delete knode.el and integrate functionality into kcell.el.
* hbut.el (hbut:key-to-label): Ensure is a string and if one char, is not
a punctuation char.
(ibut:to): Fix possible infinite loop if label being tested is one
- one character long. This caused Action Key on "." in path variable values
+ character long. This caused Action Key on "." in path variable values
to hang.
* hpath.el (hpath:path-variable-value-regexp, hpath:at-p): Improved regexp
diff --git a/HY-NEWS b/HY-NEWS
index d87e1fa595..b7ca8e6abf 100644
--- a/HY-NEWS
+++ b/HY-NEWS
@@ -7,14 +7,28 @@
HYPERBOLE SYSTEM
- - Hyperbole is now a global minor mode that can be toggled with {M-x
- hyperbole-mode RET}, meaning all of its key bindings can easily be
- enabled or disabled whenever desired. Your init file needs to have
- (hyperbole-mode 1) in it instead of (require 'hyperbole) or Hyperbole
- will not be enabled upon startup.
+ - Installation: Hyperbole package installation options are greatly
expanded.
+ Stable or in-development branches may be installed with the Emacs package
+ manager. The Straight package manager may be used to keep up with
+ git-based development and submit pull requests. And stable and
+ in-development tar balls are available for manual installation. See
+ "(hyperbole)Installation".
- In the modeline where minor modes are shown, "Hypb" now appears
- whenever Hyperbole is active.
+ - Global Minor Mode: Hyperbole is now a global minor mode that can be
+ toggled with {M-x hyperbole-mode RET}, meaning all of its key bindings
+ can easily be enabled or disabled whenever desired. Your init file needs
+ to have (hyperbole-mode 1) in it instead of (require 'hyperbole) or
+ Hyperbole will not be enabled upon startup. See "(hyperbole)Usage".
+
+ Modeline Indicator: In the modeline where minor modes are shown,
+ "Hypb" now appears whenever Hyperbole is active.
+
+ Hooks: When hyperbole-mode is enabled, hyperbole-mode-hook and
+ hyperbole-mode-on-hook are run. When hyperbole-mode is disabled,
+ hyperbole-mode-hook and hyperbole-mode-off-hook are run.
+
+ Lexical Binding: All code is now largely lexically bound, improving
+ quality and debugability.
ORG MODE
@@ -28,7 +42,10 @@
everywhere. The symbol, buttons, is the default; it means the Smart
Keys are active only when point is within a Hyperbole button. A nil
value means no Smart Key support so {M-RET} behaves just as it does
- normally in Org mode. This table summarizes the operation:
+ normally in Org mode. See "(hyperbole)Org-mode". Use {C-h h c o}
+ to customize this setting.
+
+ This table summarizes the operation:
|--------------+-------------------+------------------+----------+------------------|
| Set To | Smart Key Context | Hyperbole Button | Org Link |
Fallback Command |
@@ -70,7 +87,7 @@
from the command-line when in the Hyperbole source directory and you
should see all tests pass. If any fail, you can press the Action Key
to see the source of the failure. Full testing is suppored under POSIX
- systems only.
+ systems only. See "Makefile".
- Implicit Button Types to Run Tests: The file "hypb-ert.el" contains two
action link types:
@@ -87,21 +104,30 @@
Run all tests
<hyperbole-run-tests t>
- HYROLO
+ HYROLO (See "(hyperbole)HyRolo").
- Faster searching within HyRolo match buffer: After performing a HyRolo
search with point in the match buffer, if you want different results,
you can quickly do a new regular expression HyRolo search with {r} or
- a string/logical search with {C-u r}.
+ a string/logical search with {C-u r}. This key had moved to previous
+ matches but that is already bound to {Shift-TAB} and {M-TAB}.
+
+ - Auto-Expansion of Entries: If an entry is collapsed/hidden, moving to
+ any hidden part auto-expands it and then re-collapses it when point is
+ moved to another entry (just like isearch). A side-effect of this is
+ that the {h} hide entry subtree command now moves to the beginning of
+ the entry.
- hyrolo-find-file: New command that selects and edits a file in
`hyrolo-file-list', defaulting to the first listed file when not given
a prefix arg. Available in the minibuffer menu as Rolo/File and the
pulldown menu as Rolo/Find-HyRolo-File.
- KOUTLINER
+ - hyrolo-highlight-face: Now uses the Emacs 'match' face by default.
- - Export Koutlines to Collapsible Web Pages: The {M-x kexport:html RET}
+ KOUTLINER (See "(hyperbole)Koutliner").
+
+ - Export Koutlines to Collapsible Web Pages: The {M-x kexport:display RET}
command now produces web-based expandable/collapsible outlines.
- Org Table Support: Org table editing now automatically works in the
@@ -114,7 +140,7 @@
- New Mail Tree Key Binding: The kotl-mode:mail-tree command that
extracts the current view of a Koutline in text-only format and
creates an outgoing email messge with it, has moved from {C-c @}
- to {C-c C-@} to prevent conflict with the hycontrol-window-grid
+ to {C-c C-@} to prevent conflict with the global hycontrol-window-grid
command bound to {C-c @}.
- New Tree Demotion/Promotion Keys: Tree promotion and demotion keys now
@@ -147,6 +173,18 @@
kotl-mode:copy-absolute-klink-to-register
kotl-mode:copy-relative-klink-to-register
+ - Prevent Movement Outside Editable Cell Bounds: Add
+ kotl-mode:pre-self-insert-command as a pre-command-hook
+ to prevent Koutline editing with point in an invalid location,
+ after a mouse-set-point outside of editable bounds.
+
+ - {C-h h k e} (kotl-mode:example): Update to allow for an optional
+ directory or absolute file path. Prompt for the path when interactive.
+ Given a prefix argument, archive any existing file and start with a
+ fresh EXAMPLE.kotl file for editing. Programmatically, give a 2nd
+ arg of t to force archiving of any existing file and starting with
+ a fresh EXAMPLE.kotl file.
+
MENUS
- Minibuffer Menu Changes:
@@ -158,15 +196,24 @@
completely and exits from the menu. {C-h h} re-enables the
global minor mode and display the top-level Hyperbole menu.
- SMART (ACTION AND ASSIST) KEYS
+ SMART (ACTION AND ASSIST) KEYS (See "(hyperbole)Smart Keys").
+
+ - Generalized Anchored Pathnames: "pathname#anchor" now works in
+ programming modes as well as text and outlining modes where anchors
+ are prefixed with the comment character in each mode or a # symbol.
- 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.
+ - Treat kbd Strings as Key Series Buttons: An Action Key press within
+ the string of (kbd "string") issues the keys in string as if they were
+ pressed individually, ie.g the same as the key series, {string}.
+
- Mail Address Activation Everywhere: Email addresses are recognized as
- implicit buttons in major modes given by `mail-address-mode-list'. If
- you set that to nil, however, they will be recognized in all major modes.
+ implicit buttons in major modes descended from `mail-address-mode-list'.
+ If you set that to nil, however, they will be recognized in all major
+ modes.
- Magit Mode Support: Just click or press the Action Key somewhere and it
will typically display what you want. Extensive Action Key support in
@@ -228,14 +275,27 @@
are now interactively debuggable via edebug-defun {C-M-x}.
- ebut:program: Programmatically create an explicit Hyperbole button at
- point from LABEL, ACTYPE (action type), and optional actype ARGS.
+ point from LABEL, ACTYPE (action type), and optional actype ARGS.
+
+ - gbut:ebut-program: Programmatically add global explicit buttons at the
+ end of the personal button file.
+
+ - kbd-key implicit button type: Interactive creation now allows for
+ a full key series, not just a single key binding.
- kbd-key:is-p: Added this new predicate to test whether point is within
a brace-delimited key series.
+ - kbd-key:execute: Added to programmatically or interactively execute a
+ non-normalized key series stored in a string.
+
- hypb:def-to-buffer: Quick copying of program definitions and insertion
at the start of another buffer. Can be bound and used in key series.
+ - smart-lisp-find-tag: New function that automatically finds tags tables
+ and jumps to Emacs Lisp deefinitions. It can be used in any type
+ of file as an action button, e.g. <smart-lisp-find-tag "ibut:at-p">.
+
ACE WINDOW PACKAGE INTEGRATION - fast window and buffer switching
- After installing the ace-window package and loading Hyperbole, execute
diff --git a/INSTALL b/INSTALL
index 439daa61db..f0d7460e87 100644
--- a/INSTALL
+++ b/INSTALL
@@ -18,7 +18,7 @@
There are multiple wasy to obtain and install Hyperbole once
you have GNU Emacs set up at your site.
-** The Built-in Emacs Package Manager
+** The Stable Release (from GNU Elpa using the built-in Emacs Package Manager)
The Emacs Package Manager installs the latest stable version release
of GNU Hyperbole. If you are not familiar with it, see the Packages
@@ -38,9 +38,9 @@ several lines to your personal Emacs initialization file,
typically "~/.emacs".
Below are the lines to add:
-(require 'package)
(when (< emacs-major-version 27)
- (package-initialize))
+ (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
+(require 'package)
(unless (package-installed-p 'hyperbole)
(package-refresh-contents)
(package-install 'hyperbole))
@@ -52,7 +52,47 @@ minute or two. You may see a bunch of compilation warnings
but these
can be safely ignored.
-** The Straight Package Manager (direct from Git Sources)
+** The Latest Development Snapshot (from GNU Elpa-Devel using the built-in
Emacs Package Manager)
+
+The Elpa In-Development package pulls from the latest Hyperbole
+development branch tip and does not require installation of any new
+package manager software. Since Hyperbole is a mature package, this is
+usually fine to use and update on a day-to-day basis. But new features
+are tested on this branch and once in awhile it may break for a short
+time before a fix is pushed. With this branch you'll be able to submit
+bug reports and feature requests but will not be able to submit pull
+requests for changes to the developers; use the Git In-Development
+Package instead for that.
+
+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 section, Invocation.
+
+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 "(emacs)Init File", or
+"https://www.gnu.org/software/emacs/manual/html_node/emacs/Init-File.html").
+
+Below are the lines to add:
+
+(when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
+(require 'package)
+(add-to-list 'package-archives '("gnu-devel" . "https://elpa.gnu.org/devel/"))
+(unless (package-installed-p 'hyperbole)
+ (package-refresh-contents)
+ (package-install 'hyperbole))
+(hyperbole-mode 1)
+
+Now save the file and 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.
+
+
+** The Git Master Branch (from git source using the Straight Package Manager)
If you prefer to track Hyperbole development between releases and like
to try out new features still in testing, then use the Straight
@@ -61,8 +101,23 @@ source code from its git repository. This also gives you a
cleaner
installation process without showing you any byte compilation
warnings.
+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 section, Invocation.
+
+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 "(emacs)Init File", or
+"https://www.gnu.org/software/emacs/manual/html_node/emacs/Init-File.html").
+
+Below are the lines to add:
+
;; Use this in your Emacs init file to install Straight
(progn
+ (when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
(defvar bootstrap-version)
(setq package-enable-at-startup nil)
(let ((bootstrap-file
@@ -84,11 +139,14 @@ warnings.
:repo "https://git.savannah.gnu.org/git/hyperbole.git"
:config (hyperbole-mode 1)))
-** Manual Tarball Archive Installation (stable or pre-release)
+Now save the file and restart Emacs. Hyperbole will then be downloaded
+and compiled for use with your version of Emacs; give it a minute or two.
+
+
+** The Stable or Pre-Release Tarball Archive (manually installed)
If you are old-school, don't like package managers, and prefer doing
everything by hand, then you can obtain Hyperbole from a tarball:
-
Download either:
1. a stable release tar.gz source archive from either:
@@ -110,6 +168,8 @@ lines to your personal Emacs initialization file,
"~/.emacs":
(unless (and (featurep 'hyperbole) hyperbole-mode)
+ (when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
(push "<directory-ending-with-hyperbole-where-you-unpacked>" load-path)
(require 'hyperbole)
(hyperbole-mode 1))
diff --git a/hibtypes.el b/hibtypes.el
index 831e684b66..0516f8b882 100644
--- a/hibtypes.el
+++ b/hibtypes.el
@@ -1243,8 +1243,8 @@ Activates only if point is within the first line of the
Info-node name."
(hbut:label-p t "`" "'" t t)))
(ref (car node-ref-and-pos))
(node-ref (and (stringp ref)
- (string-match "\\`([^\):]+)" ref)
- (hpath:is-p (car node-ref-and-pos) nil t))))
+ (string-match-p "\\`([^\): \t\n\r\f]+)" ref)
+ (hpath:is-p ref nil t))))
(and node-ref
(ibut:label-set node-ref-and-pos)
(hact 'link-to-Info-node node-ref))))
diff --git a/hyrolo.el b/hyrolo.el
index 89e1009f5e..39ca3c0328 100644
--- a/hyrolo.el
+++ b/hyrolo.el
@@ -289,8 +289,9 @@ entry which begins with the parent string."
If DISPLAY-BUF is nil, use the value in `hyrolo-display-buffer'.
Second arg RETURN-TO-BUFFER is the buffer to leave point within after the
display."
(interactive)
- (or display-buf (setq display-buf (get-buffer hyrolo-display-buffer)))
- (if display-buf nil
+ (unless display-buf
+ (setq display-buf (get-buffer hyrolo-display-buffer)))
+ (unless display-buf
(error "(hyrolo-display-matches): Search the rolo first"))
;; Save current window configuration if rolo match buffer is not
;; displayed in one of the windows already.
@@ -301,9 +302,11 @@ Second arg RETURN-TO-BUFFER is the buffer to leave point
within after the displa
(error (get-buffer-window display-buf)))
(setq hyrolo--wconfig (current-window-configuration)))
(hyrolo-to-buffer display-buf)
- (if (eq major-mode 'hyrolo-mode) nil (hyrolo-mode))
+ (unless (eq major-mode 'hyrolo-mode)
+ (hyrolo-mode))
(setq buffer-read-only nil)
- (if (fboundp 'hproperty:but-create) (hproperty:but-create))
+ (when (fboundp 'hproperty:but-create)
+ (hproperty:but-create))
(hyrolo-shrink-window)
(goto-char (point-min))
(set-buffer-modified-p nil)
@@ -311,7 +314,8 @@ Second arg RETURN-TO-BUFFER is the buffer to leave point
within after the displa
(run-hooks 'hyrolo-display-hook)
;; Leave point in match buffer unless a specific RETURN-TO-BUFFER has
;; been specified. Use {q} to quit and restore display.
- (if return-to-buffer (hyrolo-to-buffer return-to-buffer)))
+ (when return-to-buffer
+ (hyrolo-to-buffer return-to-buffer)))
;;;###autoload
(defun hyrolo-edit (&optional name file)
@@ -321,14 +325,15 @@ With no NAME arg, simply displays FILE or first entry in
`hyrolo-file-list' in a
editable mode. NAME may be of the form: parent/child to edit child below a
parent entry which begins with the parent string."
(interactive "sEdit rolo entry named: \nP")
- (if (string-equal name "") (setq name nil))
+ (when (string-equal name "")
+ (setq name nil))
(and name (not (stringp name))
(error "(hyrolo-edit): Invalid name: `%s'" name))
- (if (and (called-interactively-p 'interactive) current-prefix-arg)
- (if (= (length hyrolo-file-list) 1)
- (setq file (car hyrolo-file-list))
- (setq file (completing-read "Entry's File: "
- (mapcar #'list hyrolo-file-list)))))
+ (when (and (called-interactively-p 'interactive) current-prefix-arg)
+ (if (= (length hyrolo-file-list) 1)
+ (setq file (car hyrolo-file-list))
+ (setq file (completing-read "Entry's File: "
+ (mapcar #'list hyrolo-file-list)))))
(let ((found-point) (file-list (if file (list file) hyrolo-file-list)))
(or file (setq file (car file-list)))
(if (null name)
@@ -481,6 +486,20 @@ With optional prefix ARG, do an fgrep string match instead
of a regexp match."
(interactive "P")
(call-interactively (if arg 'hyrolo-fgrep 'hyrolo-grep)))
+(defun hyrolo-hide-subtree ()
+ "Move back to the start of current subtree if any and hide everything after
the heading.
+
+Necessary, since with reveal-mode active, outline-hide-subtree works
+only if on the heading line of the subtree."
+ (interactive)
+ (let ((opoint (point)))
+ (forward-line 0)
+ (unless (looking-at outline-regexp)
+ (outline-previous-visible-heading 1))
+ (if (looking-at outline-regexp)
+ (outline-hide-subtree)
+ (goto-char opoint))))
+
(defun hyrolo-isearch (&optional arg)
"Interactively search forward for the next occurrence of the current match
string.
Then add characters to further narrow the search. With optional prefix ARG
non-nil,
@@ -589,13 +608,13 @@ Return t if entry is killed, nil otherwise."
(prior-regexp-search (stringp hyrolo-match-regexp)))
(when (and prior-regexp-search (looking-at hyrolo-match-regexp))
(goto-char (match-end 0)))
- (if (and prior-regexp-search (re-search-forward hyrolo-match-regexp nil
t))
+ (if (and prior-regexp-search (re-search-forward hyrolo-match-regexp nil t))
(goto-char (match-beginning 0))
(goto-char start)
(if prior-regexp-search
- (error
- "(hyrolo-next-match): No following matches for \"%s\""
hyrolo-match-regexp)
- (error "(hyrolo-next-match): No prior regular expression search to
match")))))
+ (error
+ "(hyrolo-next-match): No following matches for \"%s\""
hyrolo-match-regexp)
+ (error "(hyrolo-next-match): No prior regular expression search to
match")))))
(defun hyrolo-overview (levels-to-show)
"Show the first line of all levels of rolo matches.
@@ -609,6 +628,7 @@ With a prefix argument of LEVELS-TO-SHOW > 0, show the
first lines of entries on
(<= levels-to-show 0))
(not (integerp levels-to-show))))
(setq levels-to-show 100))
+ (hyrolo-hide-subtree) ;; Ensure reveal-mode does not expand current entry.
(hyrolo-show-levels levels-to-show))
(defun hyrolo-previous-match ()
@@ -616,8 +636,7 @@ With a prefix argument of LEVELS-TO-SHOW > 0, show the
first lines of entries on
(interactive)
(hyrolo-verify)
(let ((case-fold-search t))
- (if (re-search-backward hyrolo-match-regexp nil t)
- nil
+ (unless (re-search-backward hyrolo-match-regexp nil t)
(error
"(hyrolo-previous-match): No prior matches for \"%s\""
hyrolo-match-regexp))))
@@ -782,6 +801,7 @@ Useful when bound to a mouse key."
"Show only the first line of all `top-level' rolo matches."
(interactive)
(hyrolo-verify)
+ (hyrolo-hide-subtree)
(hyrolo-show-levels 1))
;;;###autoload
@@ -1501,6 +1521,7 @@ Calls the functions given by `hyrolo-mode-hook'.
;;
(when (fboundp 'outline-minor-mode)
(outline-minor-mode 1))
+ (reveal-mode 1) ;; Expose hidden text as move into it.
(run-hooks 'hyrolo-mode-hook))
;;; ************************************************************************
@@ -1576,7 +1597,7 @@ String search expressions are converted to regular
expressions.")
(define-key hyrolo-mode-map "b" 'outline-backward-same-level)
(define-key hyrolo-mode-map "e" 'hyrolo-edit-entry)
(define-key hyrolo-mode-map "f" 'outline-forward-same-level)
- (define-key hyrolo-mode-map "h" 'outline-hide-subtree)
+ (define-key hyrolo-mode-map "h" 'hyrolo-hide-subtree)
(define-key hyrolo-mode-map "l" 'hyrolo-locate)
(define-key hyrolo-mode-map "m" 'hyrolo-mail-to)
(define-key hyrolo-mode-map "n" 'outline-next-visible-heading)
diff --git a/man/hyperbole.html b/man/hyperbole.html
index 3b485e569a..282b6e19af 100644
--- a/man/hyperbole.html
+++ b/man/hyperbole.html
@@ -1,9 +1,9 @@
<!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 8.0.0pre, Published December, 2021).
+(Edition 8.0.0pre, Published January, 2022).
-Copyright (C) 1989-2021 Free Software Foundation, Inc.
+Copyright (C) 1989-2022 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -81,14 +81,15 @@ ul.no-bullet {list-style: none}
<ul class="no-bullet">
<li><a id="stoc-GNU-Hyperbole" href="#toc-GNU-Hyperbole">GNU Hyperbole</a></li>
<li><a id="stoc-Introduction-1" href="#toc-Introduction-1">1
Introduction</a></li>
-<li><a id="stoc-Smart-Keys-1" href="#toc-Smart-Keys-1">2 Smart Keys</a></li>
-<li><a id="stoc-Buttons-1" href="#toc-Buttons-1">3 Buttons</a></li>
-<li><a id="stoc-Menus-1" href="#toc-Menus-1">4 Menus</a></li>
-<li><a id="stoc-HyControl-1" href="#toc-HyControl-1">5 HyControl</a></li>
-<li><a id="stoc-Koutliner-1" href="#toc-Koutliner-1">6 Koutliner</a></li>
-<li><a id="stoc-HyRolo-1" href="#toc-HyRolo-1">7 HyRolo</a></li>
-<li><a id="stoc-Window-Configurations-1" href="#toc-Window-Configurations-1">8
Window Configurations</a></li>
-<li><a id="stoc-Developing-with-Hyperbole-1"
href="#toc-Developing-with-Hyperbole-1">9 Developing with Hyperbole</a></li>
+<li><a id="stoc-Usage-1" href="#toc-Usage-1">2 Usage</a></li>
+<li><a id="stoc-Smart-Keys-1" href="#toc-Smart-Keys-1">3 Smart Keys</a></li>
+<li><a id="stoc-Buttons-1" href="#toc-Buttons-1">4 Buttons</a></li>
+<li><a id="stoc-Menus-1" href="#toc-Menus-1">5 Menus</a></li>
+<li><a id="stoc-HyControl-1" href="#toc-HyControl-1">6 HyControl</a></li>
+<li><a id="stoc-Koutliner-1" href="#toc-Koutliner-1">7 Koutliner</a></li>
+<li><a id="stoc-HyRolo-1" href="#toc-HyRolo-1">8 HyRolo</a></li>
+<li><a id="stoc-Window-Configurations-1" href="#toc-Window-Configurations-1">9
Window Configurations</a></li>
+<li><a id="stoc-Developing-with-Hyperbole-1"
href="#toc-Developing-with-Hyperbole-1">10 Developing with Hyperbole</a></li>
<li><a id="stoc-Glossary-1" href="#toc-Glossary-1">Appendix A Glossary</a></li>
<li><a id="stoc-Setup-1" href="#toc-Setup-1">Appendix B Setup</a></li>
<li><a id="stoc-Hyperbole-Key-Bindings-1"
href="#toc-Hyperbole-Key-Bindings-1">Appendix C Hyperbole Key Bindings</a></li>
@@ -118,142 +119,149 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Hyperbole-Overview-1" href="#Hyperbole-Overview">1.3
Hyperbole Overview</a></li>
<li><a id="toc-Mail-Lists-1" href="#Mail-Lists">1.4 Mail Lists</a></li>
</ul></li>
-<li><a id="toc-Smart-Keys-1" href="#Smart-Keys">2 Smart Keys</a>
+<li><a id="toc-Usage-1" href="#Usage">2 Usage</a>
<ul class="no-bullet">
- <li><a id="toc-Smart-Key-Bindings-1" href="#Smart-Key-Bindings">2.1 Smart
Key Bindings</a></li>
- <li><a id="toc-Smart-Key-Operations-1" href="#Smart-Key-Operations">2.2
Smart Key Operations</a></li>
- <li><a id="toc-Smart-Key-Argument-Selection-1"
href="#Smart-Key-Argument-Selection">2.3 Smart Key Argument Selection</a></li>
- <li><a id="toc-Smart-Key-Debugging-1" href="#Smart-Key-Debugging">2.4 Smart
Key Debugging</a></li>
- <li><a id="toc-Smart-Key-Thing-Selection-1"
href="#Smart-Key-Thing-Selection">2.5 Smart Key Thing Selection</a></li>
- <li><a id="toc-Smart-Mouse-Key-Modeline-Clicks-1"
href="#Smart-Mouse-Key-Modeline-Clicks">2.6 Smart Mouse Key Modeline
Clicks</a></li>
- <li><a id="toc-Smart-Mouse-Key-Drags-1" href="#Smart-Mouse-Key-Drags">2.7
Smart Mouse Key Drags</a>
+ <li><a id="toc-Invocation-1" href="#Invocation">2.1 Invocation</a></li>
+ <li><a id="toc-Documentation-1" href="#Documentation">2.2
Documentation</a></li>
+ <li><a id="toc-Hyperbole-Hooks-1" href="#Hyperbole-Hooks">2.3 Hyperbole
Hooks</a></li>
+</ul></li>
+<li><a id="toc-Smart-Keys-1" href="#Smart-Keys">3 Smart Keys</a>
+<ul class="no-bullet">
+ <li><a id="toc-Smart-Key-Bindings-1" href="#Smart-Key-Bindings">3.1 Smart
Key Bindings</a></li>
+ <li><a id="toc-Smart-Key-Operations-1" href="#Smart-Key-Operations">3.2
Smart Key Operations</a></li>
+ <li><a id="toc-Smart-Key-Argument-Selection-1"
href="#Smart-Key-Argument-Selection">3.3 Smart Key Argument Selection</a></li>
+ <li><a id="toc-Smart-Key-Debugging-1" href="#Smart-Key-Debugging">3.4 Smart
Key Debugging</a></li>
+ <li><a id="toc-Smart-Key-Thing-Selection-1"
href="#Smart-Key-Thing-Selection">3.5 Smart Key Thing Selection</a></li>
+ <li><a id="toc-Smart-Mouse-Key-Modeline-Clicks-1"
href="#Smart-Mouse-Key-Modeline-Clicks">3.6 Smart Mouse Key Modeline
Clicks</a></li>
+ <li><a id="toc-Smart-Mouse-Key-Drags-1" href="#Smart-Mouse-Key-Drags">3.7
Smart Mouse Key Drags</a>
<ul class="no-bullet">
- <li><a id="toc-Creating-and-Deleting-Windows-1"
href="#Creating-and-Deleting-Windows">2.7.1 Creating and Deleting
Windows</a></li>
- <li><a id="toc-Saving-and-Restoring-Window-Configurations-1"
href="#Saving-and-Restoring-Window-Configurations">2.7.2 Saving and Restoring
Window Configurations</a></li>
- <li><a id="toc-Resizing-Windows-1" href="#Resizing-Windows">2.7.3 Resizing
Windows</a></li>
- <li><a id="toc-Moving-Frames-1" href="#Moving-Frames">2.7.4 Moving
Frames</a></li>
- <li><a id="toc-Dragging-Buffers_002c-Windows-and-Items"
href="#Dragging-Buffers">2.7.5 Dragging Buffers, Windows and Items</a>
+ <li><a id="toc-Creating-and-Deleting-Windows-1"
href="#Creating-and-Deleting-Windows">3.7.1 Creating and Deleting
Windows</a></li>
+ <li><a id="toc-Saving-and-Restoring-Window-Configurations-1"
href="#Saving-and-Restoring-Window-Configurations">3.7.2 Saving and Restoring
Window Configurations</a></li>
+ <li><a id="toc-Resizing-Windows-1" href="#Resizing-Windows">3.7.3 Resizing
Windows</a></li>
+ <li><a id="toc-Moving-Frames-1" href="#Moving-Frames">3.7.4 Moving
Frames</a></li>
+ <li><a id="toc-Dragging-Buffers_002c-Windows-and-Items"
href="#Dragging-Buffers">3.7.5 Dragging Buffers, Windows and Items</a>
<ul class="no-bullet">
- <li><a id="toc-Swapping-Buffers-1" href="#Swapping-Buffers">2.7.5.1
Swapping Buffers</a></li>
- <li><a id="toc-Displaying-Buffers-1" href="#Displaying-Buffers">2.7.5.2
Displaying Buffers</a></li>
- <li><a id="toc-Cloning-Windows-1" href="#Cloning-Windows">2.7.5.3
Cloning Windows</a></li>
- <li><a id="toc-Displaying-File-and-Buffer-Items-1"
href="#Displaying-File-and-Buffer-Items">2.7.5.4 Displaying File and Buffer
Items</a></li>
- <li><a id="toc-Keyboard-Drags-1" href="#Keyboard-Drags">2.7.5.5 Keyboard
Drags</a></li>
+ <li><a id="toc-Swapping-Buffers-1" href="#Swapping-Buffers">3.7.5.1
Swapping Buffers</a></li>
+ <li><a id="toc-Displaying-Buffers-1" href="#Displaying-Buffers">3.7.5.2
Displaying Buffers</a></li>
+ <li><a id="toc-Cloning-Windows-1" href="#Cloning-Windows">3.7.5.3
Cloning Windows</a></li>
+ <li><a id="toc-Displaying-File-and-Buffer-Items-1"
href="#Displaying-File-and-Buffer-Items">3.7.5.4 Displaying File and Buffer
Items</a></li>
+ <li><a id="toc-Keyboard-Drags-1" href="#Keyboard-Drags">3.7.5.5 Keyboard
Drags</a></li>
</ul></li>
</ul></li>
</ul></li>
-<li><a id="toc-Buttons-1" href="#Buttons">3 Buttons</a>
+<li><a id="toc-Buttons-1" href="#Buttons">4 Buttons</a>
<ul class="no-bullet">
- <li><a id="toc-Explicit-Buttons-1" href="#Explicit-Buttons">3.1 Explicit
Buttons</a></li>
- <li><a id="toc-Global-Buttons-1" href="#Global-Buttons">3.2 Global
Buttons</a></li>
- <li><a id="toc-Implicit-Buttons-1" href="#Implicit-Buttons">3.3 Implicit
Buttons</a>
+ <li><a id="toc-Explicit-Buttons-1" href="#Explicit-Buttons">4.1 Explicit
Buttons</a></li>
+ <li><a id="toc-Global-Buttons-1" href="#Global-Buttons">4.2 Global
Buttons</a></li>
+ <li><a id="toc-Implicit-Buttons-1" href="#Implicit-Buttons">4.3 Implicit
Buttons</a>
<ul class="no-bullet">
- <li><a id="toc-Implicit-Button-Types-1"
href="#Implicit-Button-Types">3.3.1 Implicit Button Types</a></li>
- <li><a id="toc-Action-Buttons-1" href="#Action-Buttons">3.3.2 Action
Buttons</a></li>
+ <li><a id="toc-Implicit-Button-Types-1"
href="#Implicit-Button-Types">4.3.1 Implicit Button Types</a></li>
+ <li><a id="toc-Action-Buttons-1" href="#Action-Buttons">4.3.2 Action
Buttons</a></li>
</ul></li>
- <li><a id="toc-Button-Files-1" href="#Button-Files">3.4 Button Files</a></li>
- <li><a id="toc-Action-Types-1" href="#Action-Types">3.5 Action Types</a></li>
- <li><a id="toc-Button-Type-Precedence-1" href="#Button-Type-Precedence">3.6
Button Type Precedence</a></li>
- <li><a id="toc-Utilizing-Explicit-Buttons-1"
href="#Utilizing-Explicit-Buttons">3.7 Utilizing Explicit Buttons</a>
+ <li><a id="toc-Button-Files-1" href="#Button-Files">4.4 Button Files</a></li>
+ <li><a id="toc-Action-Types-1" href="#Action-Types">4.5 Action Types</a></li>
+ <li><a id="toc-Button-Type-Precedence-1" href="#Button-Type-Precedence">4.6
Button Type Precedence</a></li>
+ <li><a id="toc-Utilizing-Explicit-Buttons-1"
href="#Utilizing-Explicit-Buttons">4.7 Utilizing Explicit Buttons</a>
<ul class="no-bullet">
- <li><a id="toc-Creation-1" href="#Creation">3.7.1 Creation</a>
+ <li><a id="toc-Creation-1" href="#Creation">4.7.1 Creation</a>
<ul class="no-bullet">
- <li><a id="toc-Creation-Via-Action-Key-Drags"
href="#By-Dragging">3.7.1.1 Creation Via Action Key Drags</a></li>
- <li><a id="toc-Creation-Via-Menus" href="#By-Menu">3.7.1.2 Creation Via
Menus</a></li>
+ <li><a id="toc-Creation-Via-Action-Key-Drags"
href="#By-Dragging">4.7.1.1 Creation Via Action Key Drags</a></li>
+ <li><a id="toc-Creation-Via-Menus" href="#By-Menu">4.7.1.2 Creation Via
Menus</a></li>
</ul></li>
- <li><a id="toc-Renaming-1" href="#Renaming">3.7.2 Renaming</a></li>
- <li><a id="toc-Deletion-1" href="#Deletion">3.7.3 Deletion</a></li>
- <li><a id="toc-Modification-1" href="#Modification">3.7.4
Modification</a></li>
- <li><a id="toc-Searching-and-Summarizing-1"
href="#Searching-and-Summarizing">3.7.5 Searching and Summarizing</a></li>
- <li><a id="toc-Buttons-in-Mail-1" href="#Buttons-in-Mail">3.7.6 Buttons in
Mail</a></li>
- <li><a id="toc-Buttons-in-News-1" href="#Buttons-in-News">3.7.7 Buttons in
News</a></li>
+ <li><a id="toc-Renaming-1" href="#Renaming">4.7.2 Renaming</a></li>
+ <li><a id="toc-Deletion-1" href="#Deletion">4.7.3 Deletion</a></li>
+ <li><a id="toc-Modification-1" href="#Modification">4.7.4
Modification</a></li>
+ <li><a id="toc-Searching-and-Summarizing-1"
href="#Searching-and-Summarizing">4.7.5 Searching and Summarizing</a></li>
+ <li><a id="toc-Buttons-in-Mail-1" href="#Buttons-in-Mail">4.7.6 Buttons in
Mail</a></li>
+ <li><a id="toc-Buttons-in-News-1" href="#Buttons-in-News">4.7.7 Buttons in
News</a></li>
</ul></li>
</ul></li>
-<li><a id="toc-Menus-1" href="#Menus">4 Menus</a></li>
-<li><a id="toc-HyControl-1" href="#HyControl">5 HyControl</a></li>
-<li><a id="toc-Koutliner-1" href="#Koutliner">6 Koutliner</a>
+<li><a id="toc-Menus-1" href="#Menus">5 Menus</a></li>
+<li><a id="toc-HyControl-1" href="#HyControl">6 HyControl</a></li>
+<li><a id="toc-Koutliner-1" href="#Koutliner">7 Koutliner</a>
<ul class="no-bullet">
- <li><a id="toc-Menu-Commands-1" href="#Menu-Commands">6.1 Menu
Commands</a></li>
- <li><a id="toc-Creating-Outlines-1" href="#Creating-Outlines">6.2 Creating
Outlines</a></li>
- <li><a id="toc-Autonumbering-1" href="#Autonumbering">6.3
Autonumbering</a></li>
- <li><a id="toc-Idstamps-1" href="#Idstamps">6.4 Idstamps</a></li>
- <li><a id="toc-Editing-1" href="#Editing">6.5 Editing</a>
+ <li><a id="toc-Menu-Commands-1" href="#Menu-Commands">7.1 Menu
Commands</a></li>
+ <li><a id="toc-Creating-Outlines-1" href="#Creating-Outlines">7.2 Creating
Outlines</a></li>
+ <li><a id="toc-Autonumbering-1" href="#Autonumbering">7.3
Autonumbering</a></li>
+ <li><a id="toc-Idstamps-1" href="#Idstamps">7.4 Idstamps</a></li>
+ <li><a id="toc-Editing-1" href="#Editing">7.5 Editing</a>
<ul class="no-bullet">
- <li><a id="toc-Adding-and-Killing-1" href="#Adding-and-Killing">6.5.1
Adding and Killing</a></li>
- <li><a id="toc-Relocating-and-Copying-1"
href="#Relocating-and-Copying">6.5.2 Relocating and Copying</a></li>
- <li><a id="toc-Moving-Around-1" href="#Moving-Around">6.5.3 Moving
Around</a></li>
- <li><a id="toc-Filling-1" href="#Filling">6.5.4 Filling</a></li>
- <li><a id="toc-Transposing-1" href="#Transposing">6.5.5
Transposing</a></li>
- <li><a id="toc-Splitting-and-Appending-1"
href="#Splitting-and-Appending">6.5.6 Splitting and Appending</a></li>
- <li><a id="toc-Inserting-and-Importing-1"
href="#Inserting-and-Importing">6.5.7 Inserting and Importing</a></li>
- <li><a id="toc-Exporting-1" href="#Exporting">6.5.8 Exporting</a></li>
+ <li><a id="toc-Adding-and-Killing-1" href="#Adding-and-Killing">7.5.1
Adding and Killing</a></li>
+ <li><a id="toc-Relocating-and-Copying-1"
href="#Relocating-and-Copying">7.5.2 Relocating and Copying</a></li>
+ <li><a id="toc-Moving-Around-1" href="#Moving-Around">7.5.3 Moving
Around</a></li>
+ <li><a id="toc-Filling-1" href="#Filling">7.5.4 Filling</a></li>
+ <li><a id="toc-Transposing-1" href="#Transposing">7.5.5
Transposing</a></li>
+ <li><a id="toc-Splitting-and-Appending-1"
href="#Splitting-and-Appending">7.5.6 Splitting and Appending</a></li>
+ <li><a id="toc-Inserting-and-Importing-1"
href="#Inserting-and-Importing">7.5.7 Inserting and Importing</a></li>
+ <li><a id="toc-Exporting-1" href="#Exporting">7.5.8 Exporting</a></li>
</ul></li>
- <li><a id="toc-Viewing-1" href="#Viewing">6.6 Viewing</a>
+ <li><a id="toc-Viewing-1" href="#Viewing">7.6 Viewing</a>
<ul class="no-bullet">
- <li><a id="toc-Hiding-and-Showing-1" href="#Hiding-and-Showing">6.6.1
Hiding and Showing</a></li>
- <li><a id="toc-View-Specs-1" href="#View-Specs">6.6.2 View Specs</a></li>
+ <li><a id="toc-Hiding-and-Showing-1" href="#Hiding-and-Showing">7.6.1
Hiding and Showing</a></li>
+ <li><a id="toc-View-Specs-1" href="#View-Specs">7.6.2 View Specs</a></li>
</ul></li>
- <li><a id="toc-Links-1" href="#Links">6.7 Links</a></li>
- <li><a id="toc-Cell-Attributes-1" href="#Cell-Attributes">6.8 Cell
Attributes</a></li>
- <li><a id="toc-Koutliner-History-1" href="#Koutliner-History">6.9 Koutliner
History</a></li>
+ <li><a id="toc-Links-1" href="#Links">7.7 Links</a></li>
+ <li><a id="toc-Cell-Attributes-1" href="#Cell-Attributes">7.8 Cell
Attributes</a></li>
+ <li><a id="toc-Koutliner-History-1" href="#Koutliner-History">7.9 Koutliner
History</a></li>
</ul></li>
-<li><a id="toc-HyRolo-1" href="#HyRolo">7 HyRolo</a>
+<li><a id="toc-HyRolo-1" href="#HyRolo">8 HyRolo</a>
<ul class="no-bullet">
- <li><a id="toc-HyRolo-Concepts-1" href="#HyRolo-Concepts">7.1 HyRolo
Concepts</a></li>
- <li><a id="toc-Rolo-Menu" href="#HyRolo-Menu">7.2 Rolo Menu</a></li>
- <li><a id="toc-HyRolo-Searching-1" href="#HyRolo-Searching">7.3 HyRolo
Searching</a></li>
- <li><a id="toc-HyRolo-Keys-1" href="#HyRolo-Keys">7.4 HyRolo Keys</a></li>
- <li><a id="toc-HyRolo-Settings-1" href="#HyRolo-Settings">7.5 HyRolo
Settings</a></li>
+ <li><a id="toc-HyRolo-Concepts-1" href="#HyRolo-Concepts">8.1 HyRolo
Concepts</a></li>
+ <li><a id="toc-Rolo-Menu" href="#HyRolo-Menu">8.2 Rolo Menu</a></li>
+ <li><a id="toc-HyRolo-Searching-1" href="#HyRolo-Searching">8.3 HyRolo
Searching</a></li>
+ <li><a id="toc-HyRolo-Keys-1" href="#HyRolo-Keys">8.4 HyRolo Keys</a></li>
+ <li><a id="toc-HyRolo-Settings-1" href="#HyRolo-Settings">8.5 HyRolo
Settings</a></li>
</ul></li>
-<li><a id="toc-Window-Configurations-1" href="#Window-Configurations">8 Window
Configurations</a></li>
-<li><a id="toc-Developing-with-Hyperbole-1"
href="#Developing-with-Hyperbole">9 Developing with Hyperbole</a>
+<li><a id="toc-Window-Configurations-1" href="#Window-Configurations">9 Window
Configurations</a></li>
+<li><a id="toc-Developing-with-Hyperbole-1"
href="#Developing-with-Hyperbole">10 Developing with Hyperbole</a>
<ul class="no-bullet">
- <li><a id="toc-Hook-Variables-1" href="#Hook-Variables">9.1 Hook
Variables</a></li>
- <li><a id="toc-Creating-Types-1" href="#Creating-Types">9.2 Creating
Types</a>
+ <li><a id="toc-Hook-Variables-1" href="#Hook-Variables">10.1 Hook
Variables</a></li>
+ <li><a id="toc-Creating-Types-1" href="#Creating-Types">10.2 Creating
Types</a>
<ul class="no-bullet">
- <li><a id="toc-Creating-Action-Types-1"
href="#Creating-Action-Types">9.2.1 Creating Action Types</a></li>
- <li><a id="toc-Creating-Implicit-Button-Types-1"
href="#Creating-Implicit-Button-Types">9.2.2 Creating Implicit Button Types</a>
+ <li><a id="toc-Creating-Action-Types-1"
href="#Creating-Action-Types">10.2.1 Creating Action Types</a></li>
+ <li><a id="toc-Creating-Implicit-Button-Types-1"
href="#Creating-Implicit-Button-Types">10.2.2 Creating Implicit Button Types</a>
<ul class="no-bullet">
- <li><a id="toc-Action-Button-Link-Types-1"
href="#Action-Button-Link-Types">9.2.2.1 Action Button Link Types</a></li>
- <li><a id="toc-Implicit-Button-Link-Types-1"
href="#Implicit-Button-Link-Types">9.2.2.2 Implicit Button Link Types</a></li>
- <li><a id="toc-Programmatic-Implicit-Button-Types-1"
href="#Programmatic-Implicit-Button-Types">9.2.2.3 Programmatic Implicit Button
Types</a></li>
+ <li><a id="toc-Action-Button-Link-Types-1"
href="#Action-Button-Link-Types">10.2.2.1 Action Button Link Types</a></li>
+ <li><a id="toc-Implicit-Button-Link-Types-1"
href="#Implicit-Button-Link-Types">10.2.2.2 Implicit Button Link Types</a></li>
+ <li><a id="toc-Programmatic-Implicit-Button-Types-1"
href="#Programmatic-Implicit-Button-Types">10.2.2.3 Programmatic Implicit
Button Types</a></li>
</ul></li>
</ul></li>
- <li><a id="toc-Explicit-Button-Technicalities-1"
href="#Explicit-Button-Technicalities">9.3 Explicit Button Technicalities</a>
+ <li><a id="toc-Explicit-Button-Technicalities-1"
href="#Explicit-Button-Technicalities">10.3 Explicit Button Technicalities</a>
<ul class="no-bullet">
- <li><a id="toc-Button-Label-Normalization-1"
href="#Button-Label-Normalization">9.3.1 Button Label Normalization</a></li>
- <li><a id="toc-Operational-and-Storage-Formats-1"
href="#Operational-and-Storage-Formats">9.3.2 Operational and Storage
Formats</a></li>
- <li><a id="toc-Programmatic-Button-Creation-1"
href="#Programmatic-Button-Creation">9.3.3 Programmatic Button Creation</a></li>
+ <li><a id="toc-Button-Label-Normalization-1"
href="#Button-Label-Normalization">10.3.1 Button Label Normalization</a></li>
+ <li><a id="toc-Operational-and-Storage-Formats-1"
href="#Operational-and-Storage-Formats">10.3.2 Operational and Storage
Formats</a></li>
+ <li><a id="toc-Programmatic-Button-Creation-1"
href="#Programmatic-Button-Creation">10.3.3 Programmatic Button
Creation</a></li>
</ul></li>
- <li><a id="toc-Encapsulating-Systems-1" href="#Encapsulating-Systems">9.4
Encapsulating Systems</a></li>
- <li><a id="toc-Embedding-Hyperbole-1" href="#Embedding-Hyperbole">9.5
Embedding Hyperbole</a></li>
+ <li><a id="toc-Encapsulating-Systems-1" href="#Encapsulating-Systems">10.4
Encapsulating Systems</a></li>
+ <li><a id="toc-Embedding-Hyperbole-1" href="#Embedding-Hyperbole">10.5
Embedding Hyperbole</a></li>
</ul></li>
<li><a id="toc-Glossary-1" href="#Glossary">Appendix A Glossary</a></li>
<li><a id="toc-Setup-1" href="#Setup">Appendix B Setup</a>
<ul class="no-bullet">
<li><a id="toc-Installation-1" href="#Installation">B.1 Installation</a>
<ul class="no-bullet">
- <li><a
id="toc-Stable-Package-Installation-_0028Emacs-Package-Manager_0029"
href="#Stable-Package-Installation">B.1.1 Stable Package Installation (Emacs
Package Manager)</a></li>
- <li><a
id="toc-Git-Pre_002drelease-Package-Installation-_0028Straight-Package-Manager_0029"
href="#Git-Pre_002drelease-Package-Installation">B.1.2 Git Pre-release Package
Installation (Straight Package Manager)</a></li>
- <li><a id="toc-Manual-Tarball-Archive-Installation-1"
href="#Manual-Tarball-Archive-Installation">B.1.3 Manual Tarball Archive
Installation</a></li>
+ <li><a
id="toc-Elpa-Stable-Package-Installation-_0028Emacs-Package-Manager_0029"
href="#Elpa-Stable-Package-Installation">B.1.1 Elpa Stable Package Installation
(Emacs Package Manager)</a></li>
+ <li><a id="toc-Elpa-In_002dDevelopment-Package-Installation-1"
href="#Elpa-In_002dDevelopment-Package-Installation">B.1.2 Elpa In-Development
Package Installation</a></li>
+ <li><a
id="toc-Git-In_002dDevelopment-Package-Installation-_0028Straight-Package-Manager_0029"
href="#Git-In_002dDevelopment-Package-Installation">B.1.3 Git In-Development
Package Installation (Straight Package Manager)</a></li>
+ <li><a id="toc-Manual-Tarball-Archive-Installation-1"
href="#Manual-Tarball-Archive-Installation">B.1.4 Manual Tarball Archive
Installation</a></li>
</ul></li>
- <li><a id="toc-Invocation-1" href="#Invocation">B.2 Invocation</a></li>
- <li><a id="toc-Customization-1" href="#Customization">B.3 Customization</a>
+ <li><a id="toc-Customization-1" href="#Customization">B.2 Customization</a>
<ul class="no-bullet">
- <li><a id="toc-Referent-Display-1" href="#Referent-Display">B.3.1 Referent
Display</a></li>
- <li><a id="toc-Internal-Viewers-1" href="#Internal-Viewers">B.3.2 Internal
Viewers</a></li>
- <li><a id="toc-External-Viewers-1" href="#External-Viewers">B.3.3 External
Viewers</a></li>
- <li><a id="toc-Link-Variable-Substitution-1"
href="#Link-Variable-Substitution">B.3.4 Link Variable Substitution</a></li>
- <li><a id="toc-Web-Search-Engines-1" href="#Web-Search-Engines">B.3.5 Web
Search Engines</a></li>
- <li><a id="toc-Using-URLs-with-Find_002dFile-1"
href="#Using-URLs-with-Find_002dFile">B.3.6 Using URLs with Find-File</a></li>
- <li><a id="toc-Invisible-Text-Searches-1"
href="#Invisible-Text-Searches">B.3.7 Invisible Text Searches</a></li>
- <li><a id="toc-Configuring-Button-Colors" href="#Button-Colors">B.3.8
Configuring Button Colors</a></li>
+ <li><a id="toc-Referent-Display-1" href="#Referent-Display">B.2.1 Referent
Display</a></li>
+ <li><a id="toc-Internal-Viewers-1" href="#Internal-Viewers">B.2.2 Internal
Viewers</a></li>
+ <li><a id="toc-External-Viewers-1" href="#External-Viewers">B.2.3 External
Viewers</a></li>
+ <li><a id="toc-Link-Variable-Substitution-1"
href="#Link-Variable-Substitution">B.2.4 Link Variable Substitution</a></li>
+ <li><a id="toc-Web-Search-Engines-1" href="#Web-Search-Engines">B.2.5 Web
Search Engines</a></li>
+ <li><a id="toc-Using-URLs-with-Find_002dFile-1"
href="#Using-URLs-with-Find_002dFile">B.2.6 Using URLs with Find-File</a></li>
+ <li><a id="toc-Invisible-Text-Searches-1"
href="#Invisible-Text-Searches">B.2.7 Invisible Text Searches</a></li>
+ <li><a id="toc-Configuring-Button-Colors" href="#Button-Colors">B.2.8
Configuring Button Colors</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Hyperbole-Key-Bindings-1"
href="#Hyperbole-Key-Bindings">Appendix C Hyperbole Key Bindings</a>
<ul class="no-bullet">
<li><a id="toc-Binding-Minibuffer-Menu-Items-1"
href="#Binding-Minibuffer-Menu-Items">C.1 Binding Minibuffer Menu Items</a></li>
<li><a id="toc-Default-Hyperbole-Bindings-1"
href="#Default-Hyperbole-Bindings">C.2 Default Hyperbole Bindings</a></li>
+ <li><a id="toc-Testing-1" href="#Testing">C.3 Testing</a></li>
</ul></li>
<li><a id="toc-Koutliner-Keys-1" href="#Koutliner-Keys">Appendix D Koutliner
Keys</a></li>
<li><a id="toc-Smart-Key-Reference-1" href="#Smart-Key-Reference">Appendix E
Smart Key Reference</a>
@@ -271,52 +279,55 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Smart-Keyboard-Keys-1" href="#Smart-Keyboard-Keys">E.2 Smart
Keyboard Keys</a>
<ul class="no-bullet">
<li><a id="toc-Smart-Key-_002d-Company-Mode-1"
href="#Smart-Key-_002d-Company-Mode">E.2.1 Smart Key - Company Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Treemacs-1"
href="#Smart-Key-_002d-Treemacs">E.2.2 Smart Key - Treemacs</a></li>
- <li><a id="toc-Smart-Key-_002d-Dired-Sidebar-Mode-1"
href="#Smart-Key-_002d-Dired-Sidebar-Mode">E.2.3 Smart Key - Dired Sidebar
Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Emacs-Pushbuttons-1"
href="#Smart-Key-_002d-Emacs-Pushbuttons">E.2.4 Smart Key - Emacs
Pushbuttons</a></li>
- <li><a id="toc-Smart-Key-_002d-Argument-Completion-1"
href="#Smart-Key-_002d-Argument-Completion">E.2.5 Smart Key - Argument
Completion</a></li>
- <li><a id="toc-Smart-Key-_002d-ID-Edit-Mode-1"
href="#Smart-Key-_002d-ID-Edit-Mode">E.2.6 Smart Key - ID Edit Mode</a></li>
- <li><a
id="toc-Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029-1"
href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029">E.2.7 Smart
Key - Emacs Cross-references (Xrefs)</a></li>
- <li><a id="toc-Smart-Key-_002d-Smart-Scrolling-1"
href="#Smart-Key-_002d-Smart-Scrolling">E.2.8 Smart Key - Smart
Scrolling</a></li>
- <li><a id="toc-Smart-Key-_002d-Smart-Menus-1"
href="#Smart-Key-_002d-Smart-Menus">E.2.9 Smart Key - Smart Menus</a></li>
- <li><a id="toc-Smart-Key-_002d-Dired-Mode-1"
href="#Smart-Key-_002d-Dired-Mode">E.2.10 Smart Key - Dired Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Hyperbole-Buttons-1"
href="#Smart-Key-_002d-Hyperbole-Buttons">E.2.11 Smart Key - Hyperbole
Buttons</a></li>
- <li><a id="toc-Smart-Key-_002d-View-Mode-1"
href="#Smart-Key-_002d-View-Mode">E.2.12 Smart Key - View Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Helm-Mode-1"
href="#Smart-Key-_002d-Helm-Mode">E.2.13 Smart Key - Helm Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Delimited-Things-1"
href="#Smart-Key-_002d-Delimited-Things">E.2.14 Smart Key - Delimited
Things</a></li>
- <li><a id="toc-Smart-Key-_002d-The-Koutliner-1"
href="#Smart-Key-_002d-The-Koutliner">E.2.15 Smart Key - The Koutliner</a></li>
- <li><a id="toc-Smart-Key-_002d-RDB-Mode-1"
href="#Smart-Key-_002d-RDB-Mode">E.2.16 Smart Key - RDB Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Help-Buffers-1"
href="#Smart-Key-_002d-Help-Buffers">E.2.17 Smart Key - Help Buffers</a></li>
- <li><a id="toc-Smart-Key-_002d-Bookmark-Mode-1"
href="#Smart-Key-_002d-Bookmark-Mode">E.2.18 Smart Key - Bookmark Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Pages-Directory-Mode-1"
href="#Smart-Key-_002d-Pages-Directory-Mode">E.2.19 Smart Key - Pages Directory
Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Python-Source-Code-1"
href="#Smart-Key-_002d-Python-Source-Code">E.2.20 Smart Key - Python Source
Code</a></li>
- <li><a id="toc-Smart-Key-_002d-Identifier-Menu-Mode-1"
href="#Smart-Key-_002d-Identifier-Menu-Mode">E.2.21 Smart Key - Identifier Menu
Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-C-Source-Code-1"
href="#Smart-Key-_002d-C-Source-Code">E.2.22 Smart Key - C Source Code</a></li>
- <li><a id="toc-Smart-Key-_002d-C_002b_002b-Source-Code-1"
href="#Smart-Key-_002d-C_002b_002b-Source-Code">E.2.23 Smart Key - C++ Source
Code</a></li>
- <li><a id="toc-Smart-Key-_002d-Assembly-Source-Code-1"
href="#Smart-Key-_002d-Assembly-Source-Code">E.2.24 Smart Key - Assembly Source
Code</a></li>
- <li><a id="toc-Smart-Key-_002d-Lisp-Source-Code-1"
href="#Smart-Key-_002d-Lisp-Source-Code">E.2.25 Smart Key - Lisp Source
Code</a></li>
- <li><a id="toc-Smart-Key-_002d-Java-Source-Code-1"
href="#Smart-Key-_002d-Java-Source-Code">E.2.26 Smart Key - Java Source
Code</a></li>
- <li><a id="toc-Smart-Key-_002d-JavaScript-Source-Code-1"
href="#Smart-Key-_002d-JavaScript-Source-Code">E.2.27 Smart Key - JavaScript
Source Code</a></li>
- <li><a id="toc-Smart-Key-_002d-Objective_002dC-Source-Code-1"
href="#Smart-Key-_002d-Objective_002dC-Source-Code">E.2.28 Smart Key -
Objective-C Source Code</a></li>
- <li><a id="toc-Smart-Key-_002d-Fortran-Source-Code-1"
href="#Smart-Key-_002d-Fortran-Source-Code">E.2.29 Smart Key - Fortran Source
Code</a></li>
- <li><a id="toc-Smart-Key-_002d-Occurrence-Matches-1"
href="#Smart-Key-_002d-Occurrence-Matches">E.2.30 Smart Key - Occurrence
Matches</a></li>
- <li><a id="toc-Smart-Key-_002d-Calendar-Mode-1"
href="#Smart-Key-_002d-Calendar-Mode">E.2.31 Smart Key - Calendar Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Man-Page-Apropos-1"
href="#Smart-Key-_002d-Man-Page-Apropos">E.2.32 Smart Key - Man Page
Apropos</a></li>
- <li><a id="toc-Smart-Key-_002d-Emacs-Outline-Mode-1"
href="#Smart-Key-_002d-Emacs-Outline-Mode">E.2.33 Smart Key - Emacs Outline
Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Info-Manuals-1"
href="#Smart-Key-_002d-Info-Manuals">E.2.34 Smart Key - Info Manuals</a></li>
- <li><a id="toc-Smart-Key-_002d-Email-Readers-1"
href="#Smart-Key-_002d-Email-Readers">E.2.35 Smart Key - Email Readers</a></li>
- <li><a id="toc-Smart-Key-_002d-GNUS-Newsreader-1"
href="#Smart-Key-_002d-GNUS-Newsreader">E.2.36 Smart Key - GNUS
Newsreader</a></li>
- <li><a id="toc-Smart-Key-_002d-Buffer-Menus-1"
href="#Smart-Key-_002d-Buffer-Menus">E.2.37 Smart Key - Buffer Menus</a></li>
- <li><a id="toc-Smart-Key-_002d-Tar-File-Mode-1"
href="#Smart-Key-_002d-Tar-File-Mode">E.2.38 Smart Key - Tar File Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Man-Pages-1"
href="#Smart-Key-_002d-Man-Pages">E.2.39 Smart Key - Man Pages</a></li>
- <li><a id="toc-Smart-Key-_002d-WWW-URLs-1"
href="#Smart-Key-_002d-WWW-URLs">E.2.40 Smart Key - WWW URLs</a></li>
- <li><a id="toc-Smart-Key-_002d-HyRolo-Match-Buffers-1"
href="#Smart-Key-_002d-HyRolo-Match-Buffers">E.2.41 Smart Key - HyRolo Match
Buffers</a></li>
- <li><a id="toc-Smart-Key-_002d-Image-Thumbnails-1"
href="#Smart-Key-_002d-Image-Thumbnails">E.2.42 Smart Key - Image
Thumbnails</a></li>
- <li><a id="toc-Smart-Key-_002d-Gomoku-Game-1"
href="#Smart-Key-_002d-Gomoku-Game">E.2.43 Smart Key - Gomoku Game</a></li>
- <li><a id="toc-Smart-Key-_002d-Magit-Mode-1"
href="#Smart-Key-_002d-Magit-Mode">E.2.44 Smart Key - Magit Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-The-OO_002dBrowser-1"
href="#Smart-Key-_002d-The-OO_002dBrowser">E.2.45 Smart Key - The
OO-Browser</a></li>
- <li><a id="toc-Smart-Key-_002d-Todotext-Mode"
href="#Smart-Key-_002d-Todotxt-Mode">E.2.46 Smart Key - Todotext Mode</a></li>
- <li><a id="toc-Smart-Key-_002d-Default-Context-1"
href="#Smart-Key-_002d-Default-Context">E.2.47 Smart Key - Default
Context</a></li>
+ <li><a id="toc-Smart-Key-_002d-Org-Mode-1"
href="#Smart-Key-_002d-Org-Mode">E.2.2 Smart Key - Org Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Ivy-1" href="#Smart-Key-_002d-Ivy">E.2.3
Smart Key - Ivy</a></li>
+ <li><a id="toc-Smart-Key-_002d-Treemacs-1"
href="#Smart-Key-_002d-Treemacs">E.2.4 Smart Key - Treemacs</a></li>
+ <li><a id="toc-Smart-Key-_002d-Dired-Sidebar-Mode-1"
href="#Smart-Key-_002d-Dired-Sidebar-Mode">E.2.5 Smart Key - Dired Sidebar
Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Emacs-Pushbuttons-1"
href="#Smart-Key-_002d-Emacs-Pushbuttons">E.2.6 Smart Key - Emacs
Pushbuttons</a></li>
+ <li><a id="toc-Smart-Key-_002d-Argument-Completion-1"
href="#Smart-Key-_002d-Argument-Completion">E.2.7 Smart Key - Argument
Completion</a></li>
+ <li><a id="toc-Smart-Key-_002d-ID-Edit-Mode-1"
href="#Smart-Key-_002d-ID-Edit-Mode">E.2.8 Smart Key - ID Edit Mode</a></li>
+ <li><a
id="toc-Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029-1"
href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029">E.2.9 Smart
Key - Emacs Cross-references (Xrefs)</a></li>
+ <li><a id="toc-Smart-Key-_002d-Smart-Scrolling-1"
href="#Smart-Key-_002d-Smart-Scrolling">E.2.10 Smart Key - Smart
Scrolling</a></li>
+ <li><a id="toc-Smart-Key-_002d-Smart-Menus-1"
href="#Smart-Key-_002d-Smart-Menus">E.2.11 Smart Key - Smart Menus</a></li>
+ <li><a id="toc-Smart-Key-_002d-Dired-Mode-1"
href="#Smart-Key-_002d-Dired-Mode">E.2.12 Smart Key - Dired Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Hyperbole-Buttons-1"
href="#Smart-Key-_002d-Hyperbole-Buttons">E.2.13 Smart Key - Hyperbole
Buttons</a></li>
+ <li><a id="toc-Smart-Key-_002d-View-Mode-1"
href="#Smart-Key-_002d-View-Mode">E.2.14 Smart Key - View Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Helm-Mode-1"
href="#Smart-Key-_002d-Helm-Mode">E.2.15 Smart Key - Helm Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Delimited-Things-1"
href="#Smart-Key-_002d-Delimited-Things">E.2.16 Smart Key - Delimited
Things</a></li>
+ <li><a id="toc-Smart-Key-_002d-The-Koutliner-1"
href="#Smart-Key-_002d-The-Koutliner">E.2.17 Smart Key - The Koutliner</a></li>
+ <li><a id="toc-Smart-Key-_002d-RDB-Mode-1"
href="#Smart-Key-_002d-RDB-Mode">E.2.18 Smart Key - RDB Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Help-Buffers-1"
href="#Smart-Key-_002d-Help-Buffers">E.2.19 Smart Key - Help Buffers</a></li>
+ <li><a id="toc-Smart-Key-_002d-Custom-Mode-1"
href="#Smart-Key-_002d-Custom-Mode">E.2.20 Smart Key - Custom Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Bookmark-Mode-1"
href="#Smart-Key-_002d-Bookmark-Mode">E.2.21 Smart Key - Bookmark Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Pages-Directory-Mode-1"
href="#Smart-Key-_002d-Pages-Directory-Mode">E.2.22 Smart Key - Pages Directory
Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Python-Source-Code-1"
href="#Smart-Key-_002d-Python-Source-Code">E.2.23 Smart Key - Python Source
Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-Identifier-Menu-Mode-1"
href="#Smart-Key-_002d-Identifier-Menu-Mode">E.2.24 Smart Key - Identifier Menu
Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-C-Source-Code-1"
href="#Smart-Key-_002d-C-Source-Code">E.2.25 Smart Key - C Source Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-C_002b_002b-Source-Code-1"
href="#Smart-Key-_002d-C_002b_002b-Source-Code">E.2.26 Smart Key - C++ Source
Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-Assembly-Source-Code-1"
href="#Smart-Key-_002d-Assembly-Source-Code">E.2.27 Smart Key - Assembly Source
Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-Lisp-Source-Code-1"
href="#Smart-Key-_002d-Lisp-Source-Code">E.2.28 Smart Key - Lisp Source
Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-Java-Source-Code-1"
href="#Smart-Key-_002d-Java-Source-Code">E.2.29 Smart Key - Java Source
Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-JavaScript-Source-Code-1"
href="#Smart-Key-_002d-JavaScript-Source-Code">E.2.30 Smart Key - JavaScript
Source Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-Objective_002dC-Source-Code-1"
href="#Smart-Key-_002d-Objective_002dC-Source-Code">E.2.31 Smart Key -
Objective-C Source Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-Fortran-Source-Code-1"
href="#Smart-Key-_002d-Fortran-Source-Code">E.2.32 Smart Key - Fortran Source
Code</a></li>
+ <li><a id="toc-Smart-Key-_002d-Occurrence-Matches-1"
href="#Smart-Key-_002d-Occurrence-Matches">E.2.33 Smart Key - Occurrence
Matches</a></li>
+ <li><a id="toc-Smart-Key-_002d-Calendar-Mode-1"
href="#Smart-Key-_002d-Calendar-Mode">E.2.34 Smart Key - Calendar Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Man-Page-Apropos-1"
href="#Smart-Key-_002d-Man-Page-Apropos">E.2.35 Smart Key - Man Page
Apropos</a></li>
+ <li><a id="toc-Smart-Key-_002d-Emacs-Outline-Mode-1"
href="#Smart-Key-_002d-Emacs-Outline-Mode">E.2.36 Smart Key - Emacs Outline
Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Info-Manuals-1"
href="#Smart-Key-_002d-Info-Manuals">E.2.37 Smart Key - Info Manuals</a></li>
+ <li><a id="toc-Smart-Key-_002d-Email-Readers-1"
href="#Smart-Key-_002d-Email-Readers">E.2.38 Smart Key - Email Readers</a></li>
+ <li><a id="toc-Smart-Key-_002d-GNUS-Newsreader-1"
href="#Smart-Key-_002d-GNUS-Newsreader">E.2.39 Smart Key - GNUS
Newsreader</a></li>
+ <li><a id="toc-Smart-Key-_002d-Buffer-Menus-1"
href="#Smart-Key-_002d-Buffer-Menus">E.2.40 Smart Key - Buffer Menus</a></li>
+ <li><a id="toc-Smart-Key-_002d-Tar-File-Mode-1"
href="#Smart-Key-_002d-Tar-File-Mode">E.2.41 Smart Key - Tar File Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Man-Pages-1"
href="#Smart-Key-_002d-Man-Pages">E.2.42 Smart Key - Man Pages</a></li>
+ <li><a id="toc-Smart-Key-_002d-WWW-URLs-1"
href="#Smart-Key-_002d-WWW-URLs">E.2.43 Smart Key - WWW URLs</a></li>
+ <li><a id="toc-Smart-Key-_002d-HyRolo-Match-Buffers-1"
href="#Smart-Key-_002d-HyRolo-Match-Buffers">E.2.44 Smart Key - HyRolo Match
Buffers</a></li>
+ <li><a id="toc-Smart-Key-_002d-Image-Thumbnails-1"
href="#Smart-Key-_002d-Image-Thumbnails">E.2.45 Smart Key - Image
Thumbnails</a></li>
+ <li><a id="toc-Smart-Key-_002d-Gomoku-Game-1"
href="#Smart-Key-_002d-Gomoku-Game">E.2.46 Smart Key - Gomoku Game</a></li>
+ <li><a id="toc-Smart-Key-_002d-Magit-Mode-1"
href="#Smart-Key-_002d-Magit-Mode">E.2.47 Smart Key - Magit Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-The-OO_002dBrowser-1"
href="#Smart-Key-_002d-The-OO_002dBrowser">E.2.48 Smart Key - The
OO-Browser</a></li>
+ <li><a id="toc-Smart-Key-_002d-Todotext-Mode"
href="#Smart-Key-_002d-Todotxt-Mode">E.2.49 Smart Key - Todotext Mode</a></li>
+ <li><a id="toc-Smart-Key-_002d-Default-Context-1"
href="#Smart-Key-_002d-Default-Context">E.2.50 Smart Key - Default
Context</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Suggestion-or-Bug-Reporting-1"
href="#Suggestion-or-Bug-Reporting">Appendix F Suggestion or Bug
Reporting</a></li>
@@ -345,7 +356,7 @@ Next: <a href="#Introduction" accesskey="n"
rel="next">Introduction</a>, Previou
<CENTER><H3><A HREF="mailto:rsw@gnu.org">Say thanks or send a testimonial if
you like Hyperbole.</A></H3></CENTER>
-<P>Copyright © 1989-2021 Free Software Foundation, Inc.</P>
+<P>Copyright © 1989-2022 Free Software Foundation, Inc.</P>
<P>GNU Hyperbole is available for use, modification, and distribution under
the terms of the GNU General Public License (GPL) Version 3 or later,
@@ -358,7 +369,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
Edition 8.0.0pre
-Printed December 26, 2021.
+Printed January 17, 2022.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -411,21 +422,23 @@ years. The Koutliner is dedicated to my lovely wife,
Kathy.
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Introduction"
accesskey="1">Introduction</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Smart-Keys"
accesskey="2">Smart Keys</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#Usage"
accesskey="2">Usage</a></td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Smart-Keys"
accesskey="3">Smart Keys</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Buttons"
accesskey="3">Buttons</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#Buttons"
accesskey="4">Buttons</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Menus"
accesskey="4">Menus</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Menus"
accesskey="5">Menus</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#HyControl"
accesskey="5">HyControl</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#HyControl"
accesskey="6">HyControl</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Koutliner"
accesskey="6">Koutliner</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#Koutliner"
accesskey="7">Koutliner</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#HyRolo"
accesskey="7">HyRolo</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#HyRolo"
accesskey="8">HyRolo</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Window-Configurations"
accesskey="8">Window Configurations</a></td><td> </td><td
align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Window-Configurations"
accesskey="9">Window Configurations</a></td><td> </td><td
align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Developing-with-Hyperbole"
accesskey="9">Developing with Hyperbole</a></td><td> </td><td
align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Developing-with-Hyperbole">Developing with
Hyperbole</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Glossary">Glossary</a></td><td> </td><td align="left"
valign="top">
</td></tr>
@@ -467,6 +480,16 @@ Introduction
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+Usage
+
+</pre></th></tr><tr><td align="left" valign="top">• <a
href="#Invocation">Invocation</a></td><td> </td><td align="left"
valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Documentation">Documentation</a></td><td> </td><td
align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Hyperbole-Hooks">Hyperbole
Hooks</a></td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
+
Smart Keys
</pre></th></tr><tr><td align="left" valign="top">• <a
href="#Smart-Key-Bindings">Smart Key Bindings</a></td><td> </td><td
align="left" valign="top">
@@ -675,17 +698,17 @@ Setup
</pre></th></tr><tr><td align="left" valign="top">• <a
href="#Installation">Installation</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Invocation">Invocation</a></td><td> </td><td align="left"
valign="top">
-</td></tr>
<tr><td align="left" valign="top">• <a
href="#Customization">Customization</a></td><td> </td><td
align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Installation
-</pre></th></tr><tr><td align="left" valign="top">• <a
href="#Stable-Package-Installation">Stable Package
Installation</a></td><td> </td><td align="left" valign="top">
+</pre></th></tr><tr><td align="left" valign="top">• <a
href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Elpa-In_002dDevelopment-Package-Installation">Elpa In-Development
Package Installation</a></td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Git-In_002dDevelopment-Package-Installation">Git In-Development Package
Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Manual-Tarball-Archive-Installation">Manual Tarball Archive
Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
@@ -717,6 +740,8 @@ Hyperbole Key Bindings
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Default-Hyperbole-Bindings">Default Hyperbole
Bindings</a></td><td> </td><td align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Testing">Testing</a></td><td> </td><td align="left"
valign="top">
+</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
Smart Key Reference
@@ -749,6 +774,10 @@ Smart Keyboard Keys
</pre></th></tr><tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Company-Mode">Smart Key - Company
Mode</a></td><td> </td><td align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Org-Mode">Smart Key - Org
Mode</a></td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Smart-Key-_002d-Ivy">Smart
Key - Ivy</a></td><td> </td><td align="left" valign="top">
+</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Treemacs">Smart Key -
Treemacs</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Dired-Sidebar-Mode">Smart Key - Dired Sidebar
Mode</a></td><td> </td><td align="left" valign="top">
@@ -781,6 +810,8 @@ Smart Keyboard Keys
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Help-Buffers">Smart Key - Help
Buffers</a></td><td> </td><td align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Custom-Mode">Smart Key - Custom
Mode</a></td><td> </td><td align="left" valign="top">
+</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Bookmark-Mode">Smart Key - Bookmark
Mode</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Pages-Directory-Mode">Smart Key - Pages Directory
Mode</a></td><td> </td><td align="left" valign="top">
@@ -848,7 +879,7 @@ Smart Keyboard Keys
<hr>
<span id="Introduction"></span><div class="header">
<p>
-Next: <a href="#Smart-Keys" accesskey="n" rel="next">Smart Keys</a>, Previous:
<a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top"
accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+Next: <a href="#Usage" accesskey="n" rel="next">Usage</a>, Previous: <a
href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u"
rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
<span id="Introduction-1"></span><h2 class="chapter">1 Introduction</h2>
@@ -1071,12 +1102,11 @@ of Hyperbole is a single global minor mode that you can
activate and
deactivate at will. And it can be uninstalled quickly as well if need be, so
there is no risk to giving it a spin.
</p>
-<p>Once you have it installed and activated (use <kbd>{C-u M-x
-hyperbole-mode <span class="key">RET</span>}</kbd>), try the interactive demo
with <kbd>{C-h h d d}</kbd>.
+<p>Once you have it installed, try the interactive demo with <kbd>{C-h h d
d}</kbd>.
In fact, if you have Hyperbole loaded, you can press <kbd>{M-<span
class="key">RET</span>}</kbd>
-inside any of the brace delimited series of keys you see in this document and
-Hyperbole will execute them on-the-fly (easy keyboard-macro style buttons in
-any text).
+inside any of the brace delimited series of keys you see in this document
+and Hyperbole will execute them on-the-fly (easy keyboard-macro style
+buttons in any text).
</p>
<p>Hyperbole can dramatically increase your productivity and greatly reduce
the number of keyboard/mouse keys you’ll need to work efficiently.
@@ -1255,27 +1285,45 @@ Hyperbole, <bug-hyperbole@gnu.org>. For more
details,
see <a href="#Suggestion-or-Bug-Reporting">Suggestion or Bug Reporting</a>.
</p>
<hr>
-<span id="Smart-Keys"></span><div class="header">
+<span id="Usage"></span><div class="header">
<p>
-Next: <a href="#Buttons" accesskey="n" rel="next">Buttons</a>, Previous: <a
href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a
href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Smart-Keys" accesskey="n" rel="next">Smart Keys</a>, Previous:
<a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a
href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Keys-1"></span><h2 class="chapter">2 Smart Keys</h2>
+<span id="Usage-1"></span><h2 class="chapter">2 Usage</h2>
-<span id="index-Smart-Key"></span>
-<span id="index-mouse-support"></span>
-<span id="index-Action-Key"></span>
-<span id="index-Assist-Key"></span>
-<span id="index-middle-mouse-key"></span>
-<span id="index-hmouse_002dmiddle_002dflag"></span>
-<span id="index-Action-Key-1"></span>
-<span id="index-Assist-Key-1"></span>
-<p>When active, Hyperbole offers two special <em>Smart Keys</em>, the Action
Key
-and the Assist Key, that perform an extensive array of context-sensitive
-operations across emacs usage. In many 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. This chapter explains typical uses of the Smart Keys. See <a
href="#Smart-Key-Reference">Smart Key Reference</a>, for complete descriptions
of their behavior in all contexts.
+<p>Once Hyperbole has been installed for use at your site, loaded into your
+Emacs session and activated with <code>(hyperbole-mode 1)</code>, it is ready
+for use. You will see a Hyperbole menu on your menubar and <code>Hypb</code>
in
+your modeline.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#Invocation"
accesskey="1">Invocation</a></td><td> </td><td align="left"
valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Documentation"
accesskey="2">Documentation</a></td><td> </td><td align="left"
valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Hyperbole-Hooks"
accesskey="3">Hyperbole Hooks</a></td><td> </td><td align="left"
valign="top">
+</td></tr>
+</table>
+
+<hr>
+<span id="Invocation"></span><div class="header">
+<p>
+Next: <a href="#Documentation" accesskey="n" rel="next">Documentation</a>,
Previous: <a href="#Usage" accesskey="p" rel="prev">Usage</a>, Up: <a
href="#Usage" accesskey="u" rel="up">Usage</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Invocation-1"></span><h3 class="section">2.1 Invocation</h3>
+
+<p>You can invoke Hyperbole’s commands in one of three ways:
</p>
+<ul>
+<li> use the Hyperbole entry on your menubar;
+
+</li><li> <span id="index-hyperbole"></span>
+type <kbd>{C-h h}</kbd> or <kbd>{M-x hyperbole <span
class="key">RET</span>}</kbd> to display the Hyperbole minibuffer menu;
+
+</li><li> use a specific Hyperbole command, for example, a press of
<kbd>{M-<span class="key">RET</span>}</kbd>
+on a pathname to display the associated file or directory.
+</li></ul>
+
<span id="index-file_002c-_002eemacs"></span>
<span id="index-hyperbole_002dmode"></span>
<span id="index-minor-mode_002c-hyperbole"></span>
@@ -1286,11 +1334,82 @@ happens. This chapter explains typical uses of the
Smart Keys. See <a href="#S
<span id="index-C_002dh-h"></span>
<span id="index-X"></span>
<span id="index-q"></span>
-<p>Use <kbd>{C-h h}</kbd> to activate Hyperbole (enable
<code>hyperbole-mode</code> and
-display its keyboard-driven minibuffer menu). Use <kbd>{q}</kbd> to quit from
the
-minibuffer menu while leaving Hyperbole enabled and thus the Smart Keys
-active. Use<kbd>{X}</kbd> to quit from the minibuffer menu and disable
Hyperbole
-keys.
+<p><kbd>{C-h h}</kbd> enables Hyperbole if it has been disabled and displays a
+Hyperbole menu in the minibuffer for quick keyboard or mouse-based selection.
+Select an item from this menu by typing the item’s first capital letter.
+Use <kbd>{q}</kbd> to quit from the minibuffer menu while leaving Hyperbole
enabled.
+Use<kbd>{X}</kbd> to quit from the minibuffer menu and disable Hyperbole minor
mode.
+</p>
+<p>Use <kbd>{C-h h d d}</kbd> for an interactive demonstration of standard
Hyperbole
+button capabilities.
+</p>
+<p>Type <kbd>{C-h h k e}</kbd> for an interactive demonstration of the
Koutliner,
+Hyperbole’s multi-level autonumbered hypertextual outliner.
+</p>
+<p>To try out HyControl, Hyperbole’s interactive frame and window control
+system, use <kbd>{C-h h s w}</kbd> for window control or <kbd>{C-h h s
f}</kbd> for
+frame control. Pressing <kbd>{t}</kbd> switches between window and frame
+control once in HyControl. Hyperbole also binds <kbd>{C-c \}</kbd> for quick
+access to HyControl’s window control menu if it was not already bound
+prior to Hyperbole’s initialization.
+</p>
+<p>A long video demonstrating most of HyControl’s features is available
at
+<a href="https://youtu.be/M3-aMh1ccJk">https://youtu.be/M3-aMh1ccJk</a>.
+</p>
+<p>The above are the best interactive ways to learn about Hyperbole.
+</p>
+<hr>
+<span id="Documentation"></span><div class="header">
+<p>
+Next: <a href="#Hyperbole-Hooks" accesskey="n" rel="next">Hyperbole Hooks</a>,
Previous: <a href="#Invocation" accesskey="p" rel="prev">Invocation</a>, Up: <a
href="#Usage" accesskey="u" rel="up">Usage</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Documentation-1"></span><h3 class="section">2.2 Documentation</h3>
+
+<span id="index-Info_002ddirectory_002dlist"></span>
+<span id="index-hyperb_003adir"></span>
+<span id="index-Hyperbole-manual"></span>
+<p>The Hyperbole Manual is a reference manual, not a simple introduction.
+It is included in the <samp>man/</samp> subdirectory of the Hyperbole package
+directory in four forms:
+</p>
+<span id="index-Info-manual"></span>
+<span id="index-Texinfo-manual"></span>
+<span id="index-file_002c-man_002fhyperbole_002einfo"></span>
+<span id="index-file_002c-man_002fhyperbole_002ehtml"></span>
+<span id="index-file_002c-man_002fhyperbole_002epdf"></span>
+<span id="index-file_002c-man_002fhyperbole_002etexi"></span>
+<div class="example">
+<pre class="example"><samp>man/hyperbole.info</samp> - online Info browser
version
+<samp>man/hyperbole.html</samp> - web HTML version
+<samp>man/hyperbole.pdf</samp> - printable version
+<samp>man/hyperbole.texi</samp> - source form
+</pre></div>
+
+<span id="index-C_002dh-h-d-i"></span>
+<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. <kbd>{C-h h d i}</kbd> will let you
+browse the manual. Then use <kbd>{s}</kbd> to search for anything
+throughout the manual. For web browsing, point your browser
+to <samp><code>${hyperb:dir}</code>/man/hyperbole.html</samp>, wherever the
+Hyperbole package directory is on your system; often this
+is: <samp>~/.emacs.d/elpa/hyperbole-${hyperb:version}/</samp>.
+</p>
+
+<hr>
+<span id="Hyperbole-Hooks"></span><div class="header">
+<p>
+Previous: <a href="#Documentation" accesskey="p" rel="prev">Documentation</a>,
Up: <a href="#Usage" accesskey="u" rel="up">Usage</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Hyperbole-Hooks-1"></span><h3 class="section">2.3 Hyperbole
Hooks</h3>
+<span id="index-hyperbole_002dinit_002dhook"></span>
+<span id="index-hyperbole_002dmode_002dhook"></span>
+<span id="index-hyperbole_002dmode_002don_002dhook"></span>
+<span id="index-hyperbole_002dmode_002doff_002dhook"></span>
+<p>When Hyperbole’s code is first loaded and initialized,
<code>hyperbole-init-hook</code>
+is run. When <code>hyperbole-mode</code> is enabled,
<code>hyperbole-mode-hook</code> and
+<code>hyperbole-mode-on-hook</code> are run. When <code>hyperbole-mode</code>
is disabled,
+<code>hyperbole-mode-hook</code> and hyperbole-mode-off-hook are run.
</p>
<p>If you prefer a different key to activate Hyperbole, you can bind it as part
of any setting of <code>hyperbole-init-hook</code> within your personal
@@ -1299,6 +1418,28 @@ of any setting of <code>hyperbole-init-hook</code>
within your personal
'hyperbole--enable-mode) (global-set-key "\C-hh"
'view-hello-file)))</code>; then
restart Emacs.
</p>
+<hr>
+<span id="Smart-Keys"></span><div class="header">
+<p>
+Next: <a href="#Buttons" accesskey="n" rel="next">Buttons</a>, Previous: <a
href="#Usage" accesskey="p" rel="prev">Usage</a>, Up: <a href="#Top"
accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+</div>
+<span id="Smart-Keys-1"></span><h2 class="chapter">3 Smart Keys</h2>
+
+<span id="index-Smart-Key"></span>
+<span id="index-mouse-support"></span>
+<span id="index-Action-Key"></span>
+<span id="index-Assist-Key"></span>
+<span id="index-middle-mouse-key"></span>
+<span id="index-hmouse_002dmiddle_002dflag"></span>
+<span id="index-Action-Key-1"></span>
+<span id="index-Assist-Key-1"></span>
+<p>When active, Hyperbole offers two special <em>Smart Keys</em>, the Action
Key
+and the Assist Key, that perform an extensive array of context-sensitive
+operations across emacs usage. In many 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. This chapter explains typical uses of the Smart Keys. See <a
href="#Smart-Key-Reference">Smart Key Reference</a>, for complete descriptions
of their behavior in all contexts.
+</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Smart-Key-Bindings"
accesskey="1">Smart Key Bindings</a></td><td> </td><td align="left"
valign="top">
</td></tr>
@@ -1321,7 +1462,7 @@ restart Emacs.
<p>
Next: <a href="#Smart-Key-Operations" accesskey="n" rel="next">Smart Key
Operations</a>, Previous: <a href="#Smart-Keys" accesskey="p" rel="prev">Smart
Keys</a>, Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-Bindings-1"></span><h3 class="section">2.1 Smart Key
Bindings</h3>
+<span id="Smart-Key-Bindings-1"></span><h3 class="section">3.1 Smart Key
Bindings</h3>
<span id="index-C_002du-M_002dRET"></span>
<span id="index-M_002dRET"></span>
@@ -1384,7 +1525,7 @@ for example, <code>(hkey-set-key "\M-'"
'hkey-either)</code>.
<p>
Next: <a href="#Smart-Key-Argument-Selection" accesskey="n" rel="next">Smart
Key Argument Selection</a>, Previous: <a href="#Smart-Key-Bindings"
accesskey="p" rel="prev">Smart Key Bindings</a>, Up: <a href="#Smart-Keys"
accesskey="u" rel="up">Smart Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-Operations-1"></span><h3 class="section">2.2 Smart Key
Operations</h3>
+<span id="Smart-Key-Operations-1"></span><h3 class="section">3.2 Smart Key
Operations</h3>
<span id="index-button-activation"></span>
<span id="index-activation"></span>
@@ -1591,7 +1732,7 @@ the <tt class="key">A</tt> character.
<p>
Next: <a href="#Smart-Key-Debugging" accesskey="n" rel="next">Smart Key
Debugging</a>, Previous: <a href="#Smart-Key-Operations" accesskey="p"
rel="prev">Smart Key Operations</a>, Up: <a href="#Smart-Keys" accesskey="u"
rel="up">Smart Keys</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-Argument-Selection-1"></span><h3 class="section">2.3 Smart
Key Argument Selection</h3>
+<span id="Smart-Key-Argument-Selection-1"></span><h3 class="section">3.3 Smart
Key Argument Selection</h3>
<span id="index-Hyperbole-help"></span>
<p>A prime design criterion of Hyperbole’s user interface is that you
@@ -1634,7 +1775,7 @@ any item to enter it as the argument.
<p>
Next: <a href="#Smart-Key-Thing-Selection" accesskey="n" rel="next">Smart Key
Thing Selection</a>, Previous: <a href="#Smart-Key-Argument-Selection"
accesskey="p" rel="prev">Smart Key Argument Selection</a>, Up: <a
href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-Debugging-1"></span><h3 class="section">2.4 Smart Key
Debugging</h3>
+<span id="Smart-Key-Debugging-1"></span><h3 class="section">3.4 Smart Key
Debugging</h3>
<p>Typically, <kbd>{C-h A}</kbd> and <kbd>{C-u C-h A}</kbd> which show Action
and
Assist Key help for the current context, are sufficient for seeing how
@@ -1672,7 +1813,7 @@ with <kbd>{C-h h m c}</kbd>, these messages are also
included.
<p>
Next: <a href="#Smart-Mouse-Key-Modeline-Clicks" accesskey="n"
rel="next">Smart Mouse Key Modeline Clicks</a>, Previous: <a
href="#Smart-Key-Debugging" accesskey="p" rel="prev">Smart Key Debugging</a>,
Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-Thing-Selection-1"></span><h3 class="section">2.5 Smart
Key Thing Selection</h3>
+<span id="Smart-Key-Thing-Selection-1"></span><h3 class="section">3.5 Smart
Key Thing Selection</h3>
<span id="index-sexp-selection"></span>
<span id="index-code-block-selection"></span>
@@ -1759,7 +1900,7 @@ closing tags.
<p>
Next: <a href="#Smart-Mouse-Key-Drags" accesskey="n" rel="next">Smart Mouse
Key Drags</a>, Previous: <a href="#Smart-Key-Thing-Selection" accesskey="p"
rel="prev">Smart Key Thing Selection</a>, Up: <a href="#Smart-Keys"
accesskey="u" rel="up">Smart Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Mouse-Key-Modeline-Clicks-1"></span><h3 class="section">2.6
Smart Mouse Key Modeline Clicks</h3>
+<span id="Smart-Mouse-Key-Modeline-Clicks-1"></span><h3 class="section">3.6
Smart Mouse Key Modeline Clicks</h3>
<p>Smart Mouse Key clicks on a window’s modeline offer many powerful
browsing
features, including directory editing (dired), user manual browsing, and
@@ -1898,7 +2039,7 @@ Change the value to your desired command. Then press <tt
class="key">RET</tt>.
<p>
Previous: <a href="#Smart-Mouse-Key-Modeline-Clicks" accesskey="p"
rel="prev">Smart Mouse Key Modeline Clicks</a>, Up: <a href="#Smart-Keys"
accesskey="u" rel="up">Smart Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Mouse-Key-Drags-1"></span><h3 class="section">2.7 Smart Mouse
Key Drags</h3>
+<span id="Smart-Mouse-Key-Drags-1"></span><h3 class="section">3.7 Smart Mouse
Key Drags</h3>
<span id="index-smart-mouse-key-drag"></span>
<span id="index-Action-Mouse-Key-drag"></span>
@@ -1926,7 +2067,7 @@ contexts and actions; for complete documentation, see <a
href="#Smart-Mouse-Keys
<p>
Next: <a href="#Saving-and-Restoring-Window-Configurations" accesskey="n"
rel="next">Saving and Restoring Window Configurations</a>, Previous: <a
href="#Smart-Mouse-Key-Drags" accesskey="p" rel="prev">Smart Mouse Key
Drags</a>, Up: <a href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart
Mouse Key Drags</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Creating-and-Deleting-Windows-1"></span><h4 class="subsection">2.7.1
Creating and Deleting Windows</h4>
+<span id="Creating-and-Deleting-Windows-1"></span><h4 class="subsection">3.7.1
Creating and Deleting Windows</h4>
<span id="index-drag_002c-horizontal"></span>
<span id="index-horizontal-drag"></span>
@@ -1954,7 +2095,7 @@ re-balance the sizes of the remaining windows, so they
are fairly even.
<p>
Next: <a href="#Resizing-Windows" accesskey="n" rel="next">Resizing
Windows</a>, Previous: <a href="#Creating-and-Deleting-Windows" accesskey="p"
rel="prev">Creating and Deleting Windows</a>, Up: <a
href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart Mouse Key Drags</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Saving-and-Restoring-Window-Configurations-1"></span><h4
class="subsection">2.7.2 Saving and Restoring Window Configurations</h4>
+<span id="Saving-and-Restoring-Window-Configurations-1"></span><h4
class="subsection">3.7.2 Saving and Restoring Window Configurations</h4>
<span id="index-window-configuration-drag"></span>
<span id="index-drag_002c-window-configuration"></span>
@@ -1979,7 +2120,7 @@ restored, the newest element will again be restored and
so on.
<p>
Next: <a href="#Moving-Frames" accesskey="n" rel="next">Moving Frames</a>,
Previous: <a href="#Saving-and-Restoring-Window-Configurations" accesskey="p"
rel="prev">Saving and Restoring Window Configurations</a>, Up: <a
href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart Mouse Key Drags</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Resizing-Windows-1"></span><h4 class="subsection">2.7.3 Resizing
Windows</h4>
+<span id="Resizing-Windows-1"></span><h4 class="subsection">3.7.3 Resizing
Windows</h4>
<span id="index-resizing-windows"></span>
<span id="index-drag_002c-resize-window"></span>
@@ -1996,7 +2137,7 @@ modeline show visible feedback as the window is resized.
<p>
Next: <a href="#Dragging-Buffers" accesskey="n" rel="next">Dragging
Buffers</a>, Previous: <a href="#Resizing-Windows" accesskey="p"
rel="prev">Resizing Windows</a>, Up: <a href="#Smart-Mouse-Key-Drags"
accesskey="u" rel="up">Smart Mouse Key Drags</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Moving-Frames-1"></span><h4 class="subsection">2.7.4 Moving
Frames</h4>
+<span id="Moving-Frames-1"></span><h4 class="subsection">3.7.4 Moving
Frames</h4>
<span id="index-dragging-frames"></span>
<span id="index-moving-frames"></span>
@@ -2025,7 +2166,7 @@ the desired frame first and then depress to drag.
<p>
Previous: <a href="#Moving-Frames" accesskey="p" rel="prev">Moving Frames</a>,
Up: <a href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart Mouse Key
Drags</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Dragging-Buffers_002c-Windows-and-Items"></span><h4
class="subsection">2.7.5 Dragging Buffers, Windows and Items</h4>
+<span id="Dragging-Buffers_002c-Windows-and-Items"></span><h4
class="subsection">3.7.5 Dragging Buffers, Windows and Items</h4>
<p>Smart Mouse Key drags let you display buffers and windows however you want
them. Dired and buffer-menu items may also be displayed in specific
@@ -2049,7 +2190,7 @@ locations with drags. Below we explore these drag
actions.
<p>
Next: <a href="#Displaying-Buffers" accesskey="n" rel="next">Displaying
Buffers</a>, Previous: <a href="#Dragging-Buffers" accesskey="p"
rel="prev">Dragging Buffers</a>, Up: <a href="#Dragging-Buffers" accesskey="u"
rel="up">Dragging Buffers</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Swapping-Buffers-1"></span><h4 class="subsubsection">2.7.5.1
Swapping Buffers</h4>
+<span id="Swapping-Buffers-1"></span><h4 class="subsubsection">3.7.5.1
Swapping Buffers</h4>
<span id="index-swap-buffers"></span>
<span id="index-window_002c-swap-buffer"></span>
@@ -2071,7 +2212,7 @@ have two single window frames, you can swap buffers
between them with
<p>
Next: <a href="#Cloning-Windows" accesskey="n" rel="next">Cloning Windows</a>,
Previous: <a href="#Swapping-Buffers" accesskey="p" rel="prev">Swapping
Buffers</a>, Up: <a href="#Dragging-Buffers" accesskey="u" rel="up">Dragging
Buffers</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Displaying-Buffers-1"></span><h4 class="subsubsection">2.7.5.2
Displaying Buffers</h4>
+<span id="Displaying-Buffers-1"></span><h4 class="subsubsection">3.7.5.2
Displaying Buffers</h4>
<span id="index-buffer_002c-copy"></span>
<span id="index-copy-buffer"></span>
@@ -2090,7 +2231,7 @@ window will be split before the buffer is displayed.
<p>
Next: <a href="#Displaying-File-and-Buffer-Items" accesskey="n"
rel="next">Displaying File and Buffer Items</a>, Previous: <a
href="#Displaying-Buffers" accesskey="p" rel="prev">Displaying Buffers</a>, Up:
<a href="#Dragging-Buffers" accesskey="u" rel="up">Dragging Buffers</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Cloning-Windows-1"></span><h4 class="subsubsection">2.7.5.3 Cloning
Windows</h4>
+<span id="Cloning-Windows-1"></span><h4 class="subsubsection">3.7.5.3 Cloning
Windows</h4>
<span id="index-clone-window"></span>
<span id="index-window_002c-clone"></span>
@@ -2106,7 +2247,7 @@ unless it is the only window in that frame.
<p>
Next: <a href="#Keyboard-Drags" accesskey="n" rel="next">Keyboard Drags</a>,
Previous: <a href="#Cloning-Windows" accesskey="p" rel="prev">Cloning
Windows</a>, Up: <a href="#Dragging-Buffers" accesskey="u" rel="up">Dragging
Buffers</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Displaying-File-and-Buffer-Items-1"></span><h4
class="subsubsection">2.7.5.4 Displaying File and Buffer Items</h4>
+<span id="Displaying-File-and-Buffer-Items-1"></span><h4
class="subsubsection">3.7.5.4 Displaying File and Buffer Items</h4>
<span id="index-dired-item-drag"></span>
<span id="index-buffer-menu-item-drag"></span>
@@ -2135,7 +2276,7 @@ destination (swapping buffers), just as it does with
other buffers.
<p>
Previous: <a href="#Displaying-File-and-Buffer-Items" accesskey="p"
rel="prev">Displaying File and Buffer Items</a>, Up: <a
href="#Dragging-Buffers" accesskey="u" rel="up">Dragging Buffers</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Keyboard-Drags-1"></span><h4 class="subsubsection">2.7.5.5 Keyboard
Drags</h4>
+<span id="Keyboard-Drags-1"></span><h4 class="subsubsection">3.7.5.5 Keyboard
Drags</h4>
<span id="index-M_002do"></span>
<span id="index-C_002du-M_002do"></span>
@@ -2261,7 +2402,7 @@ determined by the referent context via
<code>hui:link-directly</code>.
<p>
Next: <a href="#Menus" accesskey="n" rel="next">Menus</a>, Previous: <a
href="#Smart-Keys" accesskey="p" rel="prev">Smart Keys</a>, Up: <a href="#Top"
accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Buttons-1"></span><h2 class="chapter">3 Buttons</h2>
+<span id="Buttons-1"></span><h2 class="chapter">4 Buttons</h2>
<span id="index-button"></span>
<p>This chapter explains use of Hyperbole <em>buttons</em>. There are several
@@ -2351,7 +2492,7 @@ it, see <a href="#Smart-Key-Operations">Smart Key
Operations</a>.
<p>
Next: <a href="#Global-Buttons" accesskey="n" rel="next">Global Buttons</a>,
Previous: <a href="#Buttons" accesskey="p" rel="prev">Buttons</a>, Up: <a
href="#Buttons" accesskey="u" rel="up">Buttons</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Explicit-Buttons-1"></span><h3 class="section">3.1 Explicit
Buttons</h3>
+<span id="Explicit-Buttons-1"></span><h3 class="section">4.1 Explicit
Buttons</h3>
<span id="index-explicit-button-1"></span>
<span id="index-button_002c-explicit-1"></span>
@@ -2420,7 +2561,7 @@ asking for help on a button.
<p>
Next: <a href="#Implicit-Buttons" accesskey="n" rel="next">Implicit
Buttons</a>, Previous: <a href="#Explicit-Buttons" accesskey="p"
rel="prev">Explicit Buttons</a>, Up: <a href="#Buttons" accesskey="u"
rel="up">Buttons</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Global-Buttons-1"></span><h3 class="section">3.2 Global Buttons</h3>
+<span id="Global-Buttons-1"></span><h3 class="section">4.2 Global Buttons</h3>
<span id="index-global-button-1"></span>
<span id="index-button_002c-global-1"></span>
@@ -2470,7 +2611,7 @@ Manual</cite>, for details on bookmarks.
<p>
Next: <a href="#Button-Files" accesskey="n" rel="next">Button Files</a>,
Previous: <a href="#Global-Buttons" accesskey="p" rel="prev">Global
Buttons</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Implicit-Buttons-1"></span><h3 class="section">3.3 Implicit
Buttons</h3>
+<span id="Implicit-Buttons-1"></span><h3 class="section">4.3 Implicit
Buttons</h3>
<span id="index-button_002c-implicit-1"></span>
<span id="index-implicit-button-1"></span>
@@ -2543,7 +2684,7 @@ you may simply type the label and delimiters manually.
<p>
Next: <a href="#Action-Buttons" accesskey="n" rel="next">Action Buttons</a>,
Previous: <a href="#Implicit-Buttons" accesskey="p" rel="prev">Implicit
Buttons</a>, Up: <a href="#Implicit-Buttons" accesskey="u" rel="up">Implicit
Buttons</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Implicit-Button-Types-1"></span><h4 class="subsection">3.3.1
Implicit Button Types</h4>
+<span id="Implicit-Button-Types-1"></span><h4 class="subsection">4.3.1
Implicit Button Types</h4>
<span id="index-ibtypes_002c-list-of"></span>
<span id="index-implicit-button-types"></span>
@@ -2556,7 +2697,7 @@ implicit button types (they are listed in increasing
order of priority).
<dl compact="compact">
<dd>
<span id="index-ibtypes-org_002dmode"></span>
-<span id="index-Org_002dmode"></span>
+<span id="index-org_002dmode"></span>
<span id="index-radio-target"></span>
<span id="index-code-block"></span>
<span id="index-links"></span>
@@ -2564,13 +2705,14 @@ implicit button types (they are listed in increasing
order of priority).
<span id="index-M_002dRET-1"></span>
<span id="index-org_002dctrl_002dc_002dctrl_002dc"></span>
<span id="index-org_002dmeta_002dreturn"></span>
-<span id="index-hsys_002dorg_002denable_002dsmart_002dkeys"></span>
-<span id="index-enable-org_002dmode-support"></span>
-<span id="index-disable-org_002dmode-support"></span>
-<span id="index-inhibit-org_002dmode-support"></span>
+<span id="index-hsys_002dorg_002dmode_002dp"></span>
+<span id="index-file_002c-hsys_002dorg_002eel"></span>
</dd>
<dt><code>org-mode</code></dt>
-<dd><p>For users of Emacs Org-mode, Hyperbole does quite a few things.
+<dd><p>Hyperbole recognizes Org mode constructs in any of these modes:
+<code>org-mode</code>, <code>org-agenda-mode</code>, <code>outshine-mode</code>
+or <code>poporg-mode</code>. (See the function <code>hsys-org-mode-p</code>).
+Hyperbole does quite a few things for Org mode users.
</p>
<p>First, the Action Key follows internal links in Org-mode files. When
pressed on a link referent/target, the link definition is displayed,
@@ -2593,9 +2735,17 @@ of <kbd>{C-c C-c}</kbd>, <code>org-ctrl-c-ctrl-c</code>.
<p>In any other context besides the end of a line, the Action Key invokes
the Org-mode standard binding of <kbd>{M-<span class="key">RET</span>}</kbd>,
<code>org-meta-return</code>.
</p>
+<span id="index-hsys_002dorg_002denable_002dsmart_002dkeys"></span>
+<span id="index-enable-org_002dmode-support"></span>
+<span id="index-disable-org_002dmode-support"></span>
+<span id="index-inhibit-org_002dmode-support"></span>
+<span id="index-C_002dh-h-c-o"></span>
<p>To disable Hyperbole support within Org major and minor modes, set
the custom option <code>hsys-org-enable-smart-keys</code> to <code>nil</code>.
Then in
-Org modes, the Action Key will simply invoke <code>org-meta-return</code>. The
+Org modes, the Action Key will simply invoke <code>org-meta-return</code>.
+<kbd>{C-h h c o}</kbd> will customize this setting interactively.
+</p>
+<p>The
following table summarizes the effect of this option setting.
</p></dd>
</dl>
@@ -2820,14 +2970,17 @@ 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-series"></span>
<span id="index-key-sequence"></span>
-<span id="index-sequence-of-keys"></span>
+<span id="index-series-of-keys"></span>
+<span id="index-kbd-function"></span>
</dd>
<dt><code>kbd-key</code></dt>
<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.
+will not be recognized. The string within <code>(kbd
"string")</code> also
+acts as a key series button.
</p>
<p>Any key sequence must be a string of one of the following:
</p><ul>
@@ -3149,9 +3302,12 @@ with the following format:
<samp><path>[#<link-anchor>]:<line-num
</dd>
<dt><code>mail-address</code></dt>
<dd><p>If on an e-mail address in a specific buffer type, compose mail to that
-address in another window. Applies to the rolo match buffer, any buffer
+address in another window. Applies to any major mode descended from those
+in <code>mail-address-mode-list</code>, the rolo match buffer, any buffer
attached to a file in <code>hyrolo-file-list</code>, or any buffer
-with <samp>mail</samp> or <samp>rolo</samp> (case-insensitive) within its name.
+with <samp>mail</samp> or <samp>rolo</samp> (case-insensitive) within its
name. If
+<code>mail-address-mode-list</code> is set to nil, this button type is active
+in all buffers.
</p>
<span id="index-ibtypes-www_002durl"></span>
<span id="index-URL"></span>
@@ -3200,6 +3356,36 @@ delimiters. See the variable documentation for
<code>hpath:suffixes</code> for
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-PATH_002dtype-variable"></span>
+<span id="index-colon_002dseparated-paths"></span>
+<span id="index-semicolon_002dseparated-paths"></span>
+<p>If instead is a PATH-style variable name, .e.g. <code>MANPATH</code>, will
+prompt with completion for one of the paths and will then display that.
+If it is the colon or semicolon-separated string of paths value from a
+PATH-style variable, the path at point is displayed; empty paths,
+e.g. <samp>::</samp> represent the current directory, <samp>.</samp>. Must
have at
+least four paths within the variable value for this to work.
+</p>
+
+<span id="index-ibtypes-hyperbole_002drun_002dtests"></span>
+<span id="index-running-tests"></span>
+<span id="index-testing"></span>
+<span id="index-ert"></span>
+<span id="index-Emacs-Regression-Test-framework"></span>
+</dd>
+<dt><code>hyperbole-run-tests</code></dt>
+<dd><p>Recognize buttons of the form <code><hyperbole-run-tests
test-selector></code>
+which when activated run Hyperbole tests using the ERT framework. The
+<code>test-selector</code> argument is as described in
<code>ert-select-tests</code>.
+</p>
+
+<span id="index-ibtypes-hyperbole_002drun_002dtest"></span>
+</dd>
+<dt><code>hyperbole-run-test</code></dt>
+<dd><p>Recognize buttons of the form <code><hyperbole-run-test
test-name></code>
+which when activated run individual Hyperbole tests, each given
+by the <code><test-name></code> argument, an unquoted name.
</p></dd>
</dl>
@@ -3209,7 +3395,7 @@ for special file display options.
<p>
Previous: <a href="#Implicit-Button-Types" accesskey="p" rel="prev">Implicit
Button Types</a>, Up: <a href="#Implicit-Buttons" accesskey="u"
rel="up">Implicit Buttons</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Action-Buttons-1"></span><h4 class="subsection">3.3.2 Action
Buttons</h4>
+<span id="Action-Buttons-1"></span><h4 class="subsection">4.3.2 Action
Buttons</h4>
<span id="index-action-button"></span>
<span id="index-implicit-action-button"></span>
@@ -3289,7 +3475,7 @@ name with: <kbd>{C-h h g a}</kbd>.
<p>
Next: <a href="#Action-Types" accesskey="n" rel="next">Action Types</a>,
Previous: <a href="#Implicit-Buttons" accesskey="p" rel="prev">Implicit
Buttons</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Button-Files-1"></span><h3 class="section">3.4 Button Files</h3>
+<span id="Button-Files-1"></span><h3 class="section">4.4 Button Files</h3>
<span id="index-button-files"></span>
<p>It is often convenient to create files filled with buttons as a means
@@ -3339,7 +3525,7 @@ such resources.
<p>
Next: <a href="#Button-Type-Precedence" accesskey="n" rel="next">Button Type
Precedence</a>, Previous: <a href="#Button-Files" accesskey="p"
rel="prev">Button Files</a>, Up: <a href="#Buttons" accesskey="u"
rel="up">Buttons</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Action-Types-1"></span><h3 class="section">3.5 Action Types</h3>
+<span id="Action-Types-1"></span><h3 class="section">4.5 Action Types</h3>
<span id="index-action-type"></span>
<span id="index-argument_002c-use"></span>
@@ -3629,7 +3815,7 @@ Lisp can evaluate.
<p>
Next: <a href="#Utilizing-Explicit-Buttons" accesskey="n" rel="next">Utilizing
Explicit Buttons</a>, Previous: <a href="#Action-Types" accesskey="p"
rel="prev">Action Types</a>, Up: <a href="#Buttons" accesskey="u"
rel="up">Buttons</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Button-Type-Precedence-1"></span><h3 class="section">3.6 Button Type
Precedence</h3>
+<span id="Button-Type-Precedence-1"></span><h3 class="section">4.6 Button Type
Precedence</h3>
<span id="index-button-precedence"></span>
<span id="index-precedence_002c-buttons"></span>
@@ -3665,7 +3851,7 @@ information on how to develop or modify types.
<p>
Previous: <a href="#Button-Type-Precedence" accesskey="p" rel="prev">Button
Type Precedence</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Utilizing-Explicit-Buttons-1"></span><h3 class="section">3.7
Utilizing Explicit Buttons</h3>
+<span id="Utilizing-Explicit-Buttons-1"></span><h3 class="section">4.7
Utilizing Explicit Buttons</h3>
<p>Explicit buttons are a fundamental building block for creating personal
or organizational hypertext networks with Hyperbole. This section
@@ -3694,7 +3880,7 @@ buttons.
<p>
Next: <a href="#Renaming" accesskey="n" rel="next">Renaming</a>, Previous: <a
href="#Utilizing-Explicit-Buttons" accesskey="p" rel="prev">Utilizing Explicit
Buttons</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u"
rel="up">Utilizing Explicit Buttons</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Creation-1"></span><h4 class="subsection">3.7.1 Creation</h4>
+<span id="Creation-1"></span><h4 class="subsection">4.7.1 Creation</h4>
<p>Creating explicit buttons is fun and easy. You can always try them
out immediately after creating them or can utilize the Assist Key to
@@ -3714,7 +3900,7 @@ Hyperbole menus.
<p>
Next: <a href="#By-Menu" accesskey="n" rel="next">By Menu</a>, Previous: <a
href="#Creation" accesskey="p" rel="prev">Creation</a>, Up: <a href="#Creation"
accesskey="u" rel="up">Creation</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Creation-Via-Action-Key-Drags"></span><h4
class="subsubsection">3.7.1.1 Creation Via Action Key Drags</h4>
+<span id="Creation-Via-Action-Key-Drags"></span><h4
class="subsubsection">4.7.1.1 Creation Via Action Key Drags</h4>
<span id="index-explicit-button-creation"></span>
<span id="index-button-creation"></span>
@@ -3741,15 +3927,14 @@ creation process).
</p>
<p>If a region was selected prior to the start of the drag, it is used as
the button label, otherwise, you are prompted for the label. Then
-Hyperbole uses the link referent context to determine the type of link
-to make. If there are a few different types of links which are
-applicable from the context, you will be prompted with a list of the
-types. Simply use the Action Key or the first letter of the link type
-to select one of the type names and to finish the link creation.
-Hyperbole will then insert explicit button delimiters around the
-button label and will display a message in the minibuffer indicating
-the button label, its action/link type, and any arguments, notably the
-thing to which it links.
+Hyperbole uses the link referent context to determine the type of link to
+make. If there are a few different types of links which are applicable
+from the context, you will be prompted with a list of the types. Simply
+use the Action Key or the first capital letter of the link type to select
+one of the type names and to finish the link creation. Hyperbole will
+then insert explicit button delimiters around the button label and will
+display a message in the minibuffer indicating the button label, its
+action/link type, and any arguments, notably the thing to which it links.
</p>
<p>The following table shows the type of link that will be created based
upon the referent context in which the Action Key is released.
@@ -3781,7 +3966,7 @@ Buffer without File link-to-buffer-tmp
<p>
Previous: <a href="#By-Dragging" accesskey="p" rel="prev">By Dragging</a>, Up:
<a href="#Creation" accesskey="u" rel="up">Creation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Creation-Via-Menus"></span><h4 class="subsubsection">3.7.1.2
Creation Via Menus</h4>
+<span id="Creation-Via-Menus"></span><h4 class="subsubsection">4.7.1.2
Creation Via Menus</h4>
<p>You may instead use the Hyperbole menus to create explicit buttons.
First, mark a short region of text in any fashion allowed by Emacs
@@ -3827,7 +4012,7 @@ the direct selection techniques mentioned in <a
href="#Smart-Key-Argument-Select
<p>
Next: <a href="#Deletion" accesskey="n" rel="next">Deletion</a>, Previous: <a
href="#Creation" accesskey="p" rel="prev">Creation</a>, Up: <a
href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit
Buttons</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Renaming-1"></span><h4 class="subsection">3.7.2 Renaming</h4>
+<span id="Renaming-1"></span><h4 class="subsection">4.7.2 Renaming</h4>
<span id="index-explicit-button-renaming"></span>
<span id="index-button-renaming"></span>
@@ -3860,7 +4045,7 @@ within your Emacs. Bind it within your
<samp>~/.emacs</samp> file with:
<p>
Next: <a href="#Modification" accesskey="n" rel="next">Modification</a>,
Previous: <a href="#Renaming" accesskey="p" rel="prev">Renaming</a>, Up: <a
href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit
Buttons</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Deletion-1"></span><h4 class="subsection">3.7.3 Deletion</h4>
+<span id="Deletion-1"></span><h4 class="subsection">4.7.3 Deletion</h4>
<span id="index-explicit-button-deletion"></span>
<span id="index-button-deletion"></span>
@@ -3881,7 +4066,7 @@ prefer no confirmation.
<p>
Next: <a href="#Searching-and-Summarizing" accesskey="n" rel="next">Searching
and Summarizing</a>, Previous: <a href="#Deletion" accesskey="p"
rel="prev">Deletion</a>, Up: <a href="#Utilizing-Explicit-Buttons"
accesskey="u" rel="up">Utilizing Explicit Buttons</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Modification-1"></span><h4 class="subsection">3.7.4 Modification</h4>
+<span id="Modification-1"></span><h4 class="subsection">4.7.4 Modification</h4>
<span id="index-explicit-button-modification"></span>
<span id="index-button-modification"></span>
@@ -3902,7 +4087,7 @@ the keyboard. See <a href="#Creation">Creation</a>.
<p>
Next: <a href="#Buttons-in-Mail" accesskey="n" rel="next">Buttons in Mail</a>,
Previous: <a href="#Modification" accesskey="p" rel="prev">Modification</a>,
Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing
Explicit Buttons</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Searching-and-Summarizing-1"></span><h4 class="subsection">3.7.5
Searching and Summarizing</h4>
+<span id="Searching-and-Summarizing-1"></span><h4 class="subsection">4.7.5
Searching and Summarizing</h4>
<span id="index-explicit-button-summary"></span>
<span id="index-button-summary"></span>
@@ -3938,7 +4123,7 @@ attributes.
<p>
Next: <a href="#Buttons-in-News" accesskey="n" rel="next">Buttons in News</a>,
Previous: <a href="#Searching-and-Summarizing" accesskey="p"
rel="prev">Searching and Summarizing</a>, Up: <a
href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit
Buttons</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Buttons-in-Mail-1"></span><h4 class="subsection">3.7.6 Buttons in
Mail</h4>
+<span id="Buttons-in-Mail-1"></span><h4 class="subsection">4.7.6 Buttons in
Mail</h4>
<span id="index-C_002dx-m"></span>
<span id="index-mail"></span>
@@ -4043,7 +4228,7 @@ described in <a
href="#Smart-Key-Argument-Selection">Smart Key Argument Selectio
<p>
Previous: <a href="#Buttons-in-Mail" accesskey="p" rel="prev">Buttons in
Mail</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u"
rel="up">Utilizing Explicit Buttons</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Buttons-in-News-1"></span><h4 class="subsection">3.7.7 Buttons in
News</h4>
+<span id="Buttons-in-News-1"></span><h4 class="subsection">4.7.7 Buttons in
News</h4>
<span id="index-button-posting-1"></span>
<span id="index-news-reader_002fposter"></span>
@@ -4090,7 +4275,7 @@ explanation of how to turn this feature on.
<p>
Next: <a href="#HyControl" accesskey="n" rel="next">HyControl</a>, Previous:
<a href="#Buttons" accesskey="p" rel="prev">Buttons</a>, Up: <a href="#Top"
accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Menus-1"></span><h2 class="chapter">4 Menus</h2>
+<span id="Menus-1"></span><h2 class="chapter">5 Menus</h2>
<span id="index-Emacs-1"></span>
<span id="index-Hyperbole-menubar-menu"></span>
@@ -4111,11 +4296,11 @@ menubar. Here is the Hyperbole Menubar Menu and its
Find submenu.
<div class="float"><span id="image_003aHyperbole-Menu"></span>
<img src="im/menu-hyperbole.png" alt="Hyperbole Menu">
-<div class="float-caption"><p><strong>Image 4.1: </strong>Hyperbole Menubar
Menu</p></div></div>
+<div class="float-caption"><p><strong>Image 5.1: </strong>Hyperbole Menubar
Menu</p></div></div>
<div class="float"><span id="image_003aFind-Menu"></span>
<img src="im/menu-find.png" alt="Find Menu">
-<div class="float-caption"><p><strong>Image 4.2: </strong>Find Menubar
Menu</p></div></div><br>
+<div class="float-caption"><p><strong>Image 5.2: </strong>Find Menubar
Menu</p></div></div><br>
<span id="index-hyperbole_002dpopup_002dmenu"></span>
<span id="index-popup-menu"></span>
@@ -4385,7 +4570,7 @@ window configurations by name. See <a
href="#Window-Configurations">Window Conf
<p>
Next: <a href="#Koutliner" accesskey="n" rel="next">Koutliner</a>, Previous:
<a href="#Menus" accesskey="p" rel="prev">Menus</a>, Up: <a href="#Top"
accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="HyControl-1"></span><h2 class="chapter">5 HyControl</h2>
+<span id="HyControl-1"></span><h2 class="chapter">6 HyControl</h2>
<span id="index-windows-control"></span>
<span id="index-frames-control"></span>
@@ -4482,7 +4667,7 @@ to display.
<div class="float"><span id="image_003a2x3_002dWindows_002dGrid"></span>
<img src="im/wgrid-2x3.png" alt="2x3 Windows Grid">
-<div class="float-caption"><p><strong>Image 5.1: </strong>2x3 Windows
Grid</p></div></div><br>
+<div class="float-caption"><p><strong>Image 6.1: </strong>2x3 Windows
Grid</p></div></div><br>
<p>If the prefix argument is 0, prompt for a major mode whose buffers
should be displayed first in the grid windows, then prompt for the grid size.
@@ -4918,7 +5103,7 @@ press that key, the other command can be reached by
pressing <kbd>{t}</kbd>.
<p>
Next: <a href="#HyRolo" accesskey="n" rel="next">HyRolo</a>, Previous: <a
href="#HyControl" accesskey="p" rel="prev">HyControl</a>, Up: <a href="#Top"
accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Koutliner-1"></span><h2 class="chapter">6 Koutliner</h2>
+<span id="Koutliner-1"></span><h2 class="chapter">7 Koutliner</h2>
<span id="index-outliner"></span>
<span id="index-autonumber"></span>
@@ -4946,7 +5131,9 @@ file included with Hyperbole. Use <kbd>{C-h h k e}</kbd>
to display that
file, as pictured on the following page. It is an actual outline file
that explains major outliner operations. You can test out the viewing,
editing and motion commands with this file since a personal copy is made
-when you invoke this command.
+when you invoke this command. If you have already edited this file and
+want to start with a fresh one, give the command a prefix argument:
+<kbd>{C-u C-h h k e}</kbd>.
</p>
<p>See <a href="#Koutliner-Keys">Koutliner Keys</a>, for a full summary of the
key bindings and
commands available in the Koutliner.
@@ -4954,7 +5141,7 @@ commands available in the Koutliner.
<div class="float"><span id="image_003aKoutliner"></span>
<img src="im/koutliner.png" alt="Koutliner Screenshot">
-<div class="float-caption"><p><strong>Image 6.1: </strong>Koutliner
Screenshot</p></div></div><br>
+<div class="float-caption"><p><strong>Image 7.1: </strong>Koutliner
Screenshot</p></div></div><br>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Menu-Commands"
accesskey="1">Menu Commands</a></td><td> </td><td align="left"
valign="top">
@@ -4983,7 +5170,7 @@ commands available in the Koutliner.
<p>
Next: <a href="#Creating-Outlines" accesskey="n" rel="next">Creating
Outlines</a>, Previous: <a href="#Koutliner" accesskey="p"
rel="prev">Koutliner</a>, Up: <a href="#Koutliner" accesskey="u"
rel="up">Koutliner</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Menu-Commands-1"></span><h3 class="section">6.1 Menu Commands</h3>
+<span id="Menu-Commands-1"></span><h3 class="section">7.1 Menu Commands</h3>
<p>The Kotl/ menu entry on the Hyperbole minibuffer menu provides access to
a number of major Koutliner commands:
@@ -5033,14 +5220,14 @@ read the following sections explaining commands.
<div class="float"><span id="image_003aKoutline-Menu"></span>
<img src="im/menu-koutline.png" alt="Koutline Menu">
-<div class="float-caption"><p><strong>Image 6.2: </strong>Koutline
Menu</p></div></div><br>
+<div class="float-caption"><p><strong>Image 7.2: </strong>Koutline
Menu</p></div></div><br>
<hr>
<span id="Creating-Outlines"></span><div class="header">
<p>
Next: <a href="#Autonumbering" accesskey="n" rel="next">Autonumbering</a>,
Previous: <a href="#Menu-Commands" accesskey="p" rel="prev">Menu Commands</a>,
Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Creating-Outlines-1"></span><h3 class="section">6.2 Creating
Outlines</h3>
+<span id="Creating-Outlines-1"></span><h3 class="section">7.2 Creating
Outlines</h3>
<span id="index-outline-file-suffix"></span>
<span id="index-outline_002c-creating"></span>
@@ -5075,7 +5262,7 @@ structure of the outline changes.
<p>
Next: <a href="#Idstamps" accesskey="n" rel="next">Idstamps</a>, Previous: <a
href="#Creating-Outlines" accesskey="p" rel="prev">Creating Outlines</a>, Up:
<a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Autonumbering-1"></span><h3 class="section">6.3 Autonumbering</h3>
+<span id="Autonumbering-1"></span><h3 class="section">7.3 Autonumbering</h3>
<span id="index-autonumber-1"></span>
<span id="index-relative-identifier"></span>
@@ -5152,7 +5339,7 @@ initialization file, <samp>~/.emacs</samp>, substituting
for ‘your-separat
<p>
Next: <a href="#Editing" accesskey="n" rel="next">Editing</a>, Previous: <a
href="#Autonumbering" accesskey="p" rel="prev">Autonumbering</a>, Up: <a
href="#Koutliner" accesskey="u" rel="up">Koutliner</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Idstamps-1"></span><h3 class="section">6.4 Idstamps</h3>
+<span id="Idstamps-1"></span><h3 class="section">7.4 Idstamps</h3>
<span id="index-permanent-identifier-1"></span>
<span id="index-idstamp-1"></span>
@@ -5183,7 +5370,7 @@ begin with a 0, as in 012, to distinguish them from
relative ids.
<p>
Next: <a href="#Viewing" accesskey="n" rel="next">Viewing</a>, Previous: <a
href="#Idstamps" accesskey="p" rel="prev">Idstamps</a>, Up: <a
href="#Koutliner" accesskey="u" rel="up">Koutliner</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Editing-1"></span><h3 class="section">6.5 Editing</h3>
+<span id="Editing-1"></span><h3 class="section">7.5 Editing</h3>
<p>Text editing within the Koutliner works just as it does for other
buffers, except when you need to deal with the structural components of
@@ -5227,7 +5414,7 @@ selected region, since that will destroy the outline
structure.
<p>
Next: <a href="#Relocating-and-Copying" accesskey="n" rel="next">Relocating
and Copying</a>, Previous: <a href="#Editing" accesskey="p"
rel="prev">Editing</a>, Up: <a href="#Editing" accesskey="u"
rel="up">Editing</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Adding-and-Killing-1"></span><h4 class="subsection">6.5.1 Adding and
Killing</h4>
+<span id="Adding-and-Killing-1"></span><h4 class="subsection">7.5.1 Adding and
Killing</h4>
<span id="index-koutliner_002c-C_002dj"></span>
<span id="index-koutliner_002c-C_002du-c_002dj"></span>
@@ -5263,7 +5450,7 @@ buffer with <kbd>{C-y}</kbd>.
<p>
Next: <a href="#Moving-Around" accesskey="n" rel="next">Moving Around</a>,
Previous: <a href="#Adding-and-Killing" accesskey="p" rel="prev">Adding and
Killing</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Relocating-and-Copying-1"></span><h4 class="subsection">6.5.2
Relocating and Copying</h4>
+<span id="Relocating-and-Copying-1"></span><h4 class="subsection">7.5.2
Relocating and Copying</h4>
<span id="index-promotion"></span>
<span id="index-demotion"></span>
@@ -5303,17 +5490,56 @@ Set the variable,
<code>kotl-mode:indent-tabs-mode</code>, to
Use <kbd>{M-1 <span class="key">TAB</span>}</kbd> to toggle the <tt
class="key">TAB</tt> and
<kbd>{M-<span class="key">TAB</span>}</kbd> keys back to promoting and
demoting trees.
</p>
+
+<span id="index-Org-tables"></span>
+<p>The Koutliner supports Org Table editing, see <a
href="https://www.gnu.org/software/emacs/manual/html_mono/org.html#Tables">Tables</a>
in <cite>the Org
+Mode Manual</cite>, via Org table minor mode. Use <kbd>{M-x orgtbl-mode <span
class="key">RET</span>}</kbd>
+to toggle this on and off. A press of the Action Key on a <code>|</code>
symbol,
+also toggles this minor mode on or off.
+</p>
+<span id="index-outline-mode"></span>
+<span id="index-M_002d0-TAB"></span>
+<span id="index-M_002d0-M_002dTAB"></span>
+<p>Tree demotion and promotion keys 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.
+</p>
+<p>Note that you must use <kbd>{M-0 <span class="key">TAB</span>}</kbd> and
<kbd>{M-0 M-<span class="key">TAB</span>}</kbd> to
+demote/promote Koutline trees when in a table since <tt class="key">TAB</tt>
by itself
+moves between fields within a table.
+</p>
+<div class="example">
+<pre
class="example">|----------------------------+-----------------------------|
+| Demotion Inside Org Table | Promotion Inside Org Table |
+|----------------------------+-----------------------------|
+| M-0 TAB | M-0 Shift-TAB or M-0 M-TAB |
+| C-c C-, | C-c C-. |
+| C-c C-< | C-c C-> |
+|----------------------------+-----------------------------|
+
+|----------------------------+-----------------------------|
+| Demotion Outside Org Table | Promotion Outside Org Table |
+|----------------------------+-----------------------------|
+| TAB | Shift-TAB or M-TAB |
+| M-left-arrow | M-right-arrow |
+| C-c C-, | C-c C-. |
+| C-c C-< | C-c C-> |
+|----------------------------+-----------------------------|
+</pre></div>
+
+
<span id="index-tree_002c-copying"></span>
<span id="index-tree_002c-moving"></span>
<span id="index-Action-Key_002c-cell-argument"></span>
<span id="index-koutliner_002c-Action-Key_002c-cell-argument"></span>
-<p>For maximum flexibility in rearranging outlines, there are commands that
-move or copy entire trees. Each of these commands prompts for the label
-of the root cell to move or copy and for a second cell which specifies
-the new location for the moved or copied tree. You may either accept
-the default provided, type in the cell label, or when a mouse is
-available, simply double click with the Action Key on the contents of a
-cell. The Koutliner knows to use the cell’s label in such cases.
+<p>For maximum flexibility in rearranging outlines, there are commands
+that move or copy entire trees anywhere within the outline. Each of
+these commands prompts for the label of the root cell to move or copy
+and for a second cell which specifies the new location for the moved
+or copied tree. You may either accept the default provided, type in
+the cell label, or when a mouse is available, simply double click with
+the Action Key on the contents of a cell. The Koutliner knows to use
+the cell’s label in such cases.
</p>
<p>In the following commands, words delimited with <> represent the
arguments for which each command prompts. Note how the use of prefix
@@ -5401,7 +5627,7 @@ See <a href="#Inserting-and-Importing">Inserting and
Importing</a>.
<p>
Next: <a href="#Filling" accesskey="n" rel="next">Filling</a>, Previous: <a
href="#Relocating-and-Copying" accesskey="p" rel="prev">Relocating and
Copying</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Moving-Around-1"></span><h4 class="subsection">6.5.3 Moving
Around</h4>
+<span id="Moving-Around-1"></span><h4 class="subsection">7.5.3 Moving
Around</h4>
<span id="index-outline_002c-motion"></span>
<p>In addition to normal emacs movement commands, you can move within a
@@ -5470,7 +5696,7 @@ cell or from one cell or tree to another.
<p>
Next: <a href="#Transposing" accesskey="n" rel="next">Transposing</a>,
Previous: <a href="#Moving-Around" accesskey="p" rel="prev">Moving Around</a>,
Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Filling-1"></span><h4 class="subsection">6.5.4 Filling</h4>
+<span id="Filling-1"></span><h4 class="subsection">7.5.4 Filling</h4>
<span id="index-outline_002c-filling"></span>
<span id="index-filling"></span>
@@ -5502,12 +5728,12 @@ right margins.
<span id="index-refilling"></span>
<span id="index-attribute_002c-no_002dfill"></span>
<span id="index-cell_002c-no_002dfill-attribute"></span>
-<p>Set the variable, <code>kotl-mode:refill-flag</code>, to
‘<samp>t</samp>’ if you want
-moving, promoting, demoting, exchanging, splitting and appending cells
-to also automatically refill each cell. Generally, this is not
-recommended since if you happen to move a cell that you carefully
-formatted yet forgot to give a ‘no-fill’ property, then your
formatting
-will be lost.
+<p>Set the variable, <code>kotl-mode:refill-flag</code>, to
‘<samp>t</samp>’ if you
+want moving, promoting, demoting, exchanging, splitting and appending
+cells to also automatically refill each cell, aside from any that have
+a ‘no-fill’ property. Generally, this is not recommended since if
you
+happen to move a cell that you carefully formatted yet forgot to give
+a ‘no-fill’ property, then your formatting will be lost.
</p>
<hr>
@@ -5515,7 +5741,7 @@ will be lost.
<p>
Next: <a href="#Splitting-and-Appending" accesskey="n" rel="next">Splitting
and Appending</a>, Previous: <a href="#Filling" accesskey="p"
rel="prev">Filling</a>, Up: <a href="#Editing" accesskey="u"
rel="up">Editing</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Transposing-1"></span><h4 class="subsection">6.5.5 Transposing</h4>
+<span id="Transposing-1"></span><h4 class="subsection">7.5.5 Transposing</h4>
<p>The Koutliner move and copy commands rearrange entire trees. The
following two commands, in contrast, exchange the locations of two
@@ -5547,7 +5773,7 @@ fewer visible, it makes the current cell the last cell in
the outline.
<p>
Next: <a href="#Inserting-and-Importing" accesskey="n" rel="next">Inserting
and Importing</a>, Previous: <a href="#Transposing" accesskey="p"
rel="prev">Transposing</a>, Up: <a href="#Editing" accesskey="u"
rel="up">Editing</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Splitting-and-Appending-1"></span><h4 class="subsection">6.5.6
Splitting and Appending</h4>
+<span id="Splitting-and-Appending-1"></span><h4 class="subsection">7.5.6
Splitting and Appending</h4>
<span id="index-splitting-a-cell"></span>
<span id="index-cell_002c-splitting"></span>
@@ -5579,7 +5805,7 @@ This helps maintain any special formatting the appended
text may have.
<p>
Next: <a href="#Exporting" accesskey="n" rel="next">Exporting</a>, Previous:
<a href="#Splitting-and-Appending" accesskey="p" rel="prev">Splitting and
Appending</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Inserting-and-Importing-1"></span><h4 class="subsection">6.5.7
Inserting and Importing</h4>
+<span id="Inserting-and-Importing-1"></span><h4 class="subsection">7.5.7
Inserting and Importing</h4>
<span id="index-outline_002c-inserting-into"></span>
<span id="index-outline_002c-importing-into"></span>
@@ -5602,7 +5828,7 @@ cell.
<span id="index-kimport_003asuffix_002dalist"></span>
<span id="index-outline_002c-conversion"></span>
<span id="index-kotl_002dmode"></span>
-<span id="index-outline-mode"></span>
+<span id="index-outline-mode-1"></span>
<span id="index-koutline-mode"></span>
<span id="index-file_002c-importing"></span>
<span id="index-importing-a-file"></span>
@@ -5668,7 +5894,7 @@ create.
<p>
Previous: <a href="#Inserting-and-Importing" accesskey="p"
rel="prev">Inserting and Importing</a>, Up: <a href="#Editing" accesskey="u"
rel="up">Editing</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Exporting-1"></span><h4 class="subsection">6.5.8 Exporting</h4>
+<span id="Exporting-1"></span><h4 class="subsection">7.5.8 Exporting</h4>
<span id="index-outline_002c-exporting-from"></span>
<span id="index-outline_002c-HTML-conversion"></span>
@@ -5691,7 +5917,7 @@ written; the output file will not be displayed.
<p>
Next: <a href="#Links" accesskey="n" rel="next">Links</a>, Previous: <a
href="#Editing" accesskey="p" rel="prev">Editing</a>, Up: <a href="#Koutliner"
accesskey="u" rel="up">Koutliner</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Viewing-1"></span><h3 class="section">6.6 Viewing</h3>
+<span id="Viewing-1"></span><h3 class="section">7.6 Viewing</h3>
<span id="index-outline_002c-viewing"></span>
<span id="index-view"></span>
@@ -5710,7 +5936,7 @@ effectively browse and study large amounts of material.
<p>
Next: <a href="#View-Specs" accesskey="n" rel="next">View Specs</a>, Previous:
<a href="#Viewing" accesskey="p" rel="prev">Viewing</a>, Up: <a href="#Viewing"
accesskey="u" rel="up">Viewing</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Hiding-and-Showing-1"></span><h4 class="subsection">6.6.1 Hiding and
Showing</h4>
+<span id="Hiding-and-Showing-1"></span><h4 class="subsection">7.6.1 Hiding and
Showing</h4>
<span id="index-outline_002c-hiding"></span>
<span id="index-outline_002c-showing"></span>
@@ -5812,7 +6038,7 @@ point. Try it with either your mouse or with
<kbd>{M-<span class="key">RET</spa
<p>
Previous: <a href="#Hiding-and-Showing" accesskey="p" rel="prev">Hiding and
Showing</a>, Up: <a href="#Viewing" accesskey="u" rel="up">Viewing</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="View-Specs-1"></span><h4 class="subsection">6.6.2 View Specs</h4>
+<span id="View-Specs-1"></span><h4 class="subsection">7.6.2 View Specs</h4>
<span id="index-view-spec"></span>
<span id="index-modeline_002c-view-spec"></span>
@@ -5926,7 +6152,7 @@ cells below level one.
<p>
Next: <a href="#Cell-Attributes" accesskey="n" rel="next">Cell Attributes</a>,
Previous: <a href="#Viewing" accesskey="p" rel="prev">Viewing</a>, Up: <a
href="#Koutliner" accesskey="u" rel="up">Koutliner</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Links-1"></span><h3 class="section">6.7 Links</h3>
+<span id="Links-1"></span><h3 class="section">7.7 Links</h3>
<span id="index-link"></span>
<span id="index-hyperlink"></span>
@@ -6005,7 +6231,7 @@ and to label cells with the alphanumeric style.
<p>
Next: <a href="#Koutliner-History" accesskey="n" rel="next">Koutliner
History</a>, Previous: <a href="#Links" accesskey="p" rel="prev">Links</a>, Up:
<a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Cell-Attributes-1"></span><h3 class="section">6.8 Cell
Attributes</h3>
+<span id="Cell-Attributes-1"></span><h3 class="section">7.8 Cell
Attributes</h3>
<span id="index-cell_002c-attribute"></span>
<span id="index-attribute"></span>
@@ -6075,7 +6301,7 @@ attributes for all visible cells in the outline.
<p>
Previous: <a href="#Cell-Attributes" accesskey="p" rel="prev">Cell
Attributes</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Koutliner-History-1"></span><h3 class="section">6.9 Koutliner
History</h3>
+<span id="Koutliner-History-1"></span><h3 class="section">7.9 Koutliner
History</h3>
<span id="index-NLS"></span>
<span id="index-Augment"></span>
@@ -6105,7 +6331,7 @@ these capabilities back into the mainstream of modern
computing culture.
<p>
Next: <a href="#Window-Configurations" accesskey="n" rel="next">Window
Configurations</a>, Previous: <a href="#Koutliner" accesskey="p"
rel="prev">Koutliner</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="HyRolo-1"></span><h2 class="chapter">7 HyRolo</h2>
+<span id="HyRolo-1"></span><h2 class="chapter">8 HyRolo</h2>
<span id="index-Rolo"></span>
<span id="index-HyRolo"></span>
@@ -6139,7 +6365,7 @@ tool.
<p>
Next: <a href="#HyRolo-Menu" accesskey="n" rel="next">HyRolo Menu</a>,
Previous: <a href="#HyRolo" accesskey="p" rel="prev">HyRolo</a>, Up: <a
href="#HyRolo" accesskey="u" rel="up">HyRolo</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="HyRolo-Concepts-1"></span><h3 class="section">7.1 HyRolo
Concepts</h3>
+<span id="HyRolo-Concepts-1"></span><h3 class="section">8.1 HyRolo
Concepts</h3>
<span id="index-rolo-file"></span>
<span id="index-rolo-entry"></span>
@@ -6204,7 +6430,7 @@ Searching for Manager turns up all Staffer entries.
<p>
Next: <a href="#HyRolo-Searching" accesskey="n" rel="next">HyRolo
Searching</a>, Previous: <a href="#HyRolo-Concepts" accesskey="p"
rel="prev">HyRolo Concepts</a>, Up: <a href="#HyRolo" accesskey="u"
rel="up">HyRolo</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Rolo-Menu"></span><h3 class="section">7.2 Rolo Menu</h3>
+<span id="Rolo-Menu"></span><h3 class="section">8.2 Rolo Menu</h3>
<p>The Rolo submenu of the Hyperbole menu offers a full set of commands
for searching and maintaining a personal address book. It looks like
@@ -6213,7 +6439,7 @@ so.
<div class="float"><span id="image_003aRolo-Menu"></span>
<img src="im/menu-rolo.png" alt="HyRolo Menu">
-<div class="float-caption"><p><strong>Image 7.1: </strong>HyRolo
Menu</p></div></div>
+<div class="float-caption"><p><strong>Image 8.1: </strong>HyRolo
Menu</p></div></div>
<span id="index-Rolo-menu"></span>
<span id="index-HyRolo-menu"></span>
<span id="index-menu_002c-HyRolo"></span>
@@ -6301,7 +6527,7 @@ containing "Staffer" at any level in a
hierarchy, like so:
<p>
Next: <a href="#HyRolo-Keys" accesskey="n" rel="next">HyRolo Keys</a>,
Previous: <a href="#HyRolo-Menu" accesskey="p" rel="prev">HyRolo Menu</a>, Up:
<a href="#HyRolo" accesskey="u" rel="up">HyRolo</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="HyRolo-Searching-1"></span><h3 class="section">7.3 HyRolo
Searching</h3>
+<span id="HyRolo-Searching-1"></span><h3 class="section">8.3 HyRolo
Searching</h3>
<span id="index-rolo-searching"></span>
<span id="index-searching_002c-rolo"></span>
@@ -6366,7 +6592,7 @@ you should contact.
<p>
Next: <a href="#HyRolo-Settings" accesskey="n" rel="next">HyRolo Settings</a>,
Previous: <a href="#HyRolo-Searching" accesskey="p" rel="prev">HyRolo
Searching</a>, Up: <a href="#HyRolo" accesskey="u" rel="up">HyRolo</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="HyRolo-Keys-1"></span><h3 class="section">7.4 HyRolo Keys</h3>
+<span id="HyRolo-Keys-1"></span><h3 class="section">8.4 HyRolo Keys</h3>
<span id="index-hyrolo-menu"></span>
<span id="index-rolo-keys"></span>
@@ -6420,12 +6646,10 @@ matches. Standard string, <kbd>{C-s}</kbd>, and
regular expression,
<kbd>{C-M-s}</kbd>, interactive search commands are also available within
the rolo match buffer.
</p>
-<span id="index-rolo_002c-a"></span>
-<span id="index-rolo_002c-h"></span>
<span id="index-rolo_002c-o"></span>
-<span id="index-rolo_002c-s"></span>
<span id="index-rolo_002c-t"></span>
-<span id="index-rolo_002c-outlining"></span>
+<span id="index-rolo_002c-top_002dlevel-entries"></span>
+<span id="index-rolo_002c-outline-of-entries"></span>
<p>Single key outlining commands are also available for browsing matches.
If your search matches a large number of entries, use <kbd>{t}</kbd> to get
a top-level summary of entries. Only the first line of each
@@ -6434,9 +6658,18 @@ levels, use <kbd>{o}</kbd> which shows the first line of
every entry level.
If you want an overview of just the first two levels, <kbd>{C-u 2 o}</kbd>
will work.
</p>
-<p>Press <kbd>{s}</kbd> to show (expand) the entry at point.
-Use <kbd>{h}</kbd> to hide (collapse) the entry. Press <kbd>{a}</kbd>
-to expand all entries in the buffer.
+<span id="index-rolo_002c-a"></span>
+<span id="index-rolo_002c-h"></span>
+<span id="index-rolo_002c-s"></span>
+<span id="index-rolo_002c-auto_002dexpanding-entries"></span>
+<span id="index-rolo_002c-hiding-entries"></span>
+<span id="index-rolo_002c-showing-entries"></span>
+<p>Press <kbd>{s}</kbd> to show (expand) the entry at point. Use
<kbd>{h}</kbd> to hide
+(collapse) the entry. Press <kbd>{a}</kbd> to expand all entries in the
+buffer. If an entry is collapsed/hidden, moving to any hidden part
+auto-expands it and then re-collapses it when point is moved to another
+entry (just like isearch). A side-effect of this is that the <kbd>{h}</kbd>
+hide entry subtree command now moves to the beginning of the entry.
</p>
<p>Other keys are defined to help you work with matching entries.
</p>
@@ -6522,7 +6755,7 @@ current frame to its state prior to the rolo search.
<p>
Previous: <a href="#HyRolo-Keys" accesskey="p" rel="prev">HyRolo Keys</a>, Up:
<a href="#HyRolo" accesskey="u" rel="up">HyRolo</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="HyRolo-Settings-1"></span><h3 class="section">7.5 HyRolo
Settings</h3>
+<span id="HyRolo-Settings-1"></span><h3 class="section">8.5 HyRolo
Settings</h3>
<span id="index-hyrolo_002dfile_002dlist"></span>
<span id="index-rolo_002c-personal"></span>
@@ -6681,7 +6914,7 @@ There is never a need to learn a complicated query
language.
<p>
Next: <a href="#Developing-with-Hyperbole" accesskey="n" rel="next">Developing
with Hyperbole</a>, Previous: <a href="#HyRolo" accesskey="p"
rel="prev">HyRolo</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Window-Configurations-1"></span><h2 class="chapter">8 Window
Configurations</h2>
+<span id="Window-Configurations-1"></span><h2 class="chapter">9 Window
Configurations</h2>
<span id="index-window-configurations"></span>
<span id="index-restoring-windows"></span>
@@ -6783,7 +7016,7 @@ is added.
<p>
Next: <a href="#Glossary" accesskey="n" rel="next">Glossary</a>, Previous: <a
href="#Window-Configurations" accesskey="p" rel="prev">Window
Configurations</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Developing-with-Hyperbole-1"></span><h2 class="chapter">9 Developing
with Hyperbole</h2>
+<span id="Developing-with-Hyperbole-1"></span><h2 class="chapter">10
Developing with Hyperbole</h2>
<p>This chapter is for people who wish to customize Hyperbole, to extend
it, or to develop other systems using Hyperbole as a base. Most of it
@@ -6810,7 +7043,7 @@ regular expressions.
<p>
Next: <a href="#Creating-Types" accesskey="n" rel="next">Creating Types</a>,
Previous: <a href="#Developing-with-Hyperbole" accesskey="p"
rel="prev">Developing with Hyperbole</a>, Up: <a
href="#Developing-with-Hyperbole" accesskey="u" rel="up">Developing with
Hyperbole</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Hook-Variables-1"></span><h3 class="section">9.1 Hook Variables</h3>
+<span id="Hook-Variables-1"></span><h3 class="section">10.1 Hook Variables</h3>
<span id="index-variables"></span>
<span id="index-hook-variables"></span>
@@ -6831,7 +7064,7 @@ appended. Hyperbole includes the following hook
variables:
</p>
<dl compact="compact">
<dt><code>hyperbole-init-hook</code>
-<span id="index-hyperbole_002dinit_002dhook"></span>
+<span id="index-hyperbole_002dinit_002dhook-1"></span>
</dt>
<dd><p>For customization at Hyperbole initialization time. Use this to load
any personal Hyperbole type definitions or key bindings you might have.
@@ -6992,7 +7225,7 @@ specific usage of such hooks.
<p>
Next: <a href="#Explicit-Button-Technicalities" accesskey="n"
rel="next">Explicit Button Technicalities</a>, Previous: <a
href="#Hook-Variables" accesskey="p" rel="prev">Hook Variables</a>, Up: <a
href="#Developing-with-Hyperbole" accesskey="u" rel="up">Developing with
Hyperbole</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Creating-Types-1"></span><h3 class="section">9.2 Creating Types</h3>
+<span id="Creating-Types-1"></span><h3 class="section">10.2 Creating Types</h3>
<span id="index-type-definition"></span>
<span id="index-type-redefinition-1"></span>
@@ -7034,7 +7267,7 @@ and <samp>hibtypes.el</samp> for examples.
<p>
Next: <a href="#Creating-Implicit-Button-Types" accesskey="n"
rel="next">Creating Implicit Button Types</a>, Previous: <a
href="#Creating-Types" accesskey="p" rel="prev">Creating Types</a>, Up: <a
href="#Creating-Types" accesskey="u" rel="up">Creating Types</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Creating-Action-Types-1"></span><h4 class="subsection">9.2.1
Creating Action Types</h4>
+<span id="Creating-Action-Types-1"></span><h4 class="subsection">10.2.1
Creating Action Types</h4>
<span id="index-actype_003acreate"></span>
<span id="index-file_002c-hactypes_002eel-1"></span>
@@ -7155,7 +7388,7 @@ returned by the call).
<p>
Previous: <a href="#Creating-Action-Types" accesskey="p" rel="prev">Creating
Action Types</a>, Up: <a href="#Creating-Types" accesskey="u" rel="up">Creating
Types</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Creating-Implicit-Button-Types-1"></span><h4
class="subsection">9.2.2 Creating Implicit Button Types</h4>
+<span id="Creating-Implicit-Button-Types-1"></span><h4
class="subsection">10.2.2 Creating Implicit Button Types</h4>
<p>Implicit buttons leverage the same action types used by explicit and
global buttons but each carries an additional implicit button type
@@ -7206,7 +7439,7 @@ techniques.
<p>
Next: <a href="#Implicit-Button-Link-Types" accesskey="n" rel="next">Implicit
Button Link Types</a>, Previous: <a href="#Creating-Implicit-Button-Types"
accesskey="p" rel="prev">Creating Implicit Button Types</a>, Up: <a
href="#Creating-Implicit-Button-Types" accesskey="u" rel="up">Creating Implicit
Button Types</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Action-Button-Link-Types-1"></span><h4 class="subsubsection">9.2.2.1
Action Button Link Types</h4>
+<span id="Action-Button-Link-Types-1"></span><h4
class="subsubsection">10.2.2.1 Action Button Link Types</h4>
<p>The simplest way to create a new implicit link type (from which any
number of buttons can be recognized within text) is to create an
@@ -7265,7 +7498,7 @@ expression-based link type creation. See <a
href="#Programmatic-Implicit-Button
<p>
Next: <a href="#Programmatic-Implicit-Button-Types" accesskey="n"
rel="next">Programmatic Implicit Button Types</a>, Previous: <a
href="#Action-Button-Link-Types" accesskey="p" rel="prev">Action Button Link
Types</a>, Up: <a href="#Creating-Implicit-Button-Types" accesskey="u"
rel="up">Creating Implicit Button Types</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Implicit-Button-Link-Types-1"></span><h4
class="subsubsection">9.2.2.2 Implicit Button Link Types</h4>
+<span id="Implicit-Button-Link-Types-1"></span><h4
class="subsubsection">10.2.2.2 Implicit Button Link Types</h4>
<p>If you understand Emacs regular expressions (see <a
href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Regexps">Syntax
of
Regular Expressions</a> in <cite>the GNU Emacs Manual</cite>), you can create
new
@@ -7335,7 +7568,7 @@ commit changes.
<p>
Previous: <a href="#Implicit-Button-Link-Types" accesskey="p"
rel="prev">Implicit Button Link Types</a>, Up: <a
href="#Creating-Implicit-Button-Types" accesskey="u" rel="up">Creating Implicit
Button Types</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Programmatic-Implicit-Button-Types-1"></span><h4
class="subsubsection">9.2.2.3 Programmatic Implicit Button Types</h4>
+<span id="Programmatic-Implicit-Button-Types-1"></span><h4
class="subsubsection">10.2.2.3 Programmatic Implicit Button Types</h4>
<span id="index-implicit-button-type"></span>
<span id="index-ibtype"></span>
@@ -7414,7 +7647,7 @@ the <samp>hib-kbd.el</samp> file for an example of a
custom help function.
<p>
Next: <a href="#Encapsulating-Systems" accesskey="n" rel="next">Encapsulating
Systems</a>, Previous: <a href="#Creating-Types" accesskey="p"
rel="prev">Creating Types</a>, Up: <a href="#Developing-with-Hyperbole"
accesskey="u" rel="up">Developing with Hyperbole</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Explicit-Button-Technicalities-1"></span><h3 class="section">9.3
Explicit Button Technicalities</h3>
+<span id="Explicit-Button-Technicalities-1"></span><h3 class="section">10.3
Explicit Button Technicalities</h3>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Button-Label-Normalization"
accesskey="1">Button Label Normalization</a></td><td> </td><td
align="left" valign="top">
</td></tr>
@@ -7429,7 +7662,7 @@ Next: <a href="#Encapsulating-Systems" accesskey="n"
rel="next">Encapsulating Sy
<p>
Next: <a href="#Operational-and-Storage-Formats" accesskey="n"
rel="next">Operational and Storage Formats</a>, Previous: <a
href="#Explicit-Button-Technicalities" accesskey="p" rel="prev">Explicit Button
Technicalities</a>, Up: <a href="#Explicit-Button-Technicalities" accesskey="u"
rel="up">Explicit Button Technicalities</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Button-Label-Normalization-1"></span><h4 class="subsection">9.3.1
Button Label Normalization</h4>
+<span id="Button-Label-Normalization-1"></span><h4 class="subsection">10.3.1
Button Label Normalization</h4>
<span id="index-normalized-label"></span>
<span id="index-button-label-2"></span>
<span id="index-button-key"></span>
@@ -7475,7 +7708,7 @@ intervention is required.
<p>
Next: <a href="#Programmatic-Button-Creation" accesskey="n"
rel="next">Programmatic Button Creation</a>, Previous: <a
href="#Button-Label-Normalization" accesskey="p" rel="prev">Button Label
Normalization</a>, Up: <a href="#Explicit-Button-Technicalities" accesskey="u"
rel="up">Explicit Button Technicalities</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Operational-and-Storage-Formats-1"></span><h4
class="subsection">9.3.2 Operational and Storage Formats</h4>
+<span id="Operational-and-Storage-Formats-1"></span><h4
class="subsection">10.3.2 Operational and Storage Formats</h4>
<span id="index-explicit-button-formats"></span>
<span id="index-explicit-button-storage"></span>
@@ -7507,7 +7740,7 @@ any Hyperbole client programming.
<p>
Previous: <a href="#Operational-and-Storage-Formats" accesskey="p"
rel="prev">Operational and Storage Formats</a>, Up: <a
href="#Explicit-Button-Technicalities" accesskey="u" rel="up">Explicit Button
Technicalities</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Programmatic-Button-Creation-1"></span><h4 class="subsection">9.3.3
Programmatic Button Creation</h4>
+<span id="Programmatic-Button-Creation-1"></span><h4 class="subsection">10.3.3
Programmatic Button Creation</h4>
<span id="index-explicit-button_002c-programmatic-creation"></span>
<p>A common need when developing with Hyperbole is to create or to modify
@@ -7519,8 +7752,6 @@ quickly.
</p>
<span id="index-class_002c-ebut-1"></span>
<span id="index-file_002c-hbut_002eel-1"></span>
-<span id="index-ebut_003acreate"></span>
-<span id="index-ebut_003amap"></span>
<p>The Hyperbole class ‘<samp>ebut</samp>’ supports programmatic
access to explicit
buttons. Examine it within the <samp>hbut.el</samp> file for full details.
</p>
@@ -7536,18 +7767,24 @@ the button LABEL which is automatically provided as the
first argument.
</p>
<p>For interactive explicit creation, use <code>hui:ebut-create</code> instead.
</p>
+<span id="index-ebut_003acreate"></span>
+<span id="index-ebut_003amap"></span>
<p>The documentation for <code>(ebut:create)</code> explains the set of
attributes necessary to create an explicit button. For operations over
the whole set of buttons within the visible (non-narrowed) portion of a
buffer, use the <code>(ebut:map)</code> function.
</p>
+<span id="index-gbut_003aebut_002dprogram"></span>
+<p>Similarly, <code>gbut:ebut-program</code> programmatically adds global
explicit
+buttons at the end of the personal button file.
+</p>
<hr>
<span id="Encapsulating-Systems"></span><div class="header">
<p>
Next: <a href="#Embedding-Hyperbole" accesskey="n" rel="next">Embedding
Hyperbole</a>, Previous: <a href="#Explicit-Button-Technicalities"
accesskey="p" rel="prev">Explicit Button Technicalities</a>, Up: <a
href="#Developing-with-Hyperbole" accesskey="u" rel="up">Developing with
Hyperbole</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Encapsulating-Systems-1"></span><h3 class="section">9.4
Encapsulating Systems</h3>
+<span id="Encapsulating-Systems-1"></span><h3 class="section">10.4
Encapsulating Systems</h3>
<span id="index-file_002c-hsys_002d_002a"></span>
<span id="index-Hyperbole_002c-system-encapsulation"></span>
@@ -7574,7 +7811,7 @@ that a press of the Action Key follows a URL.
<p>
Previous: <a href="#Encapsulating-Systems" accesskey="p"
rel="prev">Encapsulating Systems</a>, Up: <a href="#Developing-with-Hyperbole"
accesskey="u" rel="up">Developing with Hyperbole</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Embedding-Hyperbole-1"></span><h3 class="section">9.5 Embedding
Hyperbole</h3>
+<span id="Embedding-Hyperbole-1"></span><h3 class="section">10.5 Embedding
Hyperbole</h3>
<p>[NOTE: We have never done this ourselves, though we have done similar
things which leads us to infer that the task should not be difficult.]
@@ -8176,55 +8413,59 @@ Next: <a href="#Hyperbole-Key-Bindings" accesskey="n"
rel="next">Hyperbole Key B
use it. Instructions are given below. If you are using InfoDock
version 4.0.7 or higher, Hyperbole is pre-installed so you may skip
the installation instructions and simply continue with the
-invocation instructions in this appendix.
+next section about customizing Hyperbole’s behavior.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Installation"
accesskey="1">Installation</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Invocation"
accesskey="2">Invocation</a></td><td> </td><td align="left"
valign="top">
-</td></tr>
-<tr><td align="left" valign="top">• <a href="#Customization"
accesskey="3">Customization</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#Customization"
accesskey="2">Customization</a></td><td> </td><td align="left"
valign="top">
</td></tr>
</table>
<hr>
<span id="Installation"></span><div class="header">
<p>
-Next: <a href="#Invocation" accesskey="n" rel="next">Invocation</a>, Previous:
<a href="#Setup" accesskey="p" rel="prev">Setup</a>, Up: <a href="#Setup"
accesskey="u" rel="up">Setup</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+Next: <a href="#Customization" accesskey="n" rel="next">Customization</a>,
Previous: <a href="#Setup" accesskey="p" rel="prev">Setup</a>, Up: <a
href="#Setup" accesskey="u" rel="up">Setup</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
<span id="Installation-1"></span><h3 class="section">B.1 Installation</h3>
<p>There are multiple package managers you can use to install Hyperbole once
-you have GNU Emacs set up at your site.
+you have GNU Emacs set up at your site. Choose one based on your needs.
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">• <a
href="#Stable-Package-Installation" accesskey="1">Stable Package
Installation</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Elpa-Stable-Package-Installation" accesskey="1">Elpa Stable Package
Installation</a></td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Elpa-In_002dDevelopment-Package-Installation" accesskey="2">Elpa
In-Development Package Installation</a></td><td> </td><td
align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Git-Pre_002drelease-Package-Installation" accesskey="2">Git Pre-release
Package Installation</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Git-In_002dDevelopment-Package-Installation" accesskey="3">Git
In-Development Package Installation</a></td><td> </td><td
align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Manual-Tarball-Archive-Installation" accesskey="3">Manual Tarball
Archive Installation</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Manual-Tarball-Archive-Installation" accesskey="4">Manual Tarball
Archive Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<p>After installing Hyperbole, read the next section on Invocation.
</p>
<hr>
-<span id="Stable-Package-Installation"></span><div class="header">
+<span id="Elpa-Stable-Package-Installation"></span><div class="header">
<p>
-Next: <a href="#Git-Pre_002drelease-Package-Installation" accesskey="n"
rel="next">Git Pre-release Package Installation</a>, Previous: <a
href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Elpa-In_002dDevelopment-Package-Installation" accesskey="n"
rel="next">Elpa In-Development Package Installation</a>, Previous: <a
href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span
id="Stable-Package-Installation-_0028Emacs-Package-Manager_0029"></span><h4
class="subsection">B.1.1 Stable Package Installation (Emacs Package
Manager)</h4>
+<span
id="Elpa-Stable-Package-Installation-_0028Emacs-Package-Manager_0029"></span><h4
class="subsection">B.1.1 Elpa Stable Package Installation (Emacs Package
Manager)</h4>
<span id="index-installation"></span>
+<span id="index-elpa-package"></span>
<span id="index-package-manager"></span>
<span id="index-Emacs-package-manager"></span>
<span id="index-stable-release-installation"></span>
<span id="index-installation_002c-stable"></span>
<span id="index-obtaining-Hyperbole"></span>
<span id="index-Hyperbole_002c-obtaining-1"></span>
-<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 <a
href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Packages">Packages</a>
in <cite>the GNU Emacs Manual</cite>.
+<p>Once you have Emacs set up at your site, the stable, released version of
+GNU Hyperbole may be installed by using the Emacs Package Manager. If
+you are not familiar with it, see <a
href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Packages">Packages</a>
in <cite>the GNU Emacs
+Manual</cite>. Releases are very rare and the in-development branch may be
+many months and features ahead, so you may want to consider using either
+the Elpa In-Development or Git In-Development installation instead.
</p>
<p>If you have Hyperbole installed and simply want to upgrade it, invoke
the Emacs Package Manager with <kbd>{M-x list-packages <span
class="key">RET</span>}</kbd>,
@@ -8239,40 +8480,105 @@ several lines to your personal Emacs initialization
file, <samp>~/.emacs</samp>.
<p>Below are the lines to add:
</p>
<div class="lisp">
-<pre class="lisp">(require 'package)
-(when (< emacs-major-version 27)
- (package-initialize))
+<pre class="lisp">(when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version
%d" emacs-major-version))
+(require 'package)
(unless (package-installed-p 'hyperbole)
(package-refresh-contents)
(package-install 'hyperbole))
(hyperbole-mode 1)
</pre></div>
-<p>Now save the file and 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>Now save the file and 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>
<hr>
-<span id="Git-Pre_002drelease-Package-Installation"></span><div class="header">
+<span id="Elpa-In_002dDevelopment-Package-Installation"></span><div
class="header">
<p>
-Next: <a href="#Manual-Tarball-Archive-Installation" accesskey="n"
rel="next">Manual Tarball Archive Installation</a>, Previous: <a
href="#Stable-Package-Installation" accesskey="p" rel="prev">Stable Package
Installation</a>, Up: <a href="#Installation" accesskey="u"
rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+Next: <a href="#Git-In_002dDevelopment-Package-Installation" accesskey="n"
rel="next">Git In-Development Package Installation</a>, Previous: <a
href="#Elpa-Stable-Package-Installation" accesskey="p" rel="prev">Elpa Stable
Package Installation</a>, Up: <a href="#Installation" accesskey="u"
rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span
id="Git-Pre_002drelease-Package-Installation-_0028Straight-Package-Manager_0029"></span><h4
class="subsection">B.1.2 Git Pre-release Package Installation (Straight
Package Manager)</h4>
+<span id="Elpa-In_002dDevelopment-Package-Installation-1"></span><h4
class="subsection">B.1.2 Elpa In-Development Package Installation</h4>
-<span id="index-Straight-package-manager"></span>
+<span id="index-elpa_002ddevel-package"></span>
+<span id="index-in_002ddevelopment-installation"></span>
<span id="index-pre_002drelease-installation"></span>
<span id="index-installation_002c-pre_002drelease"></span>
<span id="index-installation_002c-from-git"></span>
-<p>If you prefer to track Hyperbole development between releases and like to
-try out new features still in testing, then use the Straight package
-manager instead of the above, which pulls the latest Hyperbole source code
-from its git repository. This also gives you a cleaner installation
-process without showing you any byte compilation warnings.
+<p>The Elpa In-Development package pulls from the latest Hyperbole
+development branch tip and does not require installation of any new
+package manager software. Since Hyperbole is a mature package, this is
+usually fine to use and update on a day-to-day basis. But new features
+are tested on this branch and once in awhile it may break for a short
+time before a fix is pushed. With this branch you’ll be able to submit
+bug reports and feature requests but will not be able to submit pull
+requests for changes to the developers; use the Git In-Development
+Package instead for that.
+</p>
+<p>If you have Hyperbole installed and simply want to upgrade it, invoke
+the Emacs Package Manager with <kbd>{M-x list-packages <span
class="key">RET</span>}</kbd>,
+then use the <kbd>{U}</kbd> key followed by the <kbd>{x}</kbd> key to upgrade
all
+out-of-date packages, Hyperbole among them. Then skip the text below
+and move on to the next section, see <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,
<samp>~/.emacs</samp>.
+(For further details, see <a
href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Init-File">The
Emacs Initialization File</a> in <cite>the GNU Emacs Manual</cite>).
+</p>
+<p>Below are the lines to add:
+</p>
+<div class="lisp">
+<pre class="lisp">(when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version
%d" emacs-major-version))
+(require 'package)
+(add-to-list 'package-archives '("gnu-devel" .
"https://elpa.gnu.org/devel/"))
+(unless (package-installed-p 'hyperbole)
+ (package-refresh-contents)
+ (package-install 'hyperbole))
+(hyperbole-mode 1)
+</pre></div>
+
+<p>Now save the file and 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>
+<hr>
+<span id="Git-In_002dDevelopment-Package-Installation"></span><div
class="header">
+<p>
+Next: <a href="#Manual-Tarball-Archive-Installation" accesskey="n"
rel="next">Manual Tarball Archive Installation</a>, Previous: <a
href="#Elpa-In_002dDevelopment-Package-Installation" accesskey="p"
rel="prev">Elpa In-Development Package Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span
id="Git-In_002dDevelopment-Package-Installation-_0028Straight-Package-Manager_0029"></span><h4
class="subsection">B.1.3 Git In-Development Package Installation (Straight
Package Manager)</h4>
+
+<span id="index-Straight-package-manager"></span>
+<span id="index-pre_002drelease-installation-1"></span>
+<span id="index-installation_002c-pre_002drelease-1"></span>
+<span id="index-installation_002c-from-git-1"></span>
+<p>If you potentially want to contribute to Hyperbole development and send
+pull requests to the Hyperbole development team or to try out new
+features still in testing, you can use the Straight package manager. It
+pulls the latest Hyperbole source code directly from its git repository.
+This also gives you a clean installation process without showing you any
+minor byte compilation warnings.
+</p>
+<p>If you have Hyperbole installed and simply want to upgrade it, invoke
+the Emacs Package Manager with <kbd>{M-x list-packages <span
class="key">RET</span>}</kbd>,
+then use the <kbd>{U}</kbd> key followed by the <kbd>{x}</kbd> key to upgrade
all
+out-of-date packages, Hyperbole among them. Then skip the text below
+and move on to the next section, see <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,
<samp>~/.emacs</samp>.
+(For further details, see <a
href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Init-File">The
Emacs Initialization File</a> in <cite>the GNU Emacs Manual</cite>).
+</p>
+<p>Below are the lines to add:
</p>
<div class="lisp">
<pre class="lisp">;; Use this in your Emacs init file to install Straight
(progn
+ (when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version
%d" emacs-major-version))
(defvar bootstrap-version)
(setq package-enable-at-startup nil)
(let ((bootstrap-file
@@ -8296,12 +8602,15 @@ process without showing you any byte compilation
warnings.
:config (hyperbole-mode 1)))
</pre></div>
+<p>Now save the file and restart Emacs. Hyperbole will then be downloaded
+and compiled for use with your version of Emacs; give it a minute or two.
+</p>
<hr>
<span id="Manual-Tarball-Archive-Installation"></span><div class="header">
<p>
-Previous: <a href="#Git-Pre_002drelease-Package-Installation" accesskey="p"
rel="prev">Git Pre-release Package Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Git-In_002dDevelopment-Package-Installation" accesskey="p"
rel="prev">Git In-Development Package Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Manual-Tarball-Archive-Installation-1"></span><h4
class="subsection">B.1.3 Manual Tarball Archive Installation</h4>
+<span id="Manual-Tarball-Archive-Installation-1"></span><h4
class="subsection">B.1.4 Manual Tarball Archive Installation</h4>
<p>If you are old-school, don’t like package managers, and prefer doing
everything by hand, then you can obtain Hyperbole from a tarball:
@@ -8321,7 +8630,7 @@ to at the top of this web page:
</p>
<p>Then decompress and unpack the archive to a directory of your
-choosing. Move into the <samp>hyperbole/</samp> directory and execute
+choosing. Move into the <samp>hyperbole-<version>/</samp> directory and
execute
the following Posix shell command, <code>make bin</code>, to
byte-compile the Hyperbole lisp files. Then add the following
lines to your personal Emacs initialization file,
@@ -8329,6 +8638,8 @@ lines to your personal Emacs initialization file,
</p>
<div class="lisp">
<pre class="lisp">(unless (and (featurep 'hyperbole) hyperbole-mode)
+ (when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version
%d" emacs-major-version))
(push "<directory-ending-with-hyperbole-where-you-unpacked>"
load-path)
(require 'hyperbole)
(hyperbole-mode 1))
@@ -8338,87 +8649,11 @@ lines to your personal Emacs initialization file,
indicator in your modeline after startup.
</p>
<hr>
-<span id="Invocation"></span><div class="header">
-<p>
-Next: <a href="#Customization" accesskey="n" rel="next">Customization</a>,
Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>,
Up: <a href="#Setup" accesskey="u" rel="up">Setup</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<span id="Invocation-1"></span><h3 class="section">B.2 Invocation</h3>
-
-<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 <kbd>{C-h h}</kbd> will display a Hyperbole menu in
-the minibuffer for quick keyboard or mouse-based selection. Select an
-item from this menu by typing the item’s first letter. Use
<kbd>{q}</kbd>
-to quit from the menu.
-</p>
-<p>You can invoke Hyperbole’s commands in one of three ways:
-</p>
-<ul>
-<li> use the Hyperbole entry on your menubar;
-
-</li><li> <span id="index-hyperbole"></span>
-type <kbd>{C-h h}</kbd> or <kbd>{M-x hyperbole <span
class="key">RET</span>}</kbd> to display the Hyperbole minibuffer menu;
-
-</li><li> use a specific Hyperbole command, for example, a press of
-<kbd>{M-<span class="key">RET</span>}</kbd> on a pathname to display the
associated file or
-directory.
-</li></ul>
-
-<p>Use <kbd>{C-h h d d}</kbd> for an interactive demonstration of standard
Hyperbole
-button capabilities.
-</p>
-<p>Type <kbd>{C-h h k e}</kbd> for an interactive demonstration of the
Koutliner,
-Hyperbole’s multi-level autonumbered hypertextual outliner.
-</p>
-<p>To try out HyControl, Hyperbole’s interactive frame and window control
-system, use <kbd>{C-h h s w}</kbd> for window control or <kbd>{C-h h s f}</kbd>
-for frame control. Pressing <kbd>{t}</kbd> switches between window and
-frame control once in HyControl. Hyperbole also binds <kbd>{C-c \}</kbd>
-for quick access to HyControl’s window control menu if it was not
-already bound prior to Hyperbole’s initialization. A long video
-demonstrating most of HyControl’s features is available at
-<a href="https://youtu.be/M3-aMh1ccJk">https://youtu.be/M3-aMh1ccJk</a>.
-</p>
-<span id="index-Info_002ddirectory_002dlist"></span>
-<span id="index-hyperb_003adir"></span>
-<span id="index-Hyperbole-manual"></span>
-<p>The above are the best interactive ways to learn about Hyperbole. The
-Hyperbole Manual is a reference manual, not a simple introduction. It
-is included in the <samp>man/</samp> subdirectory of the Hyperbole package
-directory in four forms:
-</p>
-<span id="index-Info-manual"></span>
-<span id="index-Texinfo-manual"></span>
-<span id="index-file_002c-man_002fhyperbole_002einfo"></span>
-<span id="index-file_002c-man_002fhyperbole_002ehtml"></span>
-<span id="index-file_002c-man_002fhyperbole_002epdf"></span>
-<span id="index-file_002c-man_002fhyperbole_002etexi"></span>
-<div class="example">
-<pre class="example"><samp>man/hyperbole.info</samp> - online Info browser
version
-<samp>man/hyperbole.html</samp> - web HTML version
-<samp>man/hyperbole.pdf</samp> - printable version
-<samp>man/hyperbole.texi</samp> - source form
-</pre></div>
-
-<span id="index-C_002dh-h-d-i"></span>
-<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. <kbd>{C-h h d i}</kbd> will let you
-browse the manual. Then use <kbd>{s}</kbd> to search for anything
-throughout the manual. For web browsing, point your browser
-at <samp><code>${hyperb:dir}</code>/man/hyperbole.html</samp>, wherever the
-Hyperbole package directory is on your system; often this
-is: <samp>~/.emacs.d/elpa/hyperbole-${hyperb:version}/</samp>.
-</p>
-<p>Advanced users may want to continue on to the next section about
-configuring Hyperbole’s behavior.
-</p>
-<hr>
<span id="Customization"></span><div class="header">
<p>
-Previous: <a href="#Invocation" accesskey="p" rel="prev">Invocation</a>, Up:
<a href="#Setup" accesskey="u" rel="up">Setup</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>,
Up: <a href="#Setup" accesskey="u" rel="up">Setup</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Customization-1"></span><h3 class="section">B.3 Customization</h3>
+<span id="Customization-1"></span><h3 class="section">B.2 Customization</h3>
<span id="index-menu_002c-Cust-1"></span>
<span id="index-configuration"></span>
@@ -8489,7 +8724,7 @@ be of interest to users.
<p>
Next: <a href="#Internal-Viewers" accesskey="n" rel="next">Internal
Viewers</a>, Previous: <a href="#Customization" accesskey="p"
rel="prev">Customization</a>, Up: <a href="#Customization" accesskey="u"
rel="up">Customization</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Referent-Display-1"></span><h4 class="subsection">B.3.1 Referent
Display</h4>
+<span id="Referent-Display-1"></span><h4 class="subsection">B.2.1 Referent
Display</h4>
<span id="index-hpath_003adisplay_002dwhere-1"></span>
<span id="index-referent-display"></span>
<span id="index-link-display"></span>
@@ -8500,10 +8735,10 @@ Next: <a href="#Internal-Viewers" accesskey="n"
rel="next">Internal Viewers</a>,
<span id="index-internal-display"></span>
<span id="index-external-display"></span>
<p>Hyperbole lets you control where link referents are displayed. It also
-permits setting a specific Emacs function or external program
-to display them. There are four categories of referents, each with
-its own display setting, listed in decreasing order of priority. All
-of these variables are defined within <samp>hpath.el</samp>.
+permits setting a specific Emacs function or external program to display
+them. There are four categories of referents, each with its own
+customizable display setting, listed in decreasing order of priority.
+All of these variables are defined within <samp>hpath.el</samp>.
</p>
<div class="example">
<pre class="example">Referent Category Variable Setting
@@ -8523,7 +8758,7 @@ are displayed internally and externally.
<p>
Next: <a href="#External-Viewers" accesskey="n" rel="next">External
Viewers</a>, Previous: <a href="#Referent-Display" accesskey="p"
rel="prev">Referent Display</a>, Up: <a href="#Customization" accesskey="u"
rel="up">Customization</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Internal-Viewers-1"></span><h4 class="subsection">B.3.2 Internal
Viewers</h4>
+<span id="Internal-Viewers-1"></span><h4 class="subsection">B.2.2 Internal
Viewers</h4>
<span id="index-hpath_003ainternal_002ddisplay_002dalist"></span>
<span id="index-file-display-function"></span>
<span id="index-display-function"></span>
@@ -8612,7 +8847,7 @@ external, window-system specific viewers.
<p>
Next: <a href="#Link-Variable-Substitution" accesskey="n" rel="next">Link
Variable Substitution</a>, Previous: <a href="#Internal-Viewers" accesskey="p"
rel="prev">Internal Viewers</a>, Up: <a href="#Customization" accesskey="u"
rel="up">Customization</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="External-Viewers-1"></span><h4 class="subsection">B.3.3 External
Viewers</h4>
+<span id="External-Viewers-1"></span><h4 class="subsection">B.2.3 External
Viewers</h4>
<span id="index-hpath_003aget_002dexternal_002ddisplay_002dalist"></span>
<span id="index-hpath_003aexternal_002ddisplay_002dalist_002dmacos"></span>
<span id="index-hpath_003aexternal_002ddisplay_002dalist_002dmswindows"></span>
@@ -8654,7 +8889,7 @@ values to suit your needs.
<p>
Next: <a href="#Web-Search-Engines" accesskey="n" rel="next">Web Search
Engines</a>, Previous: <a href="#External-Viewers" accesskey="p"
rel="prev">External Viewers</a>, Up: <a href="#Customization" accesskey="u"
rel="up">Customization</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Link-Variable-Substitution-1"></span><h4 class="subsection">B.3.4
Link Variable Substitution</h4>
+<span id="Link-Variable-Substitution-1"></span><h4 class="subsection">B.2.4
Link Variable Substitution</h4>
<span id="index-hpath_003avariables"></span>
<span id="index-environment-variables-1"></span>
<span id="index-Emacs-Lisp-variables-1"></span>
@@ -8683,7 +8918,7 @@ you in deciding whether or not to modify the value of
<code>hpath:variables</cod
<p>
Next: <a href="#Using-URLs-with-Find_002dFile" accesskey="n" rel="next">Using
URLs with Find-File</a>, Previous: <a href="#Link-Variable-Substitution"
accesskey="p" rel="prev">Link Variable Substitution</a>, Up: <a
href="#Customization" accesskey="u" rel="up">Customization</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Web-Search-Engines-1"></span><h4 class="subsection">B.3.5 Web Search
Engines</h4>
+<span id="Web-Search-Engines-1"></span><h4 class="subsection">B.2.5 Web Search
Engines</h4>
<span id="index-menu_002c-Find_002fWeb-1"></span>
<span id="index-menu_002c-Web-1"></span>
@@ -8720,7 +8955,7 @@ Cust/Web-Search menu. Below is the equivalent Hyperbole
menubar menu.
<p>
Next: <a href="#Invisible-Text-Searches" accesskey="n" rel="next">Invisible
Text Searches</a>, Previous: <a href="#Web-Search-Engines" accesskey="p"
rel="prev">Web Search Engines</a>, Up: <a href="#Customization" accesskey="u"
rel="up">Customization</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Using-URLs-with-Find_002dFile-1"></span><h4 class="subsection">B.3.6
Using URLs with Find-File</h4>
+<span id="Using-URLs-with-Find_002dFile-1"></span><h4 class="subsection">B.2.6
Using URLs with Find-File</h4>
<span id="index-find_002dfile"></span>
<span id="index-find_002dfile_002c-browsing-URLs"></span>
@@ -8776,7 +9011,7 @@ menu.
<p>
Next: <a href="#Button-Colors" accesskey="n" rel="next">Button Colors</a>,
Previous: <a href="#Using-URLs-with-Find_002dFile" accesskey="p"
rel="prev">Using URLs with Find-File</a>, Up: <a href="#Customization"
accesskey="u" rel="up">Customization</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Invisible-Text-Searches-1"></span><h4 class="subsection">B.3.7
Invisible Text Searches</h4>
+<span id="Invisible-Text-Searches-1"></span><h4 class="subsection">B.2.7
Invisible Text Searches</h4>
<span id="index-menu-item_002c-Isearch_002dInvisible"></span>
<span id="index-menu-item_002c-Toggle_002dIsearch_002dInvisible"></span>
@@ -8799,7 +9034,7 @@ interactive search.
<p>
Previous: <a href="#Invisible-Text-Searches" accesskey="p"
rel="prev">Invisible Text Searches</a>, Up: <a href="#Customization"
accesskey="u" rel="up">Customization</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Configuring-Button-Colors"></span><h4 class="subsection">B.3.8
Configuring Button Colors</h4>
+<span id="Configuring-Button-Colors"></span><h4 class="subsection">B.2.8
Configuring Button Colors</h4>
<span id="index-Emacs-support"></span>
<span id="index-button-highlighting-1"></span>
<span id="index-highlighting-buttons"></span>
@@ -8817,6 +9052,11 @@ code which supports this behavior. A call
to <code>(hproperty:cycle-but-color)</code> in the <samp>hsettings.el</samp>
file
changes the color used to highlight and flash explicit buttons.
</p>
+<span id="index-hproperty_003abut_002dflash_002dtime_002dseconds"></span>
+<span id="index-button-flash-time"></span>
+<p>You may also change the length of time in fractions of a second that a
+button flashes by setting <code>hproperty:but-flash-time-seconds</code>.
+</p>
<span id="index-hproperty_003abut_002dhighlight_002dflag"></span>
<p>Whether or not buttons are highlighted is controlled
by <code>hproperty:but-highlight-flag</code>, which defaults to
‘<samp>t</samp>’.
@@ -8858,6 +9098,8 @@ bindings that hide global Hyperbole keys.
</td></tr>
<tr><td align="left" valign="top">• <a href="#Default-Hyperbole-Bindings"
accesskey="2">Default Hyperbole Bindings</a></td><td> </td><td
align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">• <a href="#Testing"
accesskey="3">Testing</a></td><td> </td><td align="left"
valign="top">
+</td></tr>
</table>
<hr>
@@ -8879,7 +9121,7 @@ select the item you want to bind to your key.
<hr>
<span id="Default-Hyperbole-Bindings"></span><div class="header">
<p>
-Previous: <a href="#Binding-Minibuffer-Menu-Items" accesskey="p"
rel="prev">Binding Minibuffer Menu Items</a>, Up: <a
href="#Hyperbole-Key-Bindings" accesskey="u" rel="up">Hyperbole Key
Bindings</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+Next: <a href="#Testing" accesskey="n" rel="next">Testing</a>, Previous: <a
href="#Binding-Minibuffer-Menu-Items" accesskey="p" rel="prev">Binding
Minibuffer Menu Items</a>, Up: <a href="#Hyperbole-Key-Bindings" accesskey="u"
rel="up">Hyperbole Key Bindings</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
<span id="Default-Hyperbole-Bindings-1"></span><h3 class="section">C.2 Default
Hyperbole Bindings</h3>
@@ -9025,6 +9267,40 @@ as part of any setting of
<code>hyperbole-init-hook</code> within your
personal <samp>~/.emacs</samp> file. For example, <code>(add-hook
'hyperbole-init-hook (lambda () (global-set-key "\C-ct"
'hyperbole-mode)))</code>.
</p>
+<hr>
+<span id="Testing"></span><div class="header">
+<p>
+Previous: <a href="#Default-Hyperbole-Bindings" accesskey="p"
rel="prev">Default Hyperbole Bindings</a>, Up: <a
href="#Hyperbole-Key-Bindings" accesskey="u" rel="up">Hyperbole Key
Bindings</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+</div>
+<span id="Testing-1"></span><h3 class="section">C.3 Testing</h3>
+
+<p>Hyperbole includes over 200 automated test cases in the <samp>test/</samp>
+subdirectory. You can run all of them by moving to the Hyperbole home
+directory in a Posix shell and run <code>make test-all</code> or <code>make
+test</code> to run just non-interactive tests. If any tests fail, you can
+press the Action Key to see the source of the failure. Full testing is
+suppored under POSIX systems only.
+</p>
+<p>With Hyperbole active, you can also define implicit buttons that run
+individual or sets of Hyperbole tests. The file <samp>hypb-ert.el</samp>
contains
+two action link types:
+</p>
+<div class="example">
+<pre class="example"><code>hyperbole-run-test</code> - run a single Hyperbole
test by name
+<code>hyperbole-run-tests</code> - run one more tests matching a pattern
+
+Example uses with a press of the Action Key:
+
+ Run the test hbut-defal-url:
+ <hyperbole-run-test hbut-defal-url>
+
+ Run the tests specified by the test selector hbut-defal:
+ <hyperbole-run-tests hbut-defal>
+
+ Run all tests:
+ <hyperbole-run-tests t>
+</pre></div>
+
<hr>
<span id="Koutliner-Keys"></span><div class="header">
<p>
@@ -10096,21 +10372,25 @@ Previous: <a href="#Smart-Mouse-Keys" accesskey="p"
rel="prev">Smart Mouse Keys<
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Company-Mode" accesskey="1">Smart Key - Company
Mode</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Smart-Key-_002d-Treemacs"
accesskey="2">Smart Key - Treemacs</a></td><td> </td><td
align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Smart-Key-_002d-Org-Mode"
accesskey="2">Smart Key - Org Mode</a></td><td> </td><td
align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Smart-Key-_002d-Ivy"
accesskey="3">Smart Key - Ivy</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Dired-Sidebar-Mode" accesskey="3">Smart Key - Dired
Sidebar Mode</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Smart-Key-_002d-Treemacs"
accesskey="4">Smart Key - Treemacs</a></td><td> </td><td
align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Emacs-Pushbuttons" accesskey="4">Smart Key - Emacs
Pushbuttons</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Dired-Sidebar-Mode" accesskey="5">Smart Key - Dired
Sidebar Mode</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Argument-Completion" accesskey="5">Smart Key - Argument
Completion</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Emacs-Pushbuttons" accesskey="6">Smart Key - Emacs
Pushbuttons</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-ID-Edit-Mode" accesskey="6">Smart Key - ID Edit
Mode</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Argument-Completion" accesskey="7">Smart Key - Argument
Completion</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029"
accesskey="7">Smart Key - Emacs Cross-references
(Xrefs)</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-ID-Edit-Mode" accesskey="8">Smart Key - ID Edit
Mode</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Smart-Scrolling" accesskey="8">Smart Key - Smart
Scrolling</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029"
accesskey="9">Smart Key - Emacs Cross-references
(Xrefs)</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Smart-Menus" accesskey="9">Smart Key - Smart
Menus</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart
Scrolling</a></td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Smart-Menus">Smart Key - Smart
Menus</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Dired-Mode">Smart Key - Dired
Mode</a></td><td> </td><td align="left" valign="top">
</td></tr>
@@ -10128,6 +10408,8 @@ Previous: <a href="#Smart-Mouse-Keys" accesskey="p"
rel="prev">Smart Mouse Keys<
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Help-Buffers">Smart Key - Help
Buffers</a></td><td> </td><td align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Custom-Mode">Smart Key - Custom
Mode</a></td><td> </td><td align="left" valign="top">
+</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Bookmark-Mode">Smart Key - Bookmark
Mode</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a
href="#Smart-Key-_002d-Pages-Directory-Mode">Smart Key - Pages Directory
Mode</a></td><td> </td><td align="left" valign="top">
@@ -10193,7 +10475,7 @@ Previous: <a href="#Smart-Mouse-Keys" accesskey="p"
rel="prev">Smart Mouse Keys<
<hr>
<span id="Smart-Key-_002d-Company-Mode"></span><div class="header">
<p>
-Next: <a href="#Smart-Key-_002d-Treemacs" accesskey="n" rel="next">Smart Key -
Treemacs</a>, Previous: <a href="#Smart-Keyboard-Keys" accesskey="p"
rel="prev">Smart Keyboard Keys</a>, Up: <a href="#Smart-Keyboard-Keys"
accesskey="u" rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Smart-Key-_002d-Org-Mode" accesskey="n" rel="next">Smart Key -
Org Mode</a>, Previous: <a href="#Smart-Keyboard-Keys" accesskey="p"
rel="prev">Smart Keyboard Keys</a>, Up: <a href="#Smart-Keyboard-Keys"
accesskey="u" rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
<span id="Smart-Key-_002d-Company-Mode-1"></span><h4 class="subsection">E.2.1
Smart Key - Company Mode</h4>
@@ -10209,13 +10491,66 @@ Next: <a href="#Smart-Key-_002d-Treemacs"
accesskey="n" rel="next">Smart Key - T
Displays the documentation, if any, for the selected item.
</pre></div>
+<hr>
+<span id="Smart-Key-_002d-Org-Mode"></span><div class="header">
+<p>
+Next: <a href="#Smart-Key-_002d-Ivy" accesskey="n" rel="next">Smart Key -
Ivy</a>, Previous: <a href="#Smart-Key-_002d-Company-Mode" accesskey="p"
rel="prev">Smart Key - Company Mode</a>, Up: <a href="#Smart-Keyboard-Keys"
accesskey="u" rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Smart-Key-_002d-Org-Mode-1"></span><h4 class="subsection">E.2.2
Smart Key - Org Mode</h4>
+<span id="index-hsys_002dorg_002denable_002dsmart_002dkeys-1"></span>
+<span id="index-Org-mode"></span>
+<div class="format">
+<pre class="format">When in an Org mode context and
<code>hsys-org-enable-smart-keys</code> is non-nil:
+ ACTION KEY
+ (1) follows internal links in Org mode files. When pressed on a link
+ referent/target, the link definition is displayed, allowing two-way
+ navigation between definitions and targets.
+
+ (2) follows Org mode external links.
+
+ (3) within a radio target definition, this jumps to the first occurrence
+ of an associated radio target.
+
+ (4) when point is on an outline heading in Org mode, this cycles the view
+ of the subtree at point.
+
+ (5) with point on the first line of a code block definition, this executes
+ the code block via the Org mode standard binding of <kbd>{C-c
C-c}</kbd>,
+ <code>(org-ctrl-c-ctrl-c)</code>.
+
+ (6) In any other context besides the end of a line, the Action Key
invokes the
+ Org mode standard binding of <kbd>{M-<span
class="key">RET</span>}</kbd>, <code>(org-meta-return)</code>.
+
+ ASSIST KEY
+ (1) on an Org mode heading, this cycles through views of the whole buffer
outline.
+
+ (2) on an Org mode link or agenda item, this displays standard Hyperbole
help.
+</pre></div>
+
+<span id="index-org_002dlink_002doutside_002dorg_002dmode"></span>
+<p>Org links may be used outside of Org mode buffers. Such links are
+handled by the separate implicit button type,
<code>org-link-outside-org-mode</code>.
+</p>
+
+<hr>
+<span id="Smart-Key-_002d-Ivy"></span><div class="header">
+<p>
+Next: <a href="#Smart-Key-_002d-Treemacs" accesskey="n" rel="next">Smart Key -
Treemacs</a>, Previous: <a href="#Smart-Key-_002d-Org-Mode" accesskey="p"
rel="prev">Smart Key - Org Mode</a>, Up: <a href="#Smart-Keyboard-Keys"
accesskey="u" rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Smart-Key-_002d-Ivy-1"></span><h4 class="subsection">E.2.3 Smart Key
- Ivy</h4>
+
+<span id="index-Ivy-completion"></span>
+<span id="index-completion_002c-Ivy"></span>
+<p>When an Ivy completion list is active, a press of either Smart Key on a
+completion candidate selects that one and exits the minibuffer.
+</p>
<hr>
<span id="Smart-Key-_002d-Treemacs"></span><div class="header">
<p>
-Next: <a href="#Smart-Key-_002d-Dired-Sidebar-Mode" accesskey="n"
rel="next">Smart Key - Dired Sidebar Mode</a>, Previous: <a
href="#Smart-Key-_002d-Company-Mode" accesskey="p" rel="prev">Smart Key -
Company Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+Next: <a href="#Smart-Key-_002d-Dired-Sidebar-Mode" accesskey="n"
rel="next">Smart Key - Dired Sidebar Mode</a>, Previous: <a
href="#Smart-Key-_002d-Ivy" accesskey="p" rel="prev">Smart Key - Ivy</a>, Up:
<a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Treemacs-1"></span><h4 class="subsection">E.2.2
Smart Key - Treemacs</h4>
+<span id="Smart-Key-_002d-Treemacs-1"></span><h4 class="subsection">E.2.4
Smart Key - Treemacs</h4>
<span id="index-Treemacs-1"></span>
<p>Treemacs is an add-on Emacs package that offers a fixed, per-frame,
graphical
@@ -10248,7 +10583,7 @@ See <a
href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items
<p>
Next: <a href="#Smart-Key-_002d-Emacs-Pushbuttons" accesskey="n"
rel="next">Smart Key - Emacs Pushbuttons</a>, Previous: <a
href="#Smart-Key-_002d-Treemacs" accesskey="p" rel="prev">Smart Key -
Treemacs</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Dired-Sidebar-Mode-1"></span><h4
class="subsection">E.2.3 Smart Key - Dired Sidebar Mode</h4>
+<span id="Smart-Key-_002d-Dired-Sidebar-Mode-1"></span><h4
class="subsection">E.2.5 Smart Key - Dired Sidebar Mode</h4>
<span id="index-dired_002dsidebar_002dmode"></span>
<p>Dired-sidebar is an add-on Emacs package that puts dired in a sidebar
@@ -10278,7 +10613,7 @@ package manager to install it and then invoke it with
<p>
Next: <a href="#Smart-Key-_002d-Argument-Completion" accesskey="n"
rel="next">Smart Key - Argument Completion</a>, Previous: <a
href="#Smart-Key-_002d-Dired-Sidebar-Mode" accesskey="p" rel="prev">Smart Key -
Dired Sidebar Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Emacs-Pushbuttons-1"></span><h4
class="subsection">E.2.4 Smart Key - Emacs Pushbuttons</h4>
+<span id="Smart-Key-_002d-Emacs-Pushbuttons-1"></span><h4
class="subsection">E.2.6 Smart Key - Emacs Pushbuttons</h4>
<div class="format">
<pre class="format">When over an Emacs pushbutton:
@@ -10293,7 +10628,7 @@ Next: <a href="#Smart-Key-_002d-Argument-Completion"
accesskey="n" rel="next">Sm
<p>
Next: <a href="#Smart-Key-_002d-ID-Edit-Mode" accesskey="n" rel="next">Smart
Key - ID Edit Mode</a>, Previous: <a href="#Smart-Key-_002d-Emacs-Pushbuttons"
accesskey="p" rel="prev">Smart Key - Emacs Pushbuttons</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Argument-Completion-1"></span><h4
class="subsection">E.2.5 Smart Key - Argument Completion</h4>
+<span id="Smart-Key-_002d-Argument-Completion-1"></span><h4
class="subsection">E.2.7 Smart Key - Argument Completion</h4>
<span id="index-Smart-Keyboard-Keys"></span>
<div class="format">
@@ -10322,7 +10657,7 @@ Next: <a href="#Smart-Key-_002d-ID-Edit-Mode"
accesskey="n" rel="next">Smart Key
<p>
Next: <a href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029"
accesskey="n" rel="next">Smart Key - Emacs Cross-references (Xrefs)</a>,
Previous: <a href="#Smart-Key-_002d-Argument-Completion" accesskey="p"
rel="prev">Smart Key - Argument Completion</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-ID-Edit-Mode-1"></span><h4 class="subsection">E.2.6
Smart Key - ID Edit Mode</h4>
+<span id="Smart-Key-_002d-ID-Edit-Mode-1"></span><h4 class="subsection">E.2.8
Smart Key - ID Edit Mode</h4>
<div class="format">
<pre class="format">If in ID Edit mode (a package within InfoDock, not
included in
Hyperbole, that supports rapid marking, killing, copying, yanking and
@@ -10336,7 +10671,7 @@ display-management):
<p>
Next: <a href="#Smart-Key-_002d-Smart-Scrolling" accesskey="n"
rel="next">Smart Key - Smart Scrolling</a>, Previous: <a
href="#Smart-Key-_002d-ID-Edit-Mode" accesskey="p" rel="prev">Smart Key - ID
Edit Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span
id="Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029-1"></span><h4
class="subsection">E.2.7 Smart Key - Emacs Cross-references (Xrefs)</h4>
+<span
id="Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029-1"></span><h4
class="subsection">E.2.9 Smart Key - Emacs Cross-references (Xrefs)</h4>
<div class="format">
<pre class="format">When over an Emacs cross-reference:
@@ -10352,7 +10687,7 @@ Next: <a href="#Smart-Key-_002d-Smart-Scrolling"
accesskey="n" rel="next">Smart
<p>
Next: <a href="#Smart-Key-_002d-Smart-Menus" accesskey="n" rel="next">Smart
Key - Smart Menus</a>, Previous: <a
href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029"
accesskey="p" rel="prev">Smart Key - Emacs Cross-references (Xrefs)</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Smart-Scrolling-1"></span><h4
class="subsection">E.2.8 Smart Key - Smart Scrolling</h4>
+<span id="Smart-Key-_002d-Smart-Scrolling-1"></span><h4
class="subsection">E.2.10 Smart Key - Smart Scrolling</h4>
<span id="index-smart_002dscroll_002dproportional"></span>
<span id="index-proportional-scrolling-1"></span>
@@ -10392,7 +10727,7 @@ Next: <a href="#Smart-Key-_002d-Smart-Menus"
accesskey="n" rel="next">Smart Key
<p>
Next: <a href="#Smart-Key-_002d-Dired-Mode" accesskey="n" rel="next">Smart Key
- Dired Mode</a>, Previous: <a href="#Smart-Key-_002d-Smart-Scrolling"
accesskey="p" rel="prev">Smart Key - Smart Scrolling</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Smart-Menus-1"></span><h4 class="subsection">E.2.9
Smart Key - Smart Menus</h4>
+<span id="Smart-Key-_002d-Smart-Menus-1"></span><h4 class="subsection">E.2.11
Smart Key - Smart Menus</h4>
<p>Smart Menus are an older in-buffer menu system that worked on dumb
terminals and pre-dated Emacs’ own dumb terminal menu support. They
@@ -10424,7 +10759,7 @@ necesary for its use.
<p>
Next: <a href="#Smart-Key-_002d-Hyperbole-Buttons" accesskey="n"
rel="next">Smart Key - Hyperbole Buttons</a>, Previous: <a
href="#Smart-Key-_002d-Smart-Menus" accesskey="p" rel="prev">Smart Key - Smart
Menus</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Dired-Mode-1"></span><h4 class="subsection">E.2.10
Smart Key - Dired Mode</h4>
+<span id="Smart-Key-_002d-Dired-Mode-1"></span><h4 class="subsection">E.2.12
Smart Key - Dired Mode</h4>
<span id="index-click_002c-dired"></span>
<span id="index-drag_002c-dired"></span>
<span id="index-dired-browsing"></span>
@@ -10463,7 +10798,7 @@ Next: <a href="#Smart-Key-_002d-Hyperbole-Buttons"
accesskey="n" rel="next">Smar
<p>
Next: <a href="#Smart-Key-_002d-View-Mode" accesskey="n" rel="next">Smart Key
- View Mode</a>, Previous: <a href="#Smart-Key-_002d-Dired-Mode" accesskey="p"
rel="prev">Smart Key - Dired Mode</a>, Up: <a href="#Smart-Keyboard-Keys"
accesskey="u" rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Hyperbole-Buttons-1"></span><h4
class="subsection">E.2.11 Smart Key - Hyperbole Buttons</h4>
+<span id="Smart-Key-_002d-Hyperbole-Buttons-1"></span><h4
class="subsection">E.2.13 Smart Key - Hyperbole Buttons</h4>
<span id="index-click_002c-button"></span>
<span id="index-button-click"></span>
@@ -10481,7 +10816,7 @@ Next: <a href="#Smart-Key-_002d-View-Mode"
accesskey="n" rel="next">Smart Key -
<p>
Next: <a href="#Smart-Key-_002d-Helm-Mode" accesskey="n" rel="next">Smart Key
- Helm Mode</a>, Previous: <a href="#Smart-Key-_002d-Hyperbole-Buttons"
accesskey="p" rel="prev">Smart Key - Hyperbole Buttons</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-View-Mode-1"></span><h4 class="subsection">E.2.12
Smart Key - View Mode</h4>
+<span id="Smart-Key-_002d-View-Mode-1"></span><h4 class="subsection">E.2.14
Smart Key - View Mode</h4>
<span id="index-view-mode"></span>
<div class="format">
@@ -10498,7 +10833,7 @@ Next: <a href="#Smart-Key-_002d-Helm-Mode"
accesskey="n" rel="next">Smart Key -
<p>
Next: <a href="#Smart-Key-_002d-Delimited-Things" accesskey="n"
rel="next">Smart Key - Delimited Things</a>, Previous: <a
href="#Smart-Key-_002d-View-Mode" accesskey="p" rel="prev">Smart Key - View
Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Helm-Mode-1"></span><h4 class="subsection">E.2.13
Smart Key - Helm Mode</h4>
+<span id="Smart-Key-_002d-Helm-Mode-1"></span><h4 class="subsection">E.2.15
Smart Key - Helm Mode</h4>
<p>Because of the way helm is written, you may need a modified version of
helm for these Smart Key actions to work. Try them in your own
@@ -10542,7 +10877,7 @@ version and if there are any issues, install helm from
<p>
Next: <a href="#Smart-Key-_002d-The-Koutliner" accesskey="n" rel="next">Smart
Key - The Koutliner</a>, Previous: <a href="#Smart-Key-_002d-Helm-Mode"
accesskey="p" rel="prev">Smart Key - Helm Mode</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Delimited-Things-1"></span><h4
class="subsection">E.2.14 Smart Key - Delimited Things</h4>
+<span id="Smart-Key-_002d-Delimited-Things-1"></span><h4
class="subsection">E.2.16 Smart Key - Delimited Things</h4>
<span id="index-thing-1"></span>
<span id="index-list-1"></span>
@@ -10578,7 +10913,7 @@ original location and yanks it at the new location.
<p>
Next: <a href="#Smart-Key-_002d-RDB-Mode" accesskey="n" rel="next">Smart Key -
RDB Mode</a>, Previous: <a href="#Smart-Key-_002d-Delimited-Things"
accesskey="p" rel="prev">Smart Key - Delimited Things</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-The-Koutliner-1"></span><h4
class="subsection">E.2.15 Smart Key - The Koutliner</h4>
+<span id="Smart-Key-_002d-The-Koutliner-1"></span><h4
class="subsection">E.2.17 Smart Key - The Koutliner</h4>
<div class="format">
<pre class="format">When pressed within a Hyperbole Koutliner buffer
(kotl-mode):
ACTION KEY
@@ -10611,7 +10946,7 @@ Next: <a href="#Smart-Key-_002d-RDB-Mode" accesskey="n"
rel="next">Smart Key - R
<p>
Next: <a href="#Smart-Key-_002d-Help-Buffers" accesskey="n" rel="next">Smart
Key - Help Buffers</a>, Previous: <a href="#Smart-Key-_002d-The-Koutliner"
accesskey="p" rel="prev">Smart Key - The Koutliner</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-RDB-Mode-1"></span><h4 class="subsection">E.2.16
Smart Key - RDB Mode</h4>
+<span id="Smart-Key-_002d-RDB-Mode-1"></span><h4 class="subsection">E.2.18
Smart Key - RDB Mode</h4>
<span id="index-rdb_002dmode"></span>
<span id="index-database"></span>
<div class="format">
@@ -10640,9 +10975,9 @@ relational databases (part of InfoDock):
<hr>
<span id="Smart-Key-_002d-Help-Buffers"></span><div class="header">
<p>
-Next: <a href="#Smart-Key-_002d-Bookmark-Mode" accesskey="n" rel="next">Smart
Key - Bookmark Mode</a>, Previous: <a href="#Smart-Key-_002d-RDB-Mode"
accesskey="p" rel="prev">Smart Key - RDB Mode</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+Next: <a href="#Smart-Key-_002d-Custom-Mode" accesskey="n" rel="next">Smart
Key - Custom Mode</a>, Previous: <a href="#Smart-Key-_002d-RDB-Mode"
accesskey="p" rel="prev">Smart Key - RDB Mode</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Help-Buffers-1"></span><h4 class="subsection">E.2.17
Smart Key - Help Buffers</h4>
+<span id="Smart-Key-_002d-Help-Buffers-1"></span><h4 class="subsection">E.2.19
Smart Key - Help Buffers</h4>
<span id="index-help-buffer"></span>
<div class="format">
<pre class="format">
@@ -10652,12 +10987,34 @@ When pressed at the end of a Help buffer:
Restores the window configuration prior to the help display.
</pre></div>
+<hr>
+<span id="Smart-Key-_002d-Custom-Mode"></span><div class="header">
+<p>
+Next: <a href="#Smart-Key-_002d-Bookmark-Mode" accesskey="n" rel="next">Smart
Key - Bookmark Mode</a>, Previous: <a href="#Smart-Key-_002d-Help-Buffers"
accesskey="p" rel="prev">Smart Key - Help Buffers</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+</div>
+<span id="Smart-Key-_002d-Custom-Mode-1"></span><h4 class="subsection">E.2.20
Smart Key - Custom Mode</h4>
+
+<span id="index-Custom-mode"></span>
+<p>When pressed within Custom-mode for editing customizations:
+ ACTION KEY
+ (1) on the last line of the buffer, exit Custom mode, potentially
+ prompting to save any changes;
+ (2) at the end of any other line, scroll the window down down a windowful;
+ (3) if a mouse event on a widget, activate the widget or display a menu;
+ (4) anywhere else, execute the command bound to <tt class="key">RET</tt>.
+ ASSIST KEY
+ (1) on the last line of the buffer, exit Custom mode, potentially
+ prompting to save any changes;
+ (2) at the end of any other line, scroll the window down down a windowful;
+ (3) if a mouse event on a widget, activate the widget or display a menu;
+ (4) anywhere else, execute the command bound to <tt class="key">RET</tt>.
+</p>
<hr>
<span id="Smart-Key-_002d-Bookmark-Mode"></span><div class="header">
<p>
-Next: <a href="#Smart-Key-_002d-Pages-Directory-Mode" accesskey="n"
rel="next">Smart Key - Pages Directory Mode</a>, Previous: <a
href="#Smart-Key-_002d-Help-Buffers" accesskey="p" rel="prev">Smart Key - Help
Buffers</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
+Next: <a href="#Smart-Key-_002d-Pages-Directory-Mode" accesskey="n"
rel="next">Smart Key - Pages Directory Mode</a>, Previous: <a
href="#Smart-Key-_002d-Custom-Mode" accesskey="p" rel="prev">Smart Key - Custom
Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Bookmark-Mode-1"></span><h4
class="subsection">E.2.18 Smart Key - Bookmark Mode</h4>
+<span id="Smart-Key-_002d-Bookmark-Mode-1"></span><h4
class="subsection">E.2.21 Smart Key - Bookmark Mode</h4>
<div class="format">
<pre class="format">Bookmark-bmenu-mode lists existing per-user Emacs
bookmarks, which each link to a particular file location.
@@ -10674,7 +11031,7 @@ When pressed on a bookmark-bmenu-mode entry line:
<p>
Next: <a href="#Smart-Key-_002d-Python-Source-Code" accesskey="n"
rel="next">Smart Key - Python Source Code</a>, Previous: <a
href="#Smart-Key-_002d-Bookmark-Mode" accesskey="p" rel="prev">Smart Key -
Bookmark Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Pages-Directory-Mode-1"></span><h4
class="subsection">E.2.19 Smart Key - Pages Directory Mode</h4>
+<span id="Smart-Key-_002d-Pages-Directory-Mode-1"></span><h4
class="subsection">E.2.22 Smart Key - Pages Directory Mode</h4>
<div class="format">
<pre class="format">Pages-directory-mode is used in special buffers that
contain title lines extracted from files consisting of titled, page-delimited
contents, e.g. Info files.
@@ -10691,7 +11048,7 @@ When pressed on a pages-directory-mode entry line:
<p>
Next: <a href="#Smart-Key-_002d-Identifier-Menu-Mode" accesskey="n"
rel="next">Smart Key - Identifier Menu Mode</a>, Previous: <a
href="#Smart-Key-_002d-Pages-Directory-Mode" accesskey="p" rel="prev">Smart Key
- Pages Directory Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Python-Source-Code-1"></span><h4
class="subsection">E.2.20 Smart Key - Python Source Code</h4>
+<span id="Smart-Key-_002d-Python-Source-Code-1"></span><h4
class="subsection">E.2.23 Smart Key - Python Source Code</h4>
<div class="format">
<pre class="format">When the Jedi identifier server or the OO-Browser has been
loaded and the press is
within a Python buffer:
@@ -10720,7 +11077,7 @@ within a Python buffer:
<p>
Next: <a href="#Smart-Key-_002d-C-Source-Code" accesskey="n" rel="next">Smart
Key - C Source Code</a>, Previous: <a
href="#Smart-Key-_002d-Python-Source-Code" accesskey="p" rel="prev">Smart Key -
Python Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Identifier-Menu-Mode-1"></span><h4
class="subsection">E.2.21 Smart Key - Identifier Menu Mode</h4>
+<span id="Smart-Key-_002d-Identifier-Menu-Mode-1"></span><h4
class="subsection">E.2.24 Smart Key - Identifier Menu Mode</h4>
<div class="format">
<pre class="format">This works only for identifiers defined within the same
source file in
@@ -10742,7 +11099,7 @@ When pressed on an identifier name after an identifier
index has been generated:
<p>
Next: <a href="#Smart-Key-_002d-C_002b_002b-Source-Code" accesskey="n"
rel="next">Smart Key - C++ Source Code</a>, Previous: <a
href="#Smart-Key-_002d-Identifier-Menu-Mode" accesskey="p" rel="prev">Smart Key
- Identifier Menu Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-C-Source-Code-1"></span><h4
class="subsection">E.2.22 Smart Key - C Source Code</h4>
+<span id="Smart-Key-_002d-C-Source-Code-1"></span><h4
class="subsection">E.2.25 Smart Key - C Source Code</h4>
<span id="index-smart_002dc_002dcpp_002dinclude_002dpath"></span>
<span id="index-smart_002dc_002dinclude_002dpath"></span>
@@ -10772,7 +11129,7 @@ Next: <a
href="#Smart-Key-_002d-C_002b_002b-Source-Code" accesskey="n" rel="next
<p>
Next: <a href="#Smart-Key-_002d-Assembly-Source-Code" accesskey="n"
rel="next">Smart Key - Assembly Source Code</a>, Previous: <a
href="#Smart-Key-_002d-C-Source-Code" accesskey="p" rel="prev">Smart Key - C
Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-C_002b_002b-Source-Code-1"></span><h4
class="subsection">E.2.23 Smart Key - C++ Source Code</h4>
+<span id="Smart-Key-_002d-C_002b_002b-Source-Code-1"></span><h4
class="subsection">E.2.26 Smart Key - C++ Source Code</h4>
<span id="index-c_002b_002b_002dcpp_002dinclude_002dpath"></span>
<span id="index-c_002b_002b_002dinclude_002dpath"></span>
@@ -10823,7 +11180,7 @@ buffer:
<p>
Next: <a href="#Smart-Key-_002d-Lisp-Source-Code" accesskey="n"
rel="next">Smart Key - Lisp Source Code</a>, Previous: <a
href="#Smart-Key-_002d-C_002b_002b-Source-Code" accesskey="p" rel="prev">Smart
Key - C++ Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Assembly-Source-Code-1"></span><h4
class="subsection">E.2.24 Smart Key - Assembly Source Code</h4>
+<span id="Smart-Key-_002d-Assembly-Source-Code-1"></span><h4
class="subsection">E.2.27 Smart Key - Assembly Source Code</h4>
<span id="index-smart_002dasm_002dinclude_002dpath"></span>
<div class="format">
@@ -10846,7 +11203,7 @@ Next: <a href="#Smart-Key-_002d-Lisp-Source-Code"
accesskey="n" rel="next">Smart
<p>
Next: <a href="#Smart-Key-_002d-Java-Source-Code" accesskey="n"
rel="next">Smart Key - Java Source Code</a>, Previous: <a
href="#Smart-Key-_002d-Assembly-Source-Code" accesskey="p" rel="prev">Smart Key
- Assembly Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Lisp-Source-Code-1"></span><h4
class="subsection">E.2.25 Smart Key - Lisp Source Code</h4>
+<span id="Smart-Key-_002d-Lisp-Source-Code-1"></span><h4
class="subsection">E.2.28 Smart Key - Lisp Source Code</h4>
<div class="format">
<pre class="format"><span id="index-change_002dlog_002dmode"></span><span
id="index-lisp-identifier"></span><span id="index-elisp-identifier"></span>When
pressed on a Lisp symbol within any of these types of buffers
@@ -10867,7 +11224,7 @@ on an Emacs Lisp bound identifier:
<p>
Next: <a href="#Smart-Key-_002d-JavaScript-Source-Code" accesskey="n"
rel="next">Smart Key - JavaScript Source Code</a>, Previous: <a
href="#Smart-Key-_002d-Lisp-Source-Code" accesskey="p" rel="prev">Smart Key -
Lisp Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Java-Source-Code-1"></span><h4
class="subsection">E.2.26 Smart Key - Java Source Code</h4>
+<span id="Smart-Key-_002d-Java-Source-Code-1"></span><h4
class="subsection">E.2.29 Smart Key - Java Source Code</h4>
<span id="index-smart_002djava_002dpackage_002dpath"></span>
<div class="format">
@@ -10908,7 +11265,7 @@ buffer:
<p>
Next: <a href="#Smart-Key-_002d-Objective_002dC-Source-Code" accesskey="n"
rel="next">Smart Key - Objective-C Source Code</a>, Previous: <a
href="#Smart-Key-_002d-Java-Source-Code" accesskey="p" rel="prev">Smart Key -
Java Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-JavaScript-Source-Code-1"></span><h4
class="subsection">E.2.27 Smart Key - JavaScript Source Code</h4>
+<span id="Smart-Key-_002d-JavaScript-Source-Code-1"></span><h4
class="subsection">E.2.30 Smart Key - JavaScript Source Code</h4>
<div class="format">
<pre class="format">When pressed within a JavaScript source code file:
@@ -10927,7 +11284,7 @@ Next: <a
href="#Smart-Key-_002d-Objective_002dC-Source-Code" accesskey="n" rel="
<p>
Next: <a href="#Smart-Key-_002d-Fortran-Source-Code" accesskey="n"
rel="next">Smart Key - Fortran Source Code</a>, Previous: <a
href="#Smart-Key-_002d-JavaScript-Source-Code" accesskey="p" rel="prev">Smart
Key - JavaScript Source Code</a>, Up: <a href="#Smart-Keyboard-Keys"
accesskey="u" rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Objective_002dC-Source-Code-1"></span><h4
class="subsection">E.2.28 Smart Key - Objective-C Source Code</h4>
+<span id="Smart-Key-_002d-Objective_002dC-Source-Code-1"></span><h4
class="subsection">E.2.31 Smart Key - Objective-C Source Code</h4>
<span id="index-objc_002dcpp_002dinclude_002dpath"></span>
<span id="index-objc_002dinclude_002dpath"></span>
@@ -10976,7 +11333,7 @@ OO-Browser):
<p>
Next: <a href="#Smart-Key-_002d-Occurrence-Matches" accesskey="n"
rel="next">Smart Key - Occurrence Matches</a>, Previous: <a
href="#Smart-Key-_002d-Objective_002dC-Source-Code" accesskey="p"
rel="prev">Smart Key - Objective-C Source Code</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Fortran-Source-Code-1"></span><h4
class="subsection">E.2.29 Smart Key - Fortran Source Code</h4>
+<span id="Smart-Key-_002d-Fortran-Source-Code-1"></span><h4
class="subsection">E.2.32 Smart Key - Fortran Source Code</h4>
<div class="format">
<pre class="format">When pressed within a Fortran source code file:
@@ -10992,7 +11349,7 @@ Next: <a href="#Smart-Key-_002d-Occurrence-Matches"
accesskey="n" rel="next">Sma
<p>
Next: <a href="#Smart-Key-_002d-Calendar-Mode" accesskey="n" rel="next">Smart
Key - Calendar Mode</a>, Previous: <a
href="#Smart-Key-_002d-Fortran-Source-Code" accesskey="p" rel="prev">Smart Key
- Fortran Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Occurrence-Matches-1"></span><h4
class="subsection">E.2.30 Smart Key - Occurrence Matches</h4>
+<span id="Smart-Key-_002d-Occurrence-Matches-1"></span><h4
class="subsection">E.2.33 Smart Key - Occurrence Matches</h4>
<div class="format">
<pre class="format">When pressed within an occur-mode, moccur-mode or
amoccur-mode buffer:
@@ -11005,7 +11362,7 @@ Next: <a href="#Smart-Key-_002d-Calendar-Mode"
accesskey="n" rel="next">Smart Ke
<p>
Next: <a href="#Smart-Key-_002d-Man-Page-Apropos" accesskey="n"
rel="next">Smart Key - Man Page Apropos</a>, Previous: <a
href="#Smart-Key-_002d-Occurrence-Matches" accesskey="p" rel="prev">Smart Key -
Occurrence Matches</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Calendar-Mode-1"></span><h4
class="subsection">E.2.31 Smart Key - Calendar Mode</h4>
+<span id="Smart-Key-_002d-Calendar-Mode-1"></span><h4
class="subsection">E.2.34 Smart Key - Calendar Mode</h4>
<div class="format">
<pre class="format">When pressed within a calendar-mode buffer:
@@ -11030,7 +11387,7 @@ Next: <a href="#Smart-Key-_002d-Man-Page-Apropos"
accesskey="n" rel="next">Smart
<p>
Next: <a href="#Smart-Key-_002d-Emacs-Outline-Mode" accesskey="n"
rel="next">Smart Key - Emacs Outline Mode</a>, Previous: <a
href="#Smart-Key-_002d-Calendar-Mode" accesskey="p" rel="prev">Smart Key -
Calendar Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Man-Page-Apropos-1"></span><h4
class="subsection">E.2.32 Smart Key - Man Page Apropos</h4>
+<span id="Smart-Key-_002d-Man-Page-Apropos-1"></span><h4
class="subsection">E.2.35 Smart Key - Man Page Apropos</h4>
<div class="format">
<pre class="format">When pressed within a man page apropos buffer or listing:
ACTION KEY
@@ -11050,7 +11407,7 @@ Next: <a href="#Smart-Key-_002d-Emacs-Outline-Mode"
accesskey="n" rel="next">Sma
<p>
Next: <a href="#Smart-Key-_002d-Info-Manuals" accesskey="n" rel="next">Smart
Key - Info Manuals</a>, Previous: <a href="#Smart-Key-_002d-Man-Page-Apropos"
accesskey="p" rel="prev">Smart Key - Man Page Apropos</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Emacs-Outline-Mode-1"></span><h4
class="subsection">E.2.33 Smart Key - Emacs Outline Mode</h4>
+<span id="Smart-Key-_002d-Emacs-Outline-Mode-1"></span><h4
class="subsection">E.2.36 Smart Key - Emacs Outline Mode</h4>
<span id="index-selective_002ddisplay"></span>
<span id="index-outline_002dmode"></span>
<span id="index-outline_002dminor_002dmode"></span>
@@ -11089,7 +11446,7 @@ and outline-minor-mode is enabled:
<p>
Next: <a href="#Smart-Key-_002d-Email-Readers" accesskey="n" rel="next">Smart
Key - Email Readers</a>, Previous: <a
href="#Smart-Key-_002d-Emacs-Outline-Mode" accesskey="p" rel="prev">Smart Key -
Emacs Outline Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Info-Manuals-1"></span><h4 class="subsection">E.2.34
Smart Key - Info Manuals</h4>
+<span id="Smart-Key-_002d-Info-Manuals-1"></span><h4 class="subsection">E.2.37
Smart Key - Info Manuals</h4>
<div class="format">
<pre class="format"><span id="index-click_002c-Info"></span><span
id="index-Info-browsing"></span><span
id="index-Info_002dglobal_002dnext"></span><span
id="index-Info_002dglobal_002dprev"></span>If pressed within an Info manual
node:
@@ -11128,7 +11485,7 @@ Use <kbd>{s}</kbd> within an Info manual to search for
any concept that interest
<p>
Next: <a href="#Smart-Key-_002d-GNUS-Newsreader" accesskey="n"
rel="next">Smart Key - GNUS Newsreader</a>, Previous: <a
href="#Smart-Key-_002d-Info-Manuals" accesskey="p" rel="prev">Smart Key - Info
Manuals</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Email-Readers-1"></span><h4
class="subsection">E.2.35 Smart Key - Email Readers</h4>
+<span id="Smart-Key-_002d-Email-Readers-1"></span><h4
class="subsection">E.2.38 Smart Key - Email Readers</h4>
<span id="index-hmail_003areader"></span>
<span id="index-hmail_003alister"></span>
<div class="format">
@@ -11165,7 +11522,7 @@ Next: <a href="#Smart-Key-_002d-GNUS-Newsreader"
accesskey="n" rel="next">Smart
<p>
Next: <a href="#Smart-Key-_002d-Buffer-Menus" accesskey="n" rel="next">Smart
Key - Buffer Menus</a>, Previous: <a href="#Smart-Key-_002d-Email-Readers"
accesskey="p" rel="prev">Smart Key - Email Readers</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-GNUS-Newsreader-1"></span><h4
class="subsection">E.2.36 Smart Key - GNUS Newsreader</h4>
+<span id="Smart-Key-_002d-GNUS-Newsreader-1"></span><h4
class="subsection">E.2.39 Smart Key - GNUS Newsreader</h4>
<span id="index-click_002c-Gnus"></span>
<span id="index-Gnus-browsing"></span>
<div class="format">
@@ -11230,7 +11587,7 @@ Next: <a href="#Smart-Key-_002d-Buffer-Menus"
accesskey="n" rel="next">Smart Key
<p>
Next: <a href="#Smart-Key-_002d-Tar-File-Mode" accesskey="n" rel="next">Smart
Key - Tar File Mode</a>, Previous: <a href="#Smart-Key-_002d-GNUS-Newsreader"
accesskey="p" rel="prev">Smart Key - GNUS Newsreader</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Buffer-Menus-1"></span><h4 class="subsection">E.2.37
Smart Key - Buffer Menus</h4>
+<span id="Smart-Key-_002d-Buffer-Menus-1"></span><h4 class="subsection">E.2.40
Smart Key - Buffer Menus</h4>
<span id="index-click_002c-buffer-menu"></span>
<span id="index-buffer-menu-2"></span>
<div class="format">
@@ -11285,7 +11642,7 @@ Next: <a href="#Smart-Key-_002d-Tar-File-Mode"
accesskey="n" rel="next">Smart Ke
<p>
Next: <a href="#Smart-Key-_002d-Man-Pages" accesskey="n" rel="next">Smart Key
- Man Pages</a>, Previous: <a href="#Smart-Key-_002d-Buffer-Menus"
accesskey="p" rel="prev">Smart Key - Buffer Menus</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Tar-File-Mode-1"></span><h4
class="subsection">E.2.38 Smart Key - Tar File Mode</h4>
+<span id="Smart-Key-_002d-Tar-File-Mode-1"></span><h4
class="subsection">E.2.41 Smart Key - Tar File Mode</h4>
<span id="index-click_002c-tar"></span>
<span id="index-tar-archive-browsing"></span>
<span id="index-extracting-from-tar-files"></span>
@@ -11310,7 +11667,7 @@ Next: <a href="#Smart-Key-_002d-Man-Pages"
accesskey="n" rel="next">Smart Key -
<p>
Next: <a href="#Smart-Key-_002d-WWW-URLs" accesskey="n" rel="next">Smart Key -
WWW URLs</a>, Previous: <a href="#Smart-Key-_002d-Tar-File-Mode" accesskey="p"
rel="prev">Smart Key - Tar File Mode</a>, Up: <a href="#Smart-Keyboard-Keys"
accesskey="u" rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Man-Pages-1"></span><h4 class="subsection">E.2.39
Smart Key - Man Pages</h4>
+<span id="Smart-Key-_002d-Man-Pages-1"></span><h4 class="subsection">E.2.42
Smart Key - Man Pages</h4>
<span id="index-man-page-references"></span>
<span id="index-smart_002dman_002dc_002droutine_002dref"></span>
<div class="format">
@@ -11328,7 +11685,7 @@ containing its pathname:
<p>
Next: <a href="#Smart-Key-_002d-HyRolo-Match-Buffers" accesskey="n"
rel="next">Smart Key - HyRolo Match Buffers</a>, Previous: <a
href="#Smart-Key-_002d-Man-Pages" accesskey="p" rel="prev">Smart Key - Man
Pages</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-WWW-URLs-1"></span><h4 class="subsection">E.2.40
Smart Key - WWW URLs</h4>
+<span id="Smart-Key-_002d-WWW-URLs-1"></span><h4 class="subsection">E.2.43
Smart Key - WWW URLs</h4>
<span id="index-click_002c-world_002dwide-web"></span>
<span id="index-W3"></span>
<span id="index-URL-2"></span>
@@ -11352,7 +11709,7 @@ Next: <a href="#Smart-Key-_002d-HyRolo-Match-Buffers"
accesskey="n" rel="next">S
<p>
Next: <a href="#Smart-Key-_002d-Image-Thumbnails" accesskey="n"
rel="next">Smart Key - Image Thumbnails</a>, Previous: <a
href="#Smart-Key-_002d-WWW-URLs" accesskey="p" rel="prev">Smart Key - WWW
URLs</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-HyRolo-Match-Buffers-1"></span><h4
class="subsection">E.2.41 Smart Key - HyRolo Match Buffers</h4>
+<span id="Smart-Key-_002d-HyRolo-Match-Buffers-1"></span><h4
class="subsection">E.2.44 Smart Key - HyRolo Match Buffers</h4>
<span id="index-click_002c-hyrolo-matches"></span>
<span id="index-hyrolo-matches"></span>
<div class="format">
@@ -11366,7 +11723,7 @@ Next: <a href="#Smart-Key-_002d-Image-Thumbnails"
accesskey="n" rel="next">Smart
<p>
Next: <a href="#Smart-Key-_002d-Gomoku-Game" accesskey="n" rel="next">Smart
Key - Gomoku Game</a>, Previous: <a
href="#Smart-Key-_002d-HyRolo-Match-Buffers" accesskey="p" rel="prev">Smart Key
- HyRolo Match Buffers</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Image-Thumbnails-1"></span><h4
class="subsection">E.2.42 Smart Key - Image Thumbnails</h4>
+<span id="Smart-Key-_002d-Image-Thumbnails-1"></span><h4
class="subsection">E.2.45 Smart Key - Image Thumbnails</h4>
<span id="index-images"></span>
<span id="index-thumbnails"></span>
<span id="index-dired_002c-images"></span>
@@ -11385,7 +11742,7 @@ Next: <a href="#Smart-Key-_002d-Gomoku-Game"
accesskey="n" rel="next">Smart Key
<p>
Next: <a href="#Smart-Key-_002d-Magit-Mode" accesskey="n" rel="next">Smart Key
- Magit Mode</a>, Previous: <a href="#Smart-Key-_002d-Image-Thumbnails"
accesskey="p" rel="prev">Smart Key - Image Thumbnails</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Gomoku-Game-1"></span><h4 class="subsection">E.2.43
Smart Key - Gomoku Game</h4>
+<span id="Smart-Key-_002d-Gomoku-Game-1"></span><h4 class="subsection">E.2.46
Smart Key - Gomoku Game</h4>
<span id="index-game_002c-gomoku"></span>
<span id="index-gomoku"></span>
<div class="format">
@@ -11401,7 +11758,7 @@ Next: <a href="#Smart-Key-_002d-Magit-Mode"
accesskey="n" rel="next">Smart Key -
<p>
Next: <a href="#Smart-Key-_002d-The-OO_002dBrowser" accesskey="n"
rel="next">Smart Key - The OO-Browser</a>, Previous: <a
href="#Smart-Key-_002d-Gomoku-Game" accesskey="p" rel="prev">Smart Key - Gomoku
Game</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart
Keyboard Keys</a> [<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Magit-Mode-1"></span><h4 class="subsection">E.2.44
Smart Key - Magit Mode</h4>
+<span id="Smart-Key-_002d-Magit-Mode-1"></span><h4 class="subsection">E.2.47
Smart Key - Magit Mode</h4>
<span id="index-git"></span>
<span id="index-magit"></span>
<span id="index-version-control-4"></span>
@@ -11429,7 +11786,7 @@ Next: <a href="#Smart-Key-_002d-The-OO_002dBrowser"
accesskey="n" rel="next">Sma
<p>
Next: <a href="#Smart-Key-_002d-Todotxt-Mode" accesskey="n" rel="next">Smart
Key - Todotxt Mode</a>, Previous: <a href="#Smart-Key-_002d-Magit-Mode"
accesskey="p" rel="prev">Smart Key - Magit Mode</a>, Up: <a
href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a>
[<a href="#SEC_Contents" title="Table of contents"
rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-The-OO_002dBrowser-1"></span><h4
class="subsection">E.2.45 Smart Key - The OO-Browser</h4>
+<span id="Smart-Key-_002d-The-OO_002dBrowser-1"></span><h4
class="subsection">E.2.48 Smart Key - The OO-Browser</h4>
<span id="index-OO_002dBrowser"></span>
<span id="index-object_002doriented-code-browsing"></span>
@@ -11502,7 +11859,7 @@ buffer after an OO-Browser Environment has been loaded:
<p>
Next: <a href="#Smart-Key-_002d-Default-Context" accesskey="n"
rel="next">Smart Key - Default Context</a>, Previous: <a
href="#Smart-Key-_002d-The-OO_002dBrowser" accesskey="p" rel="prev">Smart Key -
The OO-Browser</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u"
rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents" title="Table
of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Todotext-Mode"></span><h4 class="subsection">E.2.46
Smart Key - Todotext Mode</h4>
+<span id="Smart-Key-_002d-Todotext-Mode"></span><h4 class="subsection">E.2.49
Smart Key - Todotext Mode</h4>
<span id="index-todotxt_002dmode"></span>
<p>todotxt-mode is an add-on package for editing todo.txt files using
@@ -11524,7 +11881,7 @@ the todotxt-format. For the file format see
http://todotxt.org/.
<p>
Previous: <a href="#Smart-Key-_002d-Todotxt-Mode" accesskey="p"
rel="prev">Smart Key - Todotxt Mode</a>, Up: <a href="#Smart-Keyboard-Keys"
accesskey="u" rel="up">Smart Keyboard Keys</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
</div>
-<span id="Smart-Key-_002d-Default-Context-1"></span><h4
class="subsection">E.2.47 Smart Key - Default Context</h4>
+<span id="Smart-Key-_002d-Default-Context-1"></span><h4
class="subsection">E.2.50 Smart Key - Default Context</h4>
<span id="index-action_002dkey_002ddefault_002dfunction-1"></span>
<span id="index-assist_002dkey_002ddefault_002dfunction-1"></span>
<span id="index-hyperbole-1"></span>
@@ -11640,7 +11997,7 @@ let it flow through you.
<p>Ok, joking aside, now that we have your attention, here are some
serious questions and answers.
</p>
-</li><li> <span id="index-Org_002dmode-1"></span>
+</li><li> <span id="index-Org_002dmode"></span>
Isn’t Org-mode the same as Hyperbole?
<p>No, they offer very different capabilities when you compare them a bit
@@ -11654,7 +12011,7 @@ Hyperbole does. For a list of some differences, see:
agenda and diary management, so it is very complementary to Hyperbole.
It did not exist when Hyperbole was first developed.
</p>
-<span id="index-hsys_002dorg_002denable_002dsmart_002dkeys-1"></span>
+<span id="index-hsys_002dorg_002denable_002dsmart_002dkeys-2"></span>
<p>Smart Key support for Org-mode is already in Hyperbole. Use the
<code>hsys-org-enable-smart-keys</code> customization variable to control
the Smart Keys and <kbd>{M-<span class="key">RET</span>}</kbd> when in
Org-mode with
@@ -12180,17 +12537,18 @@ Next: <a href="#Function" accesskey="n"
rel="next">Function</a>, Previous: <a hr
<tr><td></td><td valign="top"><a
href="#index-C_002dg"><code>C-g</code></a>:</td><td> </td><td
valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-A"><code>C-h
A</code></a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-A-1"><code>C-h
A</code></a>:</td><td> </td><td valign="top"><a
href="#Default-Hyperbole-Bindings">Default Hyperbole Bindings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-C_002dh-h"><code>C-h
h</code></a>:</td><td> </td><td valign="top"><a href="#Smart-Keys">Smart
Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-C_002dh-h"><code>C-h
h</code></a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-1"><code>C-h
h</code></a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-2"><code>C-h
h</code></a>:</td><td> </td><td valign="top"><a
href="#Default-Hyperbole-Bindings">Default Hyperbole Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-a"><code>C-h h c
a</code></a>:</td><td> </td><td valign="top"><a
href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-d"><code>C-h h c
d</code></a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-o"><code>C-h h c
o</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-r"><code>C-h h c
r</code></a>:</td><td> </td><td valign="top"><a
href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-u"><code>C-h h c
u</code></a>:</td><td> </td><td valign="top"><a
href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-u-1"><code>C-h h c
u</code></a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-w"><code>C-h h c
w</code></a>:</td><td> </td><td valign="top"><a
href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-d-d"><code>C-h h d
d</code></a>:</td><td> </td><td valign="top"><a
href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-C_002dh-h-d-i"><code>C-h h d
i</code></a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-C_002dh-h-d-i"><code>C-h h d
i</code></a>:</td><td> </td><td valign="top"><a
href="#Documentation">Documentation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-f-w"><code>C-h h f
w</code></a>:</td><td> </td><td valign="top"><a
href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-f-w-1"><code>C-h h f
w</code></a>:</td><td> </td><td valign="top"><a
href="#Default-Hyperbole-Bindings">Default Hyperbole Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-g"><code>C-h h
g</code></a>:</td><td> </td><td valign="top"><a
href="#Global-Buttons">Global Buttons</a></td></tr>
@@ -12295,6 +12653,8 @@ Next: <a href="#Function" accesskey="n"
rel="next">Function</a>, Previous: <a hr
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Key-Index_ky_letter-M">M</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-m"><code>m</code></a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-M_002d0-M_002dTAB"><code>M-0
M-<span class="key">TAB</span></code></a>:</td><td> </td><td
valign="top"><a href="#Relocating-and-Copying">Relocating and
Copying</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-M_002d0-TAB"><code>M-0 <span
class="key">TAB</span></code></a>:</td><td> </td><td valign="top"><a
href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-M_002db"><code>M-b</code></a>:</td><td> </td><td
valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-M_002df"><code>M-f</code></a>:</td><td> </td><td
valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-M_002do"><code>M-o</code></a>:</td><td> </td><td
valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
@@ -12323,7 +12683,7 @@ Next: <a href="#Function" accesskey="n"
rel="next">Function</a>, Previous: <a hr
<tr><td></td><td valign="top"><a
href="#index-p-1"><code>p</code></a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Key-Index_ky_letter-Q">Q</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-q"><code>q</code></a>:</td><td> </td><td valign="top"><a
href="#Smart-Keys">Smart Keys</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-q"><code>q</code></a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-q-1"><code>q</code></a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Q"><code>Q</code></a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-q-2"><code>q</code></a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
@@ -12433,7 +12793,7 @@ Next: <a href="#Function" accesskey="n"
rel="next">Function</a>, Previous: <a hr
<tr><td></td><td valign="top"><a
href="#index-W"><code>W</code></a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Key-Index_ky_letter-X">X</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-X"><code>X</code></a>:</td><td> </td><td valign="top"><a
href="#Smart-Keys">Smart Keys</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-X"><code>X</code></a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Key-Index_ky_letter-Z">Z</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Z"><code>Z</code></a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
@@ -12663,7 +13023,7 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-eval_002dlast_002dsexp"><code>eval-last-sexp</code></a>:</td><td> </td><td
valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Function_fn_letter-F">F</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs">file,
.emacs</a>:</td><td> </td><td valign="top"><a href="#Smart-Keys">Smart
Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs">file,
.emacs</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs-1">file,
.emacs</a>:</td><td> </td><td valign="top"><a
href="#Renaming">Renaming</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs-2">file,
.emacs</a>:</td><td> </td><td valign="top"><a
href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs-3">file,
.emacs</a>:</td><td> </td><td valign="top"><a
href="#Autonumbering">Autonumbering</a></td></tr>
@@ -12686,6 +13046,7 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-file_002c-hmouse_002dsh_002eel">file,
hmouse-sh.el</a>:</td><td> </td><td valign="top"><a
href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-file_002c-hsettings_002eel">file,
hsettings.el</a>:</td><td> </td><td valign="top"><a
href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hsys_002d_002a">file,
hsys-*</a>:</td><td> </td><td valign="top"><a
href="#Encapsulating-Systems">Encapsulating Systems</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-file_002c-hsys_002dorg_002eel">file,
hsys-org.el</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-file_002c-hui_002dep_002a_002eel">file,
hui-ep*.el</a>:</td><td> </td><td valign="top"><a
href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-file_002c-hui_002dwindow_002eel">file,
hui-window.el</a>:</td><td> </td><td valign="top"><a
href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-HYPB">file,
HYPB</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
@@ -12693,10 +13054,10 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-file_002c-hyperbole_002eel-1">file,
hyperbole.el</a>:</td><td> </td><td valign="top"><a
href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-file_002c-hyperbole_002eel-2">file,
hyperbole.el</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-file_002c-hywconfig_002eel">file,
hywconfig.el</a>:</td><td> </td><td valign="top"><a
href="#Window-Configurations">Window Configurations</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-file_002c-man_002fhyperbole_002ehtml">file,
man/hyperbole.html</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-file_002c-man_002fhyperbole_002einfo">file,
man/hyperbole.info</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-file_002c-man_002fhyperbole_002epdf">file,
man/hyperbole.pdf</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-file_002c-man_002fhyperbole_002etexi">file,
man/hyperbole.texi</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-file_002c-man_002fhyperbole_002ehtml">file,
man/hyperbole.html</a>:</td><td> </td><td valign="top"><a
href="#Documentation">Documentation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-file_002c-man_002fhyperbole_002einfo">file,
man/hyperbole.info</a>:</td><td> </td><td valign="top"><a
href="#Documentation">Documentation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-file_002c-man_002fhyperbole_002epdf">file,
man/hyperbole.pdf</a>:</td><td> </td><td valign="top"><a
href="#Documentation">Documentation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-file_002c-man_002fhyperbole_002etexi">file,
man/hyperbole.texi</a>:</td><td> </td><td valign="top"><a
href="#Documentation">Documentation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-MANIFEST">file,
MANIFEST</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-fill_002dcolumn">fill-column</a>:</td><td> </td><td
valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-fill_002dprefix">fill-prefix</a>:</td><td> </td><td
valign="top"><a href="#Button-Label-Normalization">Button Label
Normalization</a></td></tr>
@@ -12704,6 +13065,7 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-find_002dfile_002dhook">find-file-hook</a>:</td><td> </td><td
valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Function_fn_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-gbut_003aebut_002dprogram"><code>gbut:ebut-program</code></a>:</td><td> </td><td
valign="top"><a href="#Programmatic-Button-Creation">Programmatic Button
Creation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-gbut_003afile">gbut:file</a>:</td><td> </td><td
valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Function_fn_letter-H">H</th><td></td><td></td></tr>
@@ -12769,10 +13131,13 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-hpath_003avariables">hpath:variables</a>:</td><td> </td><td
valign="top"><a href="#Link-Variable-Substitution">Link Variable
Substitution</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hproperty_003abut_002dcreate"><code>hproperty:but-create</code></a>:</td><td> </td><td
valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hproperty_003abut_002demphasize_002dflag">hproperty:but-emphasize-flag</a>:</td><td> </td><td
valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hproperty_003abut_002dflash_002dtime_002dseconds">hproperty:but-flash-time-seconds</a>:</td><td> </td><td
valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hproperty_003abut_002dhighlight_002dflag">hproperty:but-highlight-flag</a>:</td><td> </td><td
valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hproperty_003acycle_002dbut_002dcolor"><code>hproperty:cycle-but-color</code></a>:</td><td> </td><td
valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hsys_002dorg_002denable_002dsmart_002dkeys">hsys-org-enable-smart-keys</a>:</td><td> </td><td
valign="top"><a href="#Implicit-Button-Types">Implicit Button
Types</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-hsys_002dorg_002denable_002dsmart_002dkeys-1">hsys-org-enable-smart-keys</a>:</td><td> </td><td
valign="top"><a href="#Questions-and-Answers">Questions and
Answers</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hsys_002dorg_002denable_002dsmart_002dkeys-1">hsys-org-enable-smart-keys</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Org-Mode">Smart Key - Org
Mode</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hsys_002dorg_002denable_002dsmart_002dkeys-2">hsys-org-enable-smart-keys</a>:</td><td> </td><td
valign="top"><a href="#Questions-and-Answers">Questions and
Answers</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hsys_002dorg_002dmode_002dp"><code>hsys-org-mode-p</code></a>:</td><td> </td><td
valign="top"><a href="#Implicit-Button-Types">Implicit Button
Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-htype_002dcreate_002dhook">htype-create-hook</a>:</td><td> </td><td
valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-htype_002ddelete_002dhook">htype-delete-hook</a>:</td><td> </td><td
valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hui_002dmenu_002dscreen_002dcommands"><code>hui-menu-screen-commands</code></a>:</td><td> </td><td
valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key
Modeline Clicks</a></td></tr>
@@ -12795,12 +13160,16 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-hycontrol_002dscreen_002doffset_002dalist">hycontrol-screen-offset-alist</a>:</td><td> </td><td
valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hycontrol_002dset_002dscreen_002doffsets"><code>hycontrol-set-screen-offsets</code></a>:</td><td> </td><td
valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hypb_003argrep_002dcommand">hypb:rgrep-command</a>:</td><td> </td><td
valign="top"><a href="#Menus">Menus</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-hyperb_003adir">hyperb:dir</a>:</td><td> </td><td
valign="top"><a href="#Invocation">Invocation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hyperb_003adir">hyperb:dir</a>:</td><td> </td><td
valign="top"><a href="#Documentation">Documentation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hyperbole"><code>hyperbole</code></a>:</td><td> </td><td
valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hyperbole-1"><code>hyperbole</code></a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Default-Context">Smart Key - Default
Context</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dinit_002dhook">hyperbole-init-hook</a>:</td><td> </td><td
valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dinit_002dhook">hyperbole-init-hook</a>:</td><td> </td><td
valign="top"><a href="#Hyperbole-Hooks">Hyperbole Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dinit_002dhook-1">hyperbole-init-hook</a>:</td><td> </td><td
valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dmode-1"><code>hyperbole-mode</code></a>:</td><td> </td><td
valign="top"><a href="#Default-Hyperbole-Bindings">Default Hyperbole
Bindings</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dmode_002dhook">hyperbole-mode-hook</a>:</td><td> </td><td
valign="top"><a href="#Hyperbole-Hooks">Hyperbole Hooks</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dmode_002dmap">hyperbole-mode-map</a>:</td><td> </td><td
valign="top"><a href="#Default-Hyperbole-Bindings">Default Hyperbole
Bindings</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dmode_002doff_002dhook">hyperbole-mode-off-hook</a>:</td><td> </td><td
valign="top"><a href="#Hyperbole-Hooks">Hyperbole Hooks</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dmode_002don_002dhook">hyperbole-mode-on-hook</a>:</td><td> </td><td
valign="top"><a href="#Hyperbole-Hooks">Hyperbole Hooks</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dpopup_002dmenu"><code>hyperbole-popup-menu</code></a>:</td><td> </td><td
valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dpopup_002dmenu-1"><code>hyperbole-popup-menu</code></a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Default-Context">Smart Key - Default
Context</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dset_002dkey"><code>hyperbole-set-key</code></a>:</td><td> </td><td
valign="top"><a href="#Binding-Minibuffer-Menu-Items">Binding Minibuffer Menu
Items</a></td></tr>
@@ -12871,6 +13240,8 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-ibtypes-grep_002dmsg"><code>ibtypes
grep-msg</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-ibtypes-hyp_002daddress"><code>ibtypes
hyp-address</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-ibtypes-hyp_002dsource"><code>ibtypes
hyp-source</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-ibtypes-hyperbole_002drun_002dtest"><code>ibtypes
hyperbole-run-test</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-ibtypes-hyperbole_002drun_002dtests"><code>ibtypes
hyperbole-run-tests</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-ibtypes-id_002dcflow"><code>ibtypes
id-cflow</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-ilink"><code>ibtypes
ilink</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-ibtypes-Info_002dnode"><code>ibtypes
Info-node</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
@@ -12893,7 +13264,7 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-ibtypes-www_002durl"><code>ibtypes
www-url</code></a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-ibut_003aat_002dp"><code>ibut:at-p</code></a>:</td><td> </td><td
valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic
Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-image_002ddired_002dexternal_002dviewer">image-dired-external-viewer</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image
Thumbnails</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-Info_002ddirectory_002dlist">Info-directory-list</a>:</td><td> </td><td
valign="top"><a href="#Invocation">Invocation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-Info_002ddirectory_002dlist">Info-directory-list</a>:</td><td> </td><td
valign="top"><a href="#Documentation">Documentation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Info_002dglobal_002dnext"><code>Info-global-next</code></a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info
Manuals</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Info_002dglobal_002dprev"><code>Info-global-prev</code></a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info
Manuals</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-interactive"><code>interactive</code></a>:</td><td> </td><td
valign="top"><a href="#Creating-Action-Types">Creating Action
Types</a></td></tr>
@@ -13040,6 +13411,7 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-objc_002dcpp_002dinclude_002dpath">objc-cpp-include-path</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Objective_002dC-Source-Code">Smart Key
- Objective-C Source Code</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-objc_002dinclude_002dpath">objc-include-path</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Objective_002dC-Source-Code">Smart Key
- Objective-C Source Code</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-org_002dctrl_002dc_002dctrl_002dc"><code>org-ctrl-c-ctrl-c</code></a>:</td><td> </td><td
valign="top"><a href="#Implicit-Button-Types">Implicit Button
Types</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-org_002dlink_002doutside_002dorg_002dmode">org-link-outside-org-mode</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Org-Mode">Smart Key - Org
Mode</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-org_002dmeta_002dreturn"><code>org-meta-return</code></a>:</td><td> </td><td
valign="top"><a href="#Implicit-Button-Types">Implicit Button
Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-outline_002dminor_002dmode-1"><code>outline-minor-mode</code></a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs
Outline Mode</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-outline_002dmode-1"><code>outline-mode</code></a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs
Outline Mode</a></td></tr>
@@ -13281,6 +13653,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-button-file_002c-HYPB">button
file, HYPB</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-button-file_002c-personal">button file,
personal</a>:</td><td> </td><td valign="top"><a
href="#Button-Files">Button Files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-files">button
files</a>:</td><td> </td><td valign="top"><a href="#Button-Files">Button
Files</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-button-flash-time">button flash
time</a>:</td><td> </td><td valign="top"><a href="#Button-Colors">Button
Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-flashing">button
flashing</a>:</td><td> </td><td valign="top"><a
href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-help">button
help</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-help-1">button
help</a>:</td><td> </td><td valign="top"><a
href="#Searching-and-Summarizing">Searching and Summarizing</a></td></tr>
@@ -13346,7 +13719,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-cell_002c-top_002dlevel-1">cell,
top-level</a>:</td><td> </td><td valign="top"><a
href="#Idstamps">Idstamps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-transposing">cell,
transposing</a>:</td><td> </td><td valign="top"><a
href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-cell_002c-yanking-contents">cell, yanking
contents</a>:</td><td> </td><td valign="top"><a
href="#Adding-and-Killing">Adding and Killing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-change-key-bindings">change key
bindings</a>:</td><td> </td><td valign="top"><a href="#Smart-Keys">Smart
Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-change-key-bindings">change key
bindings</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-change_002dlog_002dmode">change-log-mode</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Lisp-Source-Code">Smart Key - Lisp
Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-changing-the-view-spec">changing
the view spec</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-buffer-menu">click,
buffer menu</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Buffer-Menus">Smart Key - Buffer Menus</a></td></tr>
@@ -13368,6 +13741,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-collaboration">collaboration</a>:</td><td> </td><td
valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-collapse-lines">collapse
lines</a>:</td><td> </td><td valign="top"><a href="#View-Specs">View
Specs</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-collapsing">collapsing</a>:</td><td> </td><td valign="top"><a
href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-colon_002dseparated-paths">colon-separated
paths</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-comment">comment</a>:</td><td> </td><td valign="top"><a
href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-comment-1">comment</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited
Things</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-company_002dmode">company-mode</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Company-Mode">Smart Key - Company
Mode</a></td></tr>
@@ -13378,6 +13752,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-completion-2">completion</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Company-Mode">Smart Key - Company
Mode</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-completion-3">completion</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Argument-Completion">Smart Key -
Argument Completion</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-completion-4">completion</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Helm-Mode">Smart Key - Helm
Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-completion_002c-Ivy">completion,
Ivy</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Ivy">Smart Key - Ivy</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-configuration">configuration</a>:</td><td> </td><td
valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-contacts_002c-Google">contacts,
Google</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-context">context</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
@@ -13398,6 +13773,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-cross_002dreference_002c-Texinfo">cross-reference,
Texinfo</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Cscope">Cscope</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ctags-entry">ctags
entry</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Custom-mode">Custom
mode</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Custom-Mode">Smart Key - Custom Mode</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-customization">customization</a>:</td><td> </td><td
valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-customization-1">customization</a>:</td><td> </td><td
valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-customize">customize</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
@@ -13432,7 +13808,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-dired-item-drag">dired item
drag</a>:</td><td> </td><td valign="top"><a
href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer
Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dired_002c-images">dired,
images</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image
Thumbnails</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-dired_002dsidebar_002dmode">dired-sidebar-mode</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Dired-Sidebar-Mode">Smart Key - Dired
Sidebar Mode</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-disable-Hyperbole">disable
Hyperbole</a>:</td><td> </td><td valign="top"><a href="#Smart-Keys">Smart
Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-disable-Hyperbole">disable
Hyperbole</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-disable-hyperbole-key-bindings">disable hyperbole key
bindings</a>:</td><td> </td><td valign="top"><a
href="#Default-Hyperbole-Bindings">Default Hyperbole Bindings</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-disable-org_002dmode-support">disable org-mode
support</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-display">display</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
@@ -13480,6 +13856,8 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-elink">elink</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-elisp-identifier">elisp
identifier</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Lisp-Source-Code">Smart Key - Lisp Source
Code</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-ellipses">ellipses</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-elpa-package">elpa
package</a>:</td><td> </td><td valign="top"><a
href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-elpa_002ddevel-package">elpa-devel
package</a>:</td><td> </td><td valign="top"><a
href="#Elpa-In_002dDevelopment-Package-Installation">Elpa In-Development
Package Installation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Emacs">Emacs</a>:</td><td> </td><td valign="top"><a
href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Emacs-1">Emacs</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-Lisp">Emacs
Lisp</a>:</td><td> </td><td valign="top"><a
href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
@@ -13487,7 +13865,8 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-Emacs-Lisp-variables">Emacs Lisp
variables</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-Lisp-variables-1">Emacs
Lisp variables</a>:</td><td> </td><td valign="top"><a
href="#Link-Variable-Substitution">Link Variable Substitution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-emacs-outline">emacs
outline</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Emacs-package-manager">Emacs
package manager</a>:</td><td> </td><td valign="top"><a
href="#Stable-Package-Installation">Stable Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Emacs-package-manager">Emacs
package manager</a>:</td><td> </td><td valign="top"><a
href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-Emacs-Regression-Test-framework">Emacs Regression Test
framework</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-support">Emacs
support</a>:</td><td> </td><td valign="top"><a
href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-emulation_002c-drag">emulation,
drag</a>:</td><td> </td><td valign="top"><a
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-enable-org_002dmode-support">enable org-mode
support</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
@@ -13498,6 +13877,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-environment-variables">environment
variables</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-environment-variables-1">environment
variables</a>:</td><td> </td><td valign="top"><a
href="#Link-Variable-Substitution">Link Variable Substitution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-equalize-windows">equalize
windows</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-ert">ert</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-etags-entry">etags
entry</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exchanging-cells">exchanging
cells</a>:</td><td> </td><td valign="top"><a
href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exit-HyControl">exit
HyControl</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
@@ -13628,7 +14008,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-Hyperbole-mail-comment">Hyperbole mail
comment</a>:</td><td> </td><td valign="top"><a
href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-mail-list">Hyperbole
mail list</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-main-menu">Hyperbole
main menu</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Hyperbole-manual">Hyperbole
manual</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Hyperbole-manual">Hyperbole
manual</a>:</td><td> </td><td valign="top"><a
href="#Documentation">Documentation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Hyperbole-menubar-menu">Hyperbole menubar
menu</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole-popup-menu">hyperbole
popup menu</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Hyperbole-pulldown-menu">Hyperbole pulldown
menu</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
@@ -13637,10 +14017,10 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-Hyperbole-version">Hyperbole
version</a>:</td><td> </td><td valign="top"><a
href="#Suggestion-or-Bug-Reporting">Suggestion or Bug Reporting</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Hyperbole_002c-embedding">Hyperbole,
embedding</a>:</td><td> </td><td valign="top"><a
href="#Embedding-Hyperbole">Embedding Hyperbole</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Hyperbole_002c-obtaining">Hyperbole,
obtaining</a>:</td><td> </td><td valign="top"><a
href="#Top">Top</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-Hyperbole_002c-obtaining-1">Hyperbole,
obtaining</a>:</td><td> </td><td valign="top"><a
href="#Stable-Package-Installation">Stable Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-Hyperbole_002c-obtaining-1">Hyperbole,
obtaining</a>:</td><td> </td><td valign="top"><a
href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Hyperbole_002c-starting">Hyperbole,
starting</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Hyperbole_002c-system-encapsulation">Hyperbole, system
encapsulation</a>:</td><td> </td><td valign="top"><a
href="#Encapsulating-Systems">Encapsulating Systems</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dmode">hyperbole-mode</a>:</td><td> </td><td
valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hyperbole_002dmode">hyperbole-mode</a>:</td><td> </td><td
valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hyperlink">hyperlink</a>:</td><td> </td><td valign="top"><a
href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperlink-anchor">hyperlink
anchor</a>:</td><td> </td><td valign="top"><a
href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hypertext">hypertext</a>:</td><td> </td><td valign="top"><a
href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
@@ -13682,10 +14062,11 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-implicit-button-types">implicit
button types</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-importing">importing</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-importing-a-file">importing a
file</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-in_002ddevelopment-installation">in-development
installation</a>:</td><td> </td><td valign="top"><a
href="#Elpa-In_002dDevelopment-Package-Installation">Elpa In-Development
Package Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inactive-minibuffer">inactive
minibuffer</a>:</td><td> </td><td valign="top"><a
href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info-browser">Info
browser</a>:</td><td> </td><td valign="top"><a
href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline
Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info-browsing">Info
browsing</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info Manuals</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Info-manual">Info
manual</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Info-manual">Info
manual</a>:</td><td> </td><td valign="top"><a
href="#Documentation">Documentation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info-node">Info
node</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-InfoDock">InfoDock</a>:</td><td> </td><td valign="top"><a
href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-inhibit-org_002dmode-support">inhibit org-mode
support</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
@@ -13693,10 +14074,12 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-insert-item">insert
item</a>:</td><td> </td><td valign="top"><a
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inserting-tabs">inserting
tabs</a>:</td><td> </td><td valign="top"><a
href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-insertion">insertion</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-installation">installation</a>:</td><td> </td><td
valign="top"><a href="#Stable-Package-Installation">Stable Package
Installation</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-installation_002c-from-git">installation, from
git</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-installation_002c-pre_002drelease">installation,
pre-release</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-installation_002c-stable">installation,
stable</a>:</td><td> </td><td valign="top"><a
href="#Stable-Package-Installation">Stable Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-installation">installation</a>:</td><td> </td><td
valign="top"><a href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-installation_002c-from-git">installation, from
git</a>:</td><td> </td><td valign="top"><a
href="#Elpa-In_002dDevelopment-Package-Installation">Elpa In-Development
Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-installation_002c-from-git-1">installation, from
git</a>:</td><td> </td><td valign="top"><a
href="#Git-In_002dDevelopment-Package-Installation">Git In-Development Package
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-installation_002c-pre_002drelease">installation,
pre-release</a>:</td><td> </td><td valign="top"><a
href="#Elpa-In_002dDevelopment-Package-Installation">Elpa In-Development
Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-installation_002c-pre_002drelease-1">installation,
pre-release</a>:</td><td> </td><td valign="top"><a
href="#Git-In_002dDevelopment-Package-Installation">Git In-Development Package
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-installation_002c-stable">installation,
stable</a>:</td><td> </td><td valign="top"><a
href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-instance-number">instance
number</a>:</td><td> </td><td valign="top"><a href="#By-Menu">By
Menu</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-interactive-cmd-char_002c-_002bI">interactive cmd char,
+I</a>:</td><td> </td><td valign="top"><a
href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-interactive-cmd-char_002c-_002bK">interactive cmd char,
+K</a>:</td><td> </td><td valign="top"><a
href="#Creating-Action-Types">Creating Action Types</a></td></tr>
@@ -13722,6 +14105,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-item-drag">item
drag</a>:</td><td> </td><td valign="top"><a
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-item-insert">item
insert</a>:</td><td> </td><td valign="top"><a
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-item-throw">item
throw</a>:</td><td> </td><td valign="top"><a
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Ivy-completion">Ivy
completion</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Ivy">Smart Key - Ivy</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Concept-Index_cp_letter-J">J</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-jump-menu">jump
menu</a>:</td><td> </td><td valign="top"><a
href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline
Clicks</a></td></tr>
@@ -13729,6 +14113,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-jump-to-window-by-letter">jump
to window by letter</a>:</td><td> </td><td valign="top"><a
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Concept-Index_cp_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-kbd-function">kbd
function</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kcell-link">kcell
link</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding-list">key binding
list</a>:</td><td> </td><td valign="top"><a
href="#Hyperbole-Key-Bindings">Hyperbole Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-key-binding_002c-C_002dc-_002e">key binding, C-c
.</a>:</td><td> </td><td valign="top"><a
href="#Default-Hyperbole-Bindings">Default Hyperbole Bindings</a></td></tr>
@@ -13743,8 +14128,9 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-menu">key
binding, menu</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-smart-keys">key
binding, smart keys</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-bindings">key
bindings</a>:</td><td> </td><td valign="top"><a
href="#Default-Hyperbole-Bindings">Default Hyperbole Bindings</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-key-bindings_002c-toggle">key
bindings, toggle</a>:</td><td> </td><td valign="top"><a
href="#Smart-Keys">Smart Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-key-bindings_002c-toggle">key
bindings, toggle</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-sequence">key
sequence</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-key-series">key
series</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-keyboard-drags">keyboard
drags</a>:</td><td> </td><td valign="top"><a
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-keyboard_002c-jump-to-window">keyboard, jump to
window</a>:</td><td> </td><td valign="top"><a
href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-keypad">keypad</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
@@ -13927,7 +14313,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-minibuffer_002c-buffer-menu">minibuffer, buffer
menu</a>:</td><td> </td><td valign="top"><a
href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-minibuffer_002c-default-actions">minibuffer, default
actions</a>:</td><td> </td><td valign="top"><a
href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-minibuffer_002c-jump-menu">minibuffer, jump
menu</a>:</td><td> </td><td valign="top"><a
href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-minor-mode_002c-hyperbole">minor
mode, hyperbole</a>:</td><td> </td><td valign="top"><a
href="#Smart-Keys">Smart Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-minor-mode_002c-hyperbole">minor
mode, hyperbole</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minor-mode_002c-keymap">minor
mode, keymap</a>:</td><td> </td><td valign="top"><a
href="#Default-Hyperbole-Bindings">Default Hyperbole Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline-click">modeline
click</a>:</td><td> </td><td valign="top"><a
href="#Modeline-Clicks-and-Drags">Modeline Clicks and Drags</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-modeline-click-and-drag">modeline click and
drag</a>:</td><td> </td><td valign="top"><a
href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline
Clicks</a></td></tr>
@@ -13975,17 +14361,20 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Concept-Index_cp_letter-O">O</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-object_002doriented-code-browsing">object-oriented code
browsing</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-The-OO_002dBrowser">Smart Key - The
OO-Browser</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-obtaining-Hyperbole">obtaining
Hyperbole</a>:</td><td> </td><td valign="top"><a
href="#Stable-Package-Installation">Stable Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-obtaining-Hyperbole">obtaining
Hyperbole</a>:</td><td> </td><td valign="top"><a
href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-online-library">online
library</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-OO_002dBrowser">OO-Browser</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-The-OO_002dBrowser">Smart Key - The
OO-Browser</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-option-setting">option
setting</a>:</td><td> </td><td valign="top"><a
href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-option-settings">option
settings</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-Org_002dmode">Org-mode</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-Org_002dmode-1">Org-mode</a>:</td><td> </td><td
valign="top"><a href="#Questions-and-Answers">Questions and
Answers</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Org-mode">Org
mode</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Org-Mode">Smart Key - Org Mode</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Org-tables">Org
tables</a>:</td><td> </td><td valign="top"><a
href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-org_002dmode">org-mode</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-Org_002dmode">Org-mode</a>:</td><td> </td><td valign="top"><a
href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-other-frame">other
frame</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-other-window">other
window</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline-file-suffix">outline
file suffix</a>:</td><td> </td><td valign="top"><a
href="#Creating-Outlines">Creating Outlines</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-outline-mode">outline
mode</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-outline-mode">outline
mode</a>:</td><td> </td><td valign="top"><a
href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-outline-mode-1">outline
mode</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline-processor">outline
processor</a>:</td><td> </td><td valign="top"><a
href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline-structure">outline
structure</a>:</td><td> </td><td valign="top"><a
href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-all-cells">outline,
all cells</a>:</td><td> </td><td valign="top"><a
href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
@@ -14019,13 +14408,14 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-overview">overview</a>:</td><td> </td><td valign="top"><a
href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Concept-Index_cp_letter-P">P</th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-package-manager">package
manager</a>:</td><td> </td><td valign="top"><a
href="#Stable-Package-Installation">Stable Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package-manager">package
manager</a>:</td><td> </td><td valign="top"><a
href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-paragraph_002c-filling">paragraph,
filling</a>:</td><td> </td><td valign="top"><a
href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-paste-region">paste
region</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pasting-a-region">pasting a
region</a>:</td><td> </td><td valign="top"><a
href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pasting-a-region-1">pasting a
region</a>:</td><td> </td><td valign="top"><a
href="#Smart-Mouse-Drags-between-Windows">Smart Mouse Drags between
Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pasting-a-region-2">pasting a
region</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited
Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-patch-output">patch
output</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-PATH_002dtype-variable">PATH-type
variable</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-pathname">pathname</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-pathname_002c-line-and-column">pathname, line and
column</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-permanent-identifier">permanent
identifier</a>:</td><td> </td><td valign="top"><a
href="#Koutliner">Koutliner</a></td></tr>
@@ -14037,7 +14427,8 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-popup-menu_002c-Rolo">popup
menu, Rolo</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-posting-buttons">posting
buttons</a>:</td><td> </td><td valign="top"><a
href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-posting-news">posting
news</a>:</td><td> </td><td valign="top"><a
href="#Buttons-in-News">Buttons in News</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-pre_002drelease-installation">pre-release
installation</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-pre_002drelease-installation">pre-release
installation</a>:</td><td> </td><td valign="top"><a
href="#Elpa-In_002dDevelopment-Package-Installation">Elpa In-Development
Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-pre_002drelease-installation-1">pre-release
installation</a>:</td><td> </td><td valign="top"><a
href="#Git-In_002dDevelopment-Package-Installation">Git In-Development Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-precedence_002c-buttons">precedence,
buttons</a>:</td><td> </td><td valign="top"><a
href="#Button-Type-Precedence">Button Type Precedence</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-programming-interface">programming
interface</a>:</td><td> </td><td valign="top"><a
href="#Embedding-Hyperbole">Embedding Hyperbole</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-promotion">promotion</a>:</td><td> </td><td valign="top"><a
href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
@@ -14085,23 +14476,28 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-rolo-keys">rolo
keys</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Rolo-menu">Rolo
menu</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Menu">HyRolo
Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo-searching">rolo
searching</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Searching">HyRolo Searching</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-rolo_002c-auto_002dexpanding-entries">rolo, auto-expanding
entries</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-buttons-in">rolo,
buttons in</a>:</td><td> </td><td valign="top"><a
href="#HyRolo">HyRolo</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-datestamps">rolo,
datestamps</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-editing">rolo,
editing</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-rolo_002c-extending-a-match">rolo, extending a
match</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-finding-matches">rolo,
finding matches</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-rolo_002c-hiding-entries">rolo,
hiding entries</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-rolo_002c-highlighting-matches">rolo, highlighting
matches</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-rolo_002c-highlighting-matches-1">rolo, highlighting
matches</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-rolo_002c-interactive-searching">rolo, interactive
searching</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-locating-a-name">rolo,
locating a name</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-rolo_002c-moving-through-matches">rolo, moving through
matches</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-rolo_002c-moving-to-entries">rolo, moving to
entries</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-rolo_002c-outlining">rolo,
outlining</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-rolo_002c-outline-of-entries">rolo, outline of
entries</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-personal">rolo,
personal</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-quitting">rolo,
quitting</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-search-again">rolo,
search again</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-rolo_002c-showing-entries">rolo,
showing entries</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-rolo_002c-top_002dlevel-entries">rolo, top-level
entries</a>:</td><td> </td><td valign="top"><a href="#HyRolo-Keys">HyRolo
Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-root-cell">root
cell</a>:</td><td> </td><td valign="top"><a
href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-root-cell-1">root
cell</a>:</td><td> </td><td valign="top"><a
href="#Idstamps">Idstamps</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-running-tests">running
tests</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Concept-Index_cp_letter-S">S</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-save-lines">save
lines</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
@@ -14119,7 +14515,8 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-searching_002c-rolo">searching,
rolo</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Searching">HyRolo Searching</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-selection">selection</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-selection_002c-menu-items">selection, menu
items</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-sequence-of-keys">sequence of
keys</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-semicolon_002dseparated-paths">semicolon-separated
paths</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-series-of-keys">series of
keys</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-set">set</a>:</td><td> </td><td valign="top"><a
href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-set-1">set</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited
Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-setting-the-view-spec">setting
the view spec</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
@@ -14158,14 +14555,14 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-social-reference">social
reference</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-source-line">source
line</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-splitting-a-cell">splitting a
cell</a>:</td><td> </td><td valign="top"><a
href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-stable-release-installation">stable release
installation</a>:</td><td> </td><td valign="top"><a
href="#Stable-Package-Installation">Stable Package Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-stable-release-installation">stable release
installation</a>:</td><td> </td><td valign="top"><a
href="#Elpa-Stable-Package-Installation">Elpa Stable Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-stack-frame">stack
frame</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-stack-frame-1">stack
frame</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-star-outline">star
outline</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-starting-HyControl">starting
HyControl</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-starting-Hyperbole">starting
Hyperbole</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-storage-manager">storage
manager</a>:</td><td> </td><td valign="top"><a
href="#Operational-and-Storage-Formats">Operational and Storage
Formats</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-Straight-package-manager">Straight package
manager</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-Straight-package-manager">Straight package
manager</a>:</td><td> </td><td valign="top"><a
href="#Git-In_002dDevelopment-Package-Installation">Git In-Development Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-string">string</a>:</td><td> </td><td valign="top"><a
href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-string-1">string</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited
Things</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-submenus">submenus</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
@@ -14187,8 +14584,9 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-tags-file">tags
file</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tar-archive-browsing">tar
archive browsing</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Tar-File-Mode">Smart Key - Tar File Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-terminal-use">terminal
use</a>:</td><td> </td><td valign="top"><a
href="#Buttons">Buttons</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-testing">testing</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-Texinfo-cross_002dreference">Texinfo
cross-reference</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-Texinfo-manual">Texinfo
manual</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-Texinfo-manual">Texinfo
manual</a>:</td><td> </td><td valign="top"><a
href="#Documentation">Documentation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-text-file">text
file</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-thing">thing</a>:</td><td> </td><td valign="top"><a
href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-thing-1">thing</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited
Things</a></td></tr>
@@ -14200,7 +14598,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-toc-implicit-button-type">toc
implicit button type</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-todotxt_002dmode">todotxt-mode</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Todotxt-Mode">Smart Key - Todotxt
Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toggle-HyControl-mode">toggle
HyControl mode</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-toggle-key-bindings">toggle key
bindings</a>:</td><td> </td><td valign="top"><a href="#Smart-Keys">Smart
Keys</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-toggle-key-bindings">toggle key
bindings</a>:</td><td> </td><td valign="top"><a
href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toggling-blank-lines">toggling
blank lines</a>:</td><td> </td><td valign="top"><a href="#View-Specs">View
Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-top_002dlevel-cell">top-level
cell</a>:</td><td> </td><td valign="top"><a
href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-top_002dlevel-cell-1">top-level
cell</a>:</td><td> </td><td valign="top"><a
href="#Idstamps">Idstamps</a></td></tr>
diff --git a/man/hyperbole.info b/man/hyperbole.info
index 28d58d389c..906d723d70 100644
Binary files a/man/hyperbole.info and b/man/hyperbole.info differ
diff --git a/man/hyperbole.pdf b/man/hyperbole.pdf
index a6b3ec0c99..03989b51a7 100644
Binary files a/man/hyperbole.pdf and b/man/hyperbole.pdf differ
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index edc02bb4cd..70a4099e01 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -155,7 +155,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
Edition 8.0.0pre
-Printed January 16, 2022.
+Printed January 17, 2022.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -197,7 +197,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
@example
Edition 8.0.0pre
-January 16, 2022
+January 17, 2022
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -249,6 +249,7 @@ years. The Koutliner is dedicated to my lovely wife, Kathy.
@menu
* Introduction::
+* Usage::
* Smart Keys::
* Buttons::
* Menus::
@@ -280,6 +281,12 @@ Introduction
* Hyperbole Overview::
* Mail Lists::
+Usage
+
+* Invocation::
+* Documentation::
+* Hyperbole Hooks::
+
Smart Keys
* Smart Key Bindings::
@@ -400,13 +407,13 @@ Explicit Button Technicalities
Setup
* Installation::
-* Invocation::
* Customization::
Installation
-* Stable Package Installation::
-* Git Pre-release Package Installation::
+* Elpa Stable Package Installation::
+* Elpa In-Development Package Installation::
+* Git In-Development Package Installation::
* Manual Tarball Archive Installation::
Customization
@@ -497,7 +504,7 @@ Smart Keyboard Keys
@end detailmenu
@end menu
-@node Introduction, Smart Keys, Top, Top
+@node Introduction, Usage, Top, Top
@chapter Introduction
This edition of the GNU Hyperbole Manual is for use with any version
@@ -711,12 +718,11 @@ of Hyperbole is a single global minor mode that you can
activate and
deactivate at will. And it can be uninstalled quickly as well if need be, so
there is no risk to giving it a spin.
-Once you have it installed and activated (use @bkbd{C-u M-x
-hyperbole-mode @key{RET}}), try the interactive demo with @bkbd{C-h h d d}.
+Once you have it installed, try the interactive demo with @bkbd{C-h h d d}.
In fact, if you have Hyperbole loaded, you can press @bkbd{M-@key{RET}}
-inside any of the brace delimited series of keys you see in this document and
-Hyperbole will execute them on-the-fly (easy keyboard-macro style buttons in
-any text).
+inside any of the brace delimited series of keys you see in this document
+and Hyperbole will execute them on-the-fly (easy keyboard-macro style
+buttons in any text).
Hyperbole can dramatically increase your productivity and greatly reduce
the number of keyboard/mouse keys you'll need to work efficiently.
@@ -890,24 +896,35 @@ There is a separate mail list to report problems or bugs
with
Hyperbole, <bug-hyperbole@@gnu.org>. For more details,
@pxref{Suggestion or Bug Reporting}.
-@node Smart Keys, Buttons, Introduction, Top
-@chapter Smart Keys
+@node Usage, Smart Keys, Introduction, Top
+@chapter Usage
-@cindex Smart Key
-@cindex mouse support
-@cindex Action Key
-@cindex Assist Key
-@cindex middle mouse key
-@vindex hmouse-middle-flag
-@kindex Action Key
-@kindex Assist Key
-When active, Hyperbole offers two special @dfn{Smart Keys}, the Action Key
-and the Assist Key, that perform an extensive array of context-sensitive
-operations across emacs usage. In many 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. This chapter explains typical uses of the Smart Keys. @xref{Smart
-Key Reference}, for complete descriptions of their behavior in all contexts.
+Once Hyperbole has been installed for use at your site, loaded into your
+Emacs session and activated with @code{(hyperbole-mode 1)}, it is ready
+for use. You will see a Hyperbole menu on your menubar and @code{Hypb} in
+your modeline.
+
+@menu
+* Invocation::
+* Documentation::
+* Hyperbole Hooks::
+@end menu
+
+@node Invocation, Documentation, Usage, Usage
+@section Invocation
+
+@noindent
+You can invoke Hyperbole's commands in one of three ways:
+
+@itemize @bullet
+@item use the Hyperbole entry on your menubar;
+
+@findex hyperbole
+@item type @bkbd{C-h h} or @bkbd{M-x hyperbole @key{RET}} to display the
Hyperbole minibuffer menu;
+
+@item use a specific Hyperbole command, for example, a press of
@bkbd{M-@key{RET}}
+on a pathname to display the associated file or directory.
+@end itemize
@vindex file, .emacs
@cindex hyperbole-mode
@@ -919,11 +936,75 @@ Key Reference}, for complete descriptions of their
behavior in all contexts.
@kindex C-h h
@kindex X
@kindex q
-Use @bkbd{C-h h} to activate Hyperbole (enable @code{hyperbole-mode} and
-display its keyboard-driven minibuffer menu). Use @bkbd{q} to quit from the
-minibuffer menu while leaving Hyperbole enabled and thus the Smart Keys
-active. Use@bkbd{X} to quit from the minibuffer menu and disable Hyperbole
-keys.
+@bkbd{C-h h} enables Hyperbole if it has been disabled and displays a
+Hyperbole menu in the minibuffer for quick keyboard or mouse-based selection.
+Select an item from this menu by typing the item's first capital letter.
+Use @bkbd{q} to quit from the minibuffer menu while leaving Hyperbole enabled.
+Use@bkbd{X} to quit from the minibuffer menu and disable Hyperbole minor mode.
+
+Use @bkbd{C-h h d d} for an interactive demonstration of standard Hyperbole
+button capabilities.
+
+Type @bkbd{C-h h k e} for an interactive demonstration of the Koutliner,
+Hyperbole's multi-level autonumbered hypertextual outliner.
+
+To try out HyControl, Hyperbole's interactive frame and window control
+system, use @bkbd{C-h h s w} for window control or @bkbd{C-h h s f} for
+frame control. Pressing @bkbd{t} switches between window and frame
+control once in HyControl. Hyperbole also binds @bkbd{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 most of HyControl's features is available at
+@url{https://youtu.be/M3-aMh1ccJk}.
+
+The above are the best interactive ways to learn about Hyperbole.
+
+@node Documentation, Hyperbole Hooks, Invocation, Usage
+@section Documentation
+
+@vindex Info-directory-list
+@vindex hyperb:dir
+@cindex Hyperbole manual
+@noindent
+The Hyperbole Manual is a reference manual, not a simple introduction.
+It is included in the @file{man/} subdirectory of the Hyperbole package
+directory in four forms:
+
+@cindex Info manual
+@cindex Texinfo manual
+@vindex file, man/hyperbole.info
+@vindex file, man/hyperbole.html
+@vindex file, man/hyperbole.pdf
+@vindex file, man/hyperbole.texi
+@example
+@file{man/hyperbole.info} - online Info browser version
+@file{man/hyperbole.html} - web HTML version
+@file{man/hyperbole.pdf} - printable version
+@file{man/hyperbole.texi} - source form
+@end example
+
+@kindex C-h h d i
+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. @bkbd{C-h h d i} will let you
+browse the manual. Then use @bkbd{s} to search for anything
+throughout the manual. For web browsing, point your browser
+to @file{@code{$@{hyperb:dir@}}/man/hyperbole.html}, wherever the
+Hyperbole package directory is on your system; often this
+is: @file{~/.emacs.d/elpa/hyperbole-$@{hyperb:version@}/}.
+
+
+@node Hyperbole Hooks, , Documentation, Usage
+@section Hyperbole Hooks
+@vindex hyperbole-init-hook
+@vindex hyperbole-mode-hook
+@vindex hyperbole-mode-on-hook
+@vindex hyperbole-mode-off-hook
+When Hyperbole's code is first loaded and initialized,
@code{hyperbole-init-hook}
+is run. When @code{hyperbole-mode} is enabled, @code{hyperbole-mode-hook} and
+@code{hyperbole-mode-on-hook} are run. When @code{hyperbole-mode} is disabled,
+@code{hyperbole-mode-hook} and hyperbole-mode-off-hook are run.
If you prefer a different key to activate Hyperbole, you can bind it as part
of any setting of @code{hyperbole-init-hook} within your personal
@@ -932,6 +1013,25 @@ of any setting of @code{hyperbole-init-hook} within your
personal
'hyperbole--enable-mode) (global-set-key "\C-hh" 'view-hello-file)))}; then
restart Emacs.
+@node Smart Keys, Buttons, Usage, Top
+@chapter Smart Keys
+
+@cindex Smart Key
+@cindex mouse support
+@cindex Action Key
+@cindex Assist Key
+@cindex middle mouse key
+@vindex hmouse-middle-flag
+@kindex Action Key
+@kindex Assist Key
+When active, Hyperbole offers two special @dfn{Smart Keys}, the Action Key
+and the Assist Key, that perform an extensive array of context-sensitive
+operations across emacs usage. In many 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. This chapter explains typical uses of the Smart Keys. @xref{Smart
+Key Reference}, for complete descriptions of their behavior in all contexts.
+
@menu
* Smart Key Bindings::
* Smart Key Operations::
@@ -1388,7 +1488,7 @@ Change the value to your desired command. Then press
@key{RET}.
@end itemize
@node Smart Mouse Key Drags, , Smart Mouse Key Modeline Clicks, Smart Keys
-@section Smart Mouse Key Drags
+@section Smart Mouse Key Drags
@cindex smart mouse key drag
@cindex Action Mouse Key drag
@@ -2007,10 +2107,6 @@ implicit button types (they are listed in increasing
order of priority).
@findex org-meta-return
@findex hsys-org-mode-p
@vindex file, hsys-org.el
-@vindex hsys-org-enable-smart-keys
-@cindex enable org-mode support
-@cindex disable org-mode support
-@cindex inhibit org-mode support
@item org-mode
Hyperbole recognizes Org mode constructs in any of these modes:
@code{org-mode}, @code{org-agenda-mode}, @code{outshine-mode}
@@ -2038,9 +2134,17 @@ of @bkbd{C-c C-c}, @code{org-ctrl-c-ctrl-c}.
In any other context besides the end of a line, the Action Key invokes
the Org-mode standard binding of @bkbd{M-@key{RET}}, @code{org-meta-return}.
+@vindex hsys-org-enable-smart-keys
+@cindex enable org-mode support
+@cindex disable org-mode support
+@cindex inhibit org-mode support
+@kindex C-h h c o
To disable Hyperbole support within Org major and minor modes, set
the custom option @code{hsys-org-enable-smart-keys} to @code{nil}. Then in
-Org modes, the Action Key will simply invoke @code{org-meta-return}. The
+Org modes, the Action Key will simply invoke @code{org-meta-return}.
+@bkbd{C-h h c o} will customize this setting interactively.
+
+The
following table summarizes the effect of this option setting.
@end table
@@ -2247,13 +2351,16 @@ the location from which to retrieve RFCs. Requires the
Emacs builtin
Tramp library for ftp file retrievals.
@findex ibtypes kbd-key
+@cindex key series
@cindex key sequence
-@cindex sequence of keys
+@cindex series of keys
+@cindex kbd function
@item kbd-key
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.
+will not be recognized. The string within @code{(kbd "string")} also
+acts as a key series button.
Any key sequence must be a string of one of the following:
@itemize @bullet
@@ -2552,7 +2659,7 @@ with the following format:
@file{<path>[#<link-anchor>]:<line-num>[:<column-num>
@cindex address
@item mail-address
If on an e-mail address in a specific buffer type, compose mail to that
-address in another window. Applies to any major mode
+address in another window. Applies to any major mode descended from those
in @code{mail-address-mode-list}, the rolo match buffer, any buffer
attached to a file in @code{hyrolo-file-list}, or any buffer
with @file{mail} or @file{rolo} (case-insensitive) within its name. If
@@ -2634,7 +2741,7 @@ which when activated run Hyperbole tests using the ERT
framework. The
@item hyperbole-run-test
Recognize buttons of the form @code{<hyperbole-run-test test-name>}
which when activated run individual Hyperbole tests, each given
-by the @code<test-name> argument, an unquoted name.
+by the @code{<test-name>} argument, an unquoted name.
@end table
@@ -3102,15 +3209,14 @@ creation process).
If a region was selected prior to the start of the drag, it is used as
the button label, otherwise, you are prompted for the label. Then
-Hyperbole uses the link referent context to determine the type of link
-to make. If there are a few different types of links which are
-applicable from the context, you will be prompted with a list of the
-types. Simply use the Action Key or the first letter of the link type
-to select one of the type names and to finish the link creation.
-Hyperbole will then insert explicit button delimiters around the
-button label and will display a message in the minibuffer indicating
-the button label, its action/link type, and any arguments, notably the
-thing to which it links.
+Hyperbole uses the link referent context to determine the type of link to
+make. If there are a few different types of links which are applicable
+from the context, you will be prompted with a list of the types. Simply
+use the Action Key or the first capital letter of the link type to select
+one of the type names and to finish the link creation. Hyperbole will
+then insert explicit button delimiters around the button label and will
+display a message in the minibuffer indicating the button label, its
+action/link type, and any arguments, notably the thing to which it links.
The following table shows the type of link that will be created based
upon the referent context in which the Action Key is released.
@@ -4177,7 +4283,9 @@ file included with Hyperbole. Use @bkbd{C-h h k e} to
display that
file, as pictured on the following page. It is an actual outline file
that explains major outliner operations. You can test out the viewing,
editing and motion commands with this file since a personal copy is made
-when you invoke this command.
+when you invoke this command. If you have already edited this file and
+want to start with a fresh one, give the command a prefix argument:
+@bkbd{C-u C-h h k e}.
@xref{Koutliner Keys}, for a full summary of the key bindings and
commands available in the Koutliner.
@@ -4496,8 +4604,8 @@ Use @bkbd{M-1 @key{TAB}} to toggle the @key{TAB} and
@cindex Org tables
The Koutliner supports Org Table editing, @pxref{Tables,,, org, the Org
-Mode Manual}, via Org table minor mode. Use {M-x orgtbl-mode RET} to
-toggle this on and off. A press of the Action Key on a @code{|} symbol,
+Mode Manual}, via Org table minor mode. Use @bkbd{M-x orgtbl-mode @key{RET}}
+to toggle this on and off. A press of the Action Key on a @code{|} symbol,
also toggles this minor mode on or off.
@cindex outline mode
@@ -5528,12 +5636,10 @@ matches. Standard string, @bkbd{C-s}, and regular
expression,
@bkbd{C-M-s}, interactive search commands are also available within
the rolo match buffer.
-@kindex rolo, a
-@kindex rolo, h
@kindex rolo, o
-@kindex rolo, s
@kindex rolo, t
-@cindex rolo, outlining
+@cindex rolo, top-level entries
+@cindex rolo, outline of entries
Single key outlining commands are also available for browsing matches.
If your search matches a large number of entries, use @bkbd{t} to get
a top-level summary of entries. Only the first line of each
@@ -5542,9 +5648,18 @@ levels, use @bkbd{o} which shows the first line of every
entry level.
If you want an overview of just the first two levels, @bkbd{C-u 2 o}
will work.
-Press @bkbd{s} to show (expand) the entry at point.
-Use @bkbd{h} to hide (collapse) the entry. Press @bkbd{a}
-to expand all entries in the buffer.
+@kindex rolo, a
+@kindex rolo, h
+@kindex rolo, s
+@cindex rolo, auto-expanding entries
+@cindex rolo, hiding entries
+@cindex rolo, showing entries
+Press @bkbd{s} to show (expand) the entry at point. Use @bkbd{h} to hide
+(collapse) the entry. Press @bkbd{a} to expand all entries in the
+buffer. If an entry is collapsed/hidden, moving to any hidden part
+auto-expands it and then re-collapses it when point is moved to another
+entry (just like isearch). A side-effect of this is that the @bkbd{h}
+hide entry subtree command now moves to the beginning of the entry.
@noindent
Other keys are defined to help you work with matching entries.
@@ -6471,8 +6586,6 @@ quickly.
@vindex class, ebut
@vindex file, hbut.el
-@findex ebut:create
-@findex ebut:map
The Hyperbole class @samp{ebut} supports programmatic access to explicit
buttons. Examine it within the @file{hbut.el} file for full details.
@@ -6488,11 +6601,17 @@ the button LABEL which is automatically provided as the
first argument.
For interactive explicit creation, use @code{hui:ebut-create} instead.
+@findex ebut:create
+@findex ebut:map
The documentation for @code{(ebut:create)} explains the set of
attributes necessary to create an explicit button. For operations over
the whole set of buttons within the visible (non-narrowed) portion of a
buffer, use the @code{(ebut:map)} function.
+@findex gbut:ebut-program
+Similarly, @code{gbut:ebut-program} programmatically adds global explicit
+buttons at the end of the personal button file.
+
@node Encapsulating Systems, Embedding Hyperbole, Explicit Button
Technicalities, Developing with Hyperbole
@section Encapsulating Systems
@@ -7039,42 +7158,46 @@ Hyperbole must be obtained and setup at your site
before you can
use it. Instructions are given below. If you are using InfoDock
version 4.0.7 or higher, Hyperbole is pre-installed so you may skip
the installation instructions and simply continue with the
-invocation instructions in this appendix.
+next section about customizing Hyperbole's behavior.
@menu
* Installation::
-* Invocation::
* Customization::
@end menu
-@node Installation, Invocation, Setup, Setup
+@node Installation, Customization, Setup, Setup
@section Installation
There are multiple package managers you can use to install Hyperbole once
-you have GNU Emacs set up at your site.
+you have GNU Emacs set up at your site. Choose one based on your needs.
@menu
-* Stable Package Installation::
-* Git Pre-release Package Installation::
+* Elpa Stable Package Installation::
+* Elpa In-Development Package Installation::
+* Git In-Development Package Installation::
* Manual Tarball Archive Installation::
@end menu
@noindent
After installing Hyperbole, read the next section on Invocation.
-@node Stable Package Installation, Git Pre-release Package Installation,
Installation, Installation
-@subsection Stable Package Installation (Emacs Package Manager)
+@node Elpa Stable Package Installation, Elpa In-Development Package
Installation, Installation, Installation
+@subsection Elpa Stable Package Installation (Emacs Package Manager)
@cindex installation
+@cindex elpa package
@cindex package manager
@cindex Emacs package manager
@cindex stable release installation
@cindex installation, stable
@cindex obtaining Hyperbole
@cindex Hyperbole, obtaining
-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, @pxref{Packages,,,emacs,the GNU Emacs Manual}.
+Once you have Emacs set up at your site, the stable, released version of
+GNU Hyperbole may be installed by using the Emacs Package Manager. If
+you are not familiar with it, @pxref{Packages,,,emacs,the GNU Emacs
+Manual}. Releases are very rare and the in-development branch may be
+many months and features ahead, so you may want to consider using either
+the Elpa In-Development or Git In-Development installation instead.
If you have Hyperbole installed and simply want to upgrade it, invoke
the Emacs Package Manager with @bkbd{M-x list-packages @key{RET}},
@@ -7091,37 +7214,106 @@ the GNU Emacs Manual}).
Below are the lines to add:
@lisp
-(require 'package)
+@group
(when (< emacs-major-version 27)
- (package-initialize))
+ (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
+(require 'package)
(unless (package-installed-p 'hyperbole)
(package-refresh-contents)
(package-install 'hyperbole))
(hyperbole-mode 1)
+@end group
+@end lisp
+
+Now save the file and 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.
+
+@node Elpa In-Development Package Installation, Git In-Development Package
Installation, Elpa Stable Package Installation, Installation
+@subsection Elpa In-Development Package Installation
+
+@cindex elpa-devel package
+@cindex in-development installation
+@cindex pre-release installation
+@cindex installation, pre-release
+@cindex installation, from git
+The Elpa In-Development package pulls from the latest Hyperbole
+development branch tip and does not require installation of any new
+package manager software. Since Hyperbole is a mature package, this is
+usually fine to use and update on a day-to-day basis. But new features
+are tested on this branch and once in awhile it may break for a short
+time before a fix is pushed. With this branch you'll be able to submit
+bug reports and feature requests but will not be able to submit pull
+requests for changes to the developers; use the Git In-Development
+Package instead for that.
+
+If you have Hyperbole installed and simply want to upgrade it, invoke
+the Emacs Package Manager with @bkbd{M-x list-packages @key{RET}},
+then use the @bkbd{U} key followed by the @bkbd{x} key to upgrade all
+out-of-date packages, Hyperbole among them. Then skip the text below
+and move on to the next section, @pxref{Invocation}.
+
+Otherwise, to download and install the Hyperbole package, you should add
+several lines to your personal Emacs initialization file, @file{~/.emacs}.
+(For further details, @pxref{Init File,,The Emacs Initialization File,emacs,
+the GNU Emacs Manual}).
+
+@noindent
+Below are the lines to add:
+
+@lisp
+@group
+(when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
+(require 'package)
+(add-to-list 'package-archives '("gnu-devel" . "https://elpa.gnu.org/devel/"))
+(unless (package-installed-p 'hyperbole)
+ (package-refresh-contents)
+ (package-install 'hyperbole))
+(hyperbole-mode 1)
+@end group
@end lisp
-Now save the file and 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.
+Now save the file and 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.
-@node Git Pre-release Package Installation, Manual Tarball Archive
Installation, Stable Package Installation, Installation
-@subsection Git Pre-release Package Installation (Straight Package Manager)
+@node Git In-Development Package Installation, Manual Tarball Archive
Installation, Elpa In-Development Package Installation, Installation
+@subsection Git In-Development Package Installation (Straight Package Manager)
@cindex Straight package manager
@cindex pre-release installation
@cindex installation, pre-release
@cindex installation, from git
-If you prefer to track Hyperbole development between releases and like to
-try out new features still in testing, then use the Straight package
-manager instead of the above, which pulls the latest Hyperbole source code
-from its git repository. This also gives you a cleaner installation
-process without showing you any byte compilation warnings.
+If you potentially want to contribute to Hyperbole development and send
+pull requests to the Hyperbole development team or to try out new
+features still in testing, you can use the Straight package manager. It
+pulls the latest Hyperbole source code directly from its git repository.
+This also gives you a clean installation process without showing you any
+minor byte compilation warnings.
+
+If you have Hyperbole installed and simply want to upgrade it, invoke
+the Emacs Package Manager with @bkbd{M-x list-packages @key{RET}},
+then use the @bkbd{U} key followed by the @bkbd{x} key to upgrade all
+out-of-date packages, Hyperbole among them. Then skip the text below
+and move on to the next section, @pxref{Invocation}.
+
+Otherwise, to download and install the Hyperbole package, you should add
+several lines to your personal Emacs initialization file, @file{~/.emacs}.
+(For further details, @pxref{Init File,,The Emacs Initialization File,emacs,
+the GNU Emacs Manual}).
+
+@noindent
+Below are the lines to add:
@lisp
@group
;; Use this in your Emacs init file to install Straight
(progn
+ (when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
(defvar bootstrap-version)
(setq package-enable-at-startup nil)
(let ((bootstrap-file
@@ -7147,7 +7339,10 @@ process without showing you any byte compilation
warnings.
@end group
@end lisp
-@node Manual Tarball Archive Installation, , Git Pre-release Package
Installation, Installation
+Now save the file and restart Emacs. Hyperbole will then be downloaded
+and compiled for use with your version of Emacs; give it a minute or two.
+
+@node Manual Tarball Archive Installation, , Git In-Development Package
Installation, Installation
@subsection Manual Tarball Archive Installation
If you are old-school, don't like package managers, and prefer doing
@@ -7172,99 +7367,28 @@ to at the top of this web page:
Then decompress and unpack the archive to a directory of your
-choosing. Move into the @file{hyperbole/} directory and execute
+choosing. Move into the @file{hyperbole-<version>/} directory and execute
the following Posix shell command, @code{make bin}, to
byte-compile the Hyperbole lisp files. Then add the following
lines to your personal Emacs initialization file,
@file{~/.emacs}:
@lisp
+@group
(unless (and (featurep 'hyperbole) hyperbole-mode)
+ (when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
(push "<directory-ending-with-hyperbole-where-you-unpacked>" load-path)
(require 'hyperbole)
(hyperbole-mode 1))
+@end group
@end lisp
Restart Emacs and you should see the @code{Hypb} hyperbole minor mode
indicator in your modeline after startup.
-@node Invocation, Customization, Installation, Setup
-@section Invocation
-
-Once Hyperbole has been installed for use at your site and loaded into
-your Emacs session, it is ready for use. You will see a Hyperbole
-menu on your menubar and @bkbd{C-h h} will display a Hyperbole menu in
-the minibuffer for quick keyboard or mouse-based selection. Select an
-item from this menu by typing the item's first letter. Use @bkbd{q}
-to quit from the menu.
-
-@noindent
-You can invoke Hyperbole's commands in one of three ways:
-
-@itemize @bullet
-@item use the Hyperbole entry on your menubar;
-
-@findex hyperbole
-@item type @bkbd{C-h h} or @bkbd{M-x hyperbole @key{RET}} to display the
Hyperbole minibuffer menu;
-
-@item use a specific Hyperbole command, for example, a press of
-@bkbd{M-@key{RET}} on a pathname to display the associated file or
-directory.
-@end itemize
-
-Use @bkbd{C-h h d d} for an interactive demonstration of standard Hyperbole
-button capabilities.
-
-Type @bkbd{C-h h k e} for an interactive demonstration of the Koutliner,
-Hyperbole's multi-level autonumbered hypertextual outliner.
-
-To try out HyControl, Hyperbole's interactive frame and window control
-system, use @bkbd{C-h h s w} for window control or @bkbd{C-h h s f}
-for frame control. Pressing @bkbd{t} switches between window and
-frame control once in HyControl. Hyperbole also binds @bkbd{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 most of HyControl's features is available at
-@url{https://youtu.be/M3-aMh1ccJk}.
-
-@vindex Info-directory-list
-@vindex hyperb:dir
-@cindex Hyperbole manual
-@noindent
-The above are the best interactive ways to learn about Hyperbole. The
-Hyperbole Manual is a reference manual, not a simple introduction. It
-is included in the @file{man/} subdirectory of the Hyperbole package
-directory in four forms:
-
-@cindex Info manual
-@cindex Texinfo manual
-@vindex file, man/hyperbole.info
-@vindex file, man/hyperbole.html
-@vindex file, man/hyperbole.pdf
-@vindex file, man/hyperbole.texi
-@example
-@file{man/hyperbole.info} - online Info browser version
-@file{man/hyperbole.html} - web HTML version
-@file{man/hyperbole.pdf} - printable version
-@file{man/hyperbole.texi} - source form
-@end example
-
-@kindex C-h h d i
-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. @bkbd{C-h h d i} will let you
-browse the manual. Then use @bkbd{s} to search for anything
-throughout the manual. For web browsing, point your browser
-at @file{@code{$@{hyperb:dir@}}/man/hyperbole.html}, wherever the
-Hyperbole package directory is on your system; often this
-is: @file{~/.emacs.d/elpa/hyperbole-$@{hyperb:version@}/}.
-
-@noindent
-Advanced users may want to continue on to the next section about
-configuring Hyperbole's behavior.
-
@page
-@node Customization, , Invocation, Setup
+@node Customization, , Installation, Setup
@section Customization
@cindex menu, Cust
@@ -7632,6 +7756,11 @@ code which supports this behavior. A call
to @code{(hproperty:cycle-but-color)} in the @file{hsettings.el} file
changes the color used to highlight and flash explicit buttons.
+@vindex hproperty:but-flash-time-seconds
+@cindex button flash time
+You may also change the length of time in fractions of a second that a
+button flashes by setting @code{hproperty:but-flash-time-seconds}.
+
@vindex hproperty:but-highlight-flag
Whether or not buttons are highlighted is controlled
by @code{hproperty:but-highlight-flag}, which defaults to @samp{t}.
@@ -8862,24 +8991,24 @@ When company-mode is active:
@group
When in an Org mode context and @code{hsys-org-enable-smart-keys} is non-nil:
ACTION KEY
- (1) follows internal links in Org mode files. When pressed on a
- link referent/target, the link definition is displayed, allowing
two-way
- navigation between definitions and targets.
+ (1) follows internal links in Org mode files. When pressed on a link
+ referent/target, the link definition is displayed, allowing two-way
+ navigation between definitions and targets.
(2) follows Org mode external links.
- (3) within a radio target definition, this jumps to the first
- occurrence of an associated radio target.
+ (3) within a radio target definition, this jumps to the first occurrence
+ of an associated radio target.
- (4) when point is on an outline heading in Org mode, this
- cycles the view of the subtree at point.
+ (4) when point is on an outline heading in Org mode, this cycles the view
+ of the subtree at point.
- (5) with point on the first line of a code block definition, this
- executes the code block via the Org mode standard binding of {C-c C-c},
- (org-ctrl-c-ctrl-c).
+ (5) with point on the first line of a code block definition, this executes
+ the code block via the Org mode standard binding of @bkbd{C-c C-c},
+ @code{(org-ctrl-c-ctrl-c)}.
(6) In any other context besides the end of a line, the Action Key
invokes the
- Org mode standard binding of {M-RET}, (org-meta-return).
+ Org mode standard binding of @bkbd{M-@key{RET}},
@code{(org-meta-return)}.
ASSIST KEY
(1) on an Org mode heading, this cycles through views of the whole buffer
outline.
@@ -9347,14 +9476,13 @@ When pressed within Custom-mode for editing
customizations:
prompting to save any changes;
(2) at the end of any other line, scroll the window down down a windowful;
(3) if a mouse event on a widget, activate the widget or display a menu;
- (4) anywhere else, execute the command bound to {RETURN}.
+ (4) anywhere else, execute the command bound to @key{RET}.
ASSIST KEY
(1) on the last line of the buffer, exit Custom mode, potentially
prompting to save any changes;
(2) at the end of any other line, scroll the window down down a windowful;
(3) if a mouse event on a widget, activate the widget or display a menu;
- (4) anywhere else, execute the command bound to {RETURN}.
-
+ (4) anywhere else, execute the command bound to @key{RET}.
@node Smart Key - Bookmark Mode, Smart Key - Pages Directory Mode, Smart Key -
Custom Mode, Smart Keyboard Keys
@subsection Smart Key - Bookmark Mode
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [elpa] externals/hyperbole 621b780629: Add HyRolo entry auto-exposure; doc Installation and Org tables,
ELPA Syncer <=