[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/hyperbole 804387e1f8 4/5: Update doc in prep for V8.0.0
From: |
ELPA Syncer |
Subject: |
[elpa] externals/hyperbole 804387e1f8 4/5: Update doc in prep for V8.0.0 release |
Date: |
Tue, 18 Jan 2022 15:57:36 -0500 (EST) |
branch: externals/hyperbole
commit 804387e1f86a9c9f946bc82c6cded11f696f02d7
Author: Robert Weiner <rsw@gnu.org>
Commit: Robert Weiner <rsw@gnu.org>
Update doc in prep for V8.0.0 release
---
ChangeLog | 23 ++++---
HY-NEWS | 115 +++++++++++++++++++++++----------
MANIFEST | 5 ++
Makefile | 4 +-
kotl/EXAMPLE.kotl | 168 +++++++++++++++++++++++++++++-------------------
man/hyperbole.html | 184 ++++++++++++++++++++++++++++++++++-------------------
man/hyperbole.info | Bin 571131 -> 573588 bytes
man/hyperbole.pdf | Bin 1324835 -> 1326832 bytes
man/hyperbole.texi | 86 ++++++++++++++++++-------
9 files changed, 384 insertions(+), 201 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index a9b05e4f1e..49f75a3d59 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -6,6 +6,9 @@
(smart-lisp-at-non-htype-tag-p): Use when don't want to resolve
Hyperbole htypes.
+* man/hyperbole.texi (Promoting and Demoting): Add this section separated from
+ Relocating and Copying.
+
* test/MANIFEST - Add summary of Hyperbole test case files
install-test/MANIFEST - Add summary of Hyperbole installation test files
@@ -291,7 +294,7 @@
the mail buffer via 'kotl-mode:mail-tree'.
* hargs.el (hargs:at-p): Fix so when reading a buffer arg, if tag at point
does not match
- an existing buffer name, then use the buffer name at point.
+ an existing buffer name, then use the current buffer name.
(hargs:read-buffer-name): Add for use by kotl-mode.
* hyperbole.el (hkey-initialize): Add missing C-c prefix binding for
hyperbole-mode-map.
@@ -417,8 +420,8 @@
(kotl-orgtbl-shift-tab-demotes-tree-outside-table): Add tests.
* kotl/kotl-mode.el (kotl-mode): Change binding for orgtbl C-d to use new
- uniq command name, add binding for orgtbl shift tab to provide demote
- tree outside of table.
+ kotl-mode:delete-char command; add binding for orgtbl shift tab to enable
+ demotion of trees outside of tables.
2021-11-07 Bob Weiner <rsw@gnu.org>
@@ -519,7 +522,7 @@
(hmouse-save-region): Remove unused optional 'frame' arg.
* hbut.el (ibut:to): Fix to handle ibuts with text-only, no separate name
- by using ibut:-at-p instead of ibut:label-p.
+ by using ibut:at-p instead of ibut:label-p.
(ibut:to-text): Prevent error when lbl-key-end is not found and
find double-quoted ibuts with no optional label.
(ibut:at-p): Fix handling of double-quoted implicit buttons without
@@ -534,7 +537,7 @@
hactypes.el (link-to-ibut): Generalize 'key-src' parameter to 'but-src' so
handles buffers as well as files.
-* hbdata.el (hbdata:apply-entry): Added save-restriction in case in hbdata
+* hbdata.el (hbdata:apply-entry): Added save-restriction in case hbdata
is stored in a displayable buffer, e.g. *scratch*, which may have a prior
visible restriction. Also, added support for such non-mail/news buffers.
@@ -581,7 +584,7 @@
* Makefile (bin): Hide docstring warnings.
-2021-09-26 Robert Weiner <bk@bka-iMac.lan>
+2021-09-26 Robert Weiner <rsw@gnul.org>
* hbut.el (ebut:operate): Rewrote to handle label modification properly and
thereby
fixed
hui-ebut-modify-link-to-www-url-keeping-all-values-should-not-modify-buffer-or-ebut
@@ -628,11 +631,6 @@
- Update copyright notice
- Use #'-syntax for functions
-2021-09-11 Mats Lidell <matsl@gnu.org>
-
-* hsettings.el (hyperbole-web-search-browser-function): Use
- browse-url--browser-defcustom-type for customization.
-
2021-09-05 Bob Weiner <rsw@gnu.org>
* kotl/kexport.el (kexport:html): Fix export-from parameter checks to
@@ -887,7 +885,8 @@ Delete knode.el and integrate functionality into kcell.el.
with table row-level valign=text-bottom.
* kotl/klink.el (klink:ignore-modes, klink:c-style-modes): Add so
- can customize.
+ can customize which modes in which klinks are ignored to avoid
+ false matches.
* hsettings.el (hyperbole-web-search-alist): Update 'gitHub'
name.
diff --git a/HY-NEWS b/HY-NEWS
index b7ca8e6abf..794b540981 100644
--- a/HY-NEWS
+++ b/HY-NEWS
@@ -82,12 +82,13 @@
TEST CASES
- - Hyperbole Automated Testing: Hyperbole now includes over 200 test cases
- in the test/ subdirectory. Simply run 'make test' or 'make test-all'
- 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. See "Makefile".
+ - Hyperbole Automated Testing: Extensive quality improvements throughout
+ Hyperbole thanks in part to over 200 test cases now included in the
+ test/ subdirectory. Simply run 'make test' or 'make test-all' 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. See "Makefile" and "test/MANIFEST".
- Implicit Button Types to Run Tests: The file "hypb-ert.el" contains two
action link types:
@@ -103,6 +104,10 @@
Run all tests
<hyperbole-run-tests t>
+
+ - Installation Testing: install-test/local-install-test.sh automatically
+ installs Hyperbole for testing from one or more of its releases or
+ development branches. See "Makefile" and "install-test/MANIFEST".
HYROLO (See "(hyperbole)HyRolo").
@@ -123,12 +128,21 @@
a prefix arg. Available in the minibuffer menu as Rolo/File and the
pulldown menu as Rolo/Find-HyRolo-File.
+ - Sorting Entries Rewritten: {C-h h r o} re-ordering HyRolo entries has
+ been rewritten for compatibility and improved debugging with the latest
+ Emacs releases.
+
- hyrolo-highlight-face: Now uses the Emacs 'match' face by default.
+ - Under MS Windows, the default HyRolo file is now "~/.rolo.otl" like
+ all other operating systems, instead of "~/_rolo.otl". Any older file
+ name will be relocated to the newer name.
+
KOUTLINER (See "(hyperbole)Koutliner").
- Export Koutlines to Collapsible Web Pages: The {M-x kexport:display RET}
- command now produces web-based expandable/collapsible outlines.
+ command creates and displays a web-based expandable/collapsible outline
+ from the Koutline in the current buffer. See "(hyperbole)Exporting".
- Org Table Support: Org table editing now automatically works in the
Koutliner via Org table minor mode. Use {M-x orgtbl-mode RET} to
@@ -137,16 +151,20 @@
Use a prefix arg with {TAB} to promote/demote Koutline trees when in
a table since {TAB} moves between fields within a table.
- - New Mail Tree Key Binding: The kotl-mode:mail-tree command that
+ - 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 global hycontrol-window-grid
command bound to {C-c @}.
+ - The new commands, `kotl-mode:insert-region' and `kotl-mode:insert-tree'
+ insert parts of Koutlines directly into other buffers without having
+ to copy to a mail/message buffer first.
+
- New Tree Demotion/Promotion Keys: Tree promotion and demotion keys now
match the defaults in Org mode and Outline mode, plus some easier to
type ones. The tables below summarize which keys work whether inside
- an Org table or outside.
+ an Org table or outside. See "(hyperbole)Promoting and Demoting".
|----------------------------+-----------------------------|
| Demotion Inside Org Table | Promotion Inside Org Table |
@@ -185,6 +203,10 @@
arg of t to force archiving of any existing file and starting with
a fresh EXAMPLE.kotl file.
+ - Modes to Ignore Klinks: C-style languages use <includes> that can be
+ mistaken for klinks. New customizations 'klink:ignore-modes' and
+ 'klink:c-style-modes' set the modes where klink matches are ignored.
+
MENUS
- Minibuffer Menu Changes:
@@ -198,13 +220,39 @@
SMART (ACTION AND ASSIST) KEYS (See "(hyperbole)Smart Keys").
- - Generalized Anchored Pathnames: "pathname#anchor" now works in
+ - Explicit buttons may be created in any kind of temporary buffer
+ without an attached file, similar to what already existed for mail
+ message buffers.
+
+ - Pathname Implicit Buttons: Much improved pathname handling including
+ multiple variables per path, embedded . or .. within paths, better
+ recognition of semicolon separated pathnames in Windows PATH variable.
+
+ Variable substitutions are now made with fixed case, so that the
+ case of a value with both upper and lower case characters is
+ never changed, for example a value of ${HOME}.
+
+ Recursive 'ls' listings are now recognized properly, prepending the
+ preceding directory to each entry for viewing.
+
+ 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.
+ PATH-style Variable Support: An Action Key press on a defined PATH-style
+ variable name, e.g. MANPATH, 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. :: represents the current
directory,
+ ’.’. Must have at least four paths within the variable value for this
+ to work.
+
+ file:// URLs are now resolved properly.
+
+ - Any Lisp or environment variable that stores a directory or set of
+ directories may be prepended to any "grep -n" output line with the form
+ "${var-name}/" and the Action Key will recognize the directory and
display
+ the appropriate line.
- 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
@@ -229,26 +277,6 @@
source reference line so if not on a Hyperbole button, move back a line
before checking.
- - Pathname Implicit Buttons: Recursive 'ls' listings are now recognized
- properly, prepending the preceding directory to each entry for viewing.
-
- An Action Key press on a defined PATH-style variable name, e.g. MANPATH,
- 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. :: represent the current directory, ’.’. Must have at least four
- paths within the variable value for this to work.
-
- Much improved pathname handling including multiple variables per
- path, embedded . or .. within paths, better recognition of semicolon
- separated pathnames in Windows PATH variable.
-
- Variable substitutions are now made with fixed case, so that the
- case of a value with both upper and lower case characters is
- never changed, for example a value of ${HOME}.
-
- file:// URLs are now resolved properly.
-
- Todotxt Mode Support: Smart key support for the todotxt mode
https://github.com/rpdillon/todotxt.el.
@@ -259,6 +287,10 @@
instead of ftp since this is disabled in many environments. Always
display
with Emacs' web browser rather than externally.
+ - 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.
+
CUSTOMIZATON
- Customizable Display Program File Mappings:
@@ -267,10 +299,20 @@
hpath:external-display-alist-macos
hpath:external-display-alist-mswindows
hpath:external-display-alist-x)
- are all customizable.
+ are all customizable and their default values utilize the per operating
+ system generic 'open' commands based on file suffix associations (for
file
+ types not handled by Emacs).
+
+ The new customizable variable, `hpath:external-file-suffixes', holds a
regular
+ expression of operating system independent file suffixes to open outside
Emacs
+ with the Action Key when not handled by `hpath:native-image-suffixes'.
PROGRAMMING
+ - With the Hyperbole menu Cust/Debug-Toggle enabled, the messages printed
+ for each Smart Key press now include the action type and its arguments
+ for improved debugging.
+
- Edebuggable Hyperbole Types: `defib' and `defact' type definitions
are now interactively debuggable via edebug-defun {C-M-x}.
@@ -296,6 +338,11 @@
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">.
+ - ibut:at-p: Trigger an error if any implicit button type predicate
+ permanently moves point to simplify debugging such predicates.
+
+ - hypb:string-count-matches: Count regexp matches in a string.
+
ACE WINDOW PACKAGE INTEGRATION - fast window and buffer switching
- After installing the ace-window package and loading Hyperbole, execute
diff --git a/MANIFEST b/MANIFEST
index 14ab84ea72..e1b8b26c48 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -98,3 +98,8 @@ topwin.py - Python script to find the topmost
macOS app window at a s
hsys-org.el - GNU Hyperbole support functions for Org mode
hsys-www.el - GNU Hyperbole support for Emacs W3 World-Wide Web (WWW)
browsing
+--- HYPERBOLE TEST CASES ---
+test/MANIFEST - Summary of Hyperbole test case files
+
+--- HYPERBOLE INSTALLATION TEST CONFIGURATIONS ---
+install-test/MANIFEST - Summary of Hyperbole installation test files
diff --git a/Makefile b/Makefile
index d2dc7dfd16..1cec50fdc3 100644
--- a/Makefile
+++ b/Makefile
@@ -272,8 +272,8 @@ bin: src
-f batch-byte-compile $(EL_KOTL) $(EL_COMPILE)
# Byte compile files but apply a filter for either including or
-# removing warnings. See variable {C-hv byte-compile-warnings RET} for
-# list of warnings that can be controlled. Default is set to suppress
+# removing warnings. See variable {C-hv byte-compile-warnings RET} for
+# list of warnings that can be controlled. Default is set to suppress
# warnings for long docstrings.
#
# Example for getting warnings for obsolete functions and variables
diff --git a/kotl/EXAMPLE.kotl b/kotl/EXAMPLE.kotl
index 1f0290816c..ec0803f5db 100644
--- a/kotl/EXAMPLE.kotl
+++ b/kotl/EXAMPLE.kotl
@@ -340,10 +340,40 @@
a koutline or {C-h h k l} when not in a koutline to insert a
klink.
- 3d. The Koutliner code runs on any system that supports Emacs,
+ 3d. Org table editing is supported.
+
+ 3d1. You must use the first line of the cell to label your table
+ as tables require only blanks to the left of each row.
+
+ 3d2. Here are two table examples:
+
+ |----------------------------+-----------------------------|
+ | 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-> |
+ |----------------------------+-----------------------------|
+
+ To toggle table editing mode on or off, press the Action
+ Key on any of the table | symbols and then edit as you
+ would any Org table. Note how the above tables show how
+ TAB and Shift-TAB behave differently in and outside of
+ tables. See "(Org)Tables" for help on utilizing tables.
+
+ 3e. The Koutliner code runs on any system that supports Emacs,
whether under a window system or from a dumb terminal display.
- 4. Major features left to be implemented (help sponsor one and get it done):
+ 4. Major features left to be implemented:
4a. Branch handling commands (all cells at same level).
@@ -361,7 +391,7 @@
"ben" ;; kvspec:current
-77 ;; id-counter
+81 ;; id-counter
alpha ;; label-type
3 ;; label-min-width
". " ;; label-separator
@@ -369,127 +399,133 @@ alpha ;; label-type
;; depth-first kcell attributes
[[0
- (idstamp 0 creator "bw@NYC-WEINERBOB" create-time "20210524:02:30:42"
id-counter 77 file
"/mnt/c/Users/bob.weiner/Dropbox/emacs/hyperbole/kotl/EXAMPLE.kotl")]
+ (idstamp 0 creator "rsw@gnu.org" create-time "20220117:22:23:52" id-counter
81 file "/c/Users/bob.weiner/Dropbox/emacs/hyperbole/kotl/EXAMPLE.kotl")]
[20
- (rear-nonsticky t no-fill t create-time "19940104:17:38:28" creator
"rsw@gnu.org" idstamp 20 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:28" no-fill t
rear-nonsticky t idstamp 20 kcell t)]
[2
- (rear-nonsticky t no-fill t create-time "19940104:17:38:28" creator
"rsw@gnu.org" idstamp 2 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:28" no-fill t
rear-nonsticky t idstamp 2 kcell t)]
[34
- (rear-nonsticky t create-time "19940610:16:43:55" creator "rsw@gnu.org"
idstamp 34 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:16:43:55" rear-nonsticky t
idstamp 34 kcell t)]
[35
- (rear-nonsticky t create-time "19940610:16:44:03" creator "rsw@gnu.org"
idstamp 35 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:16:44:03" rear-nonsticky t
idstamp 35 kcell t)]
[4
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 4 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 4 kcell t)]
[5
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 5 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 5 kcell t)]
[6
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 6 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 6 kcell t)]
[14
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 14 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 14 kcell t)]
[67
- (rear-nonsticky t no-fill t create-time "19951028:04:29:13" creator
"rsw@gnu.org" idstamp 67 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951028:04:29:13" no-fill t
rear-nonsticky t idstamp 67 kcell t)]
[15
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 15 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 15 kcell t)]
[31
- (rear-nonsticky t create-time "19940306:18:11:43" creator "rsw@gnu.org"
idstamp 31 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940306:18:11:43" rear-nonsticky t
idstamp 31 kcell t)]
[7
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 7 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 7 kcell t)]
[46
- (rear-nonsticky t create-time "19950614:21:35:17" creator "rsw@gnu.org"
idstamp 46 kcell t)]
+ (creator "rsw@gnu.org" create-time "19950614:21:35:17" rear-nonsticky t
idstamp 46 kcell t)]
[43
- (rear-nonsticky t create-time "19940610:22:00:46" creator "rsw@gnu.org"
idstamp 43 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:22:00:46" rear-nonsticky t
idstamp 43 kcell t)]
[22
- (rear-nonsticky t create-time "19940127:22:41:42" creator "rsw@gnu.org"
idstamp 22 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940127:22:41:42" rear-nonsticky t
idstamp 22 kcell t)]
[32
- (rear-nonsticky t create-time "19940610:16:31:28" creator "rsw@gnu.org"
idstamp 32 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:16:31:28" rear-nonsticky t
idstamp 32 kcell t)]
[41
- (rear-nonsticky t create-time "19940610:18:55:09" creator "rsw@gnu.org"
idstamp 41 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:18:55:09" rear-nonsticky t
idstamp 41 kcell t)]
[42
- (rear-nonsticky t create-time "19940610:18:55:57" creator "rsw@gnu.org"
idstamp 42 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:18:55:57" rear-nonsticky t
idstamp 42 kcell t)]
[33
- (rear-nonsticky t create-time "19940610:16:31:29" creator "rsw@gnu.org"
idstamp 33 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:16:31:29" rear-nonsticky t
idstamp 33 kcell t)]
[47
- (rear-nonsticky t no-fill t create-time "19951022:22:59:26" creator
"rsw@gnu.org" idstamp 47 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951022:22:59:26" no-fill t
rear-nonsticky t idstamp 47 kcell t)]
[8
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 8 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 8 kcell t)]
[28
- (rear-nonsticky t create-time "19940128:22:50:44" creator "rsw@gnu.org"
idstamp 28 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940128:22:50:44" rear-nonsticky t
idstamp 28 kcell t)]
[29
- (rear-nonsticky t create-time "19940128:22:50:54" creator "rsw@gnu.org"
idstamp 29 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940128:22:50:54" rear-nonsticky t
idstamp 29 kcell t)]
[10
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 10 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 10 kcell t)]
[30
- (rear-nonsticky t create-time "19940129:00:27:59" creator "rsw@gnu.org"
idstamp 30 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940129:00:27:59" rear-nonsticky t
idstamp 30 kcell t)]
[62
- (rear-nonsticky t no-fill t create-time "19951026:08:32:57" creator
"rsw@gnu.org" idstamp 62 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951026:08:32:57" no-fill t
rear-nonsticky t idstamp 62 kcell t)]
[70
- (rear-nonsticky t no-fill t create-time "19951030:19:18:49" creator
"rsw@gnu.org" idstamp 70 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951030:19:18:49" no-fill t
rear-nonsticky t idstamp 70 kcell t)]
[71
- (rear-nonsticky t no-fill t create-time "19951030:19:19:40" creator
"rsw@gnu.org" idstamp 71 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951030:19:19:40" no-fill t
rear-nonsticky t idstamp 71 kcell t)]
[73
- (rear-nonsticky t no-fill t create-time "19951030:19:23:09" creator
"rsw@gnu.org" idstamp 73 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951030:19:23:09" no-fill t
rear-nonsticky t idstamp 73 kcell t)]
[63
- (rear-nonsticky t no-fill t create-time "19951026:19:31:34" creator
"rsw@gnu.org" idstamp 63 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951026:19:31:34" no-fill t
rear-nonsticky t idstamp 63 kcell t)]
[64
- (rear-nonsticky t no-fill t create-time "19951026:19:33:01" creator
"rsw@gnu.org" idstamp 64 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951026:19:33:01" no-fill t
rear-nonsticky t idstamp 64 kcell t)]
[69
- (rear-nonsticky t no-fill t create-time "19951029:06:24:35" creator
"rsw@gnu.org" idstamp 69 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951029:06:24:35" no-fill t
rear-nonsticky t idstamp 69 kcell t)]
[68
- (rear-nonsticky t no-fill t create-time "19951029:06:24:27" creator
"rsw@gnu.org" idstamp 68 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951029:06:24:27" no-fill t
rear-nonsticky t idstamp 68 kcell t)]
[65
- (rear-nonsticky t no-fill t create-time "19951026:19:33:08" creator
"rsw@gnu.org" idstamp 65 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951026:19:33:08" no-fill t
rear-nonsticky t idstamp 65 kcell t)]
[66
- (rear-nonsticky t no-fill t create-time "19951026:19:33:15" creator
"rsw@gnu.org" idstamp 66 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951026:19:33:15" no-fill t
rear-nonsticky t idstamp 66 kcell t)]
[77
- (rear-nonsticky t no-fill t create-time "19980226:19:54:44" creator
"rsw@gnu.org" idstamp 77 kcell t)]
+ (creator "rsw@gnu.org" create-time "19980226:19:54:44" no-fill t
rear-nonsticky t idstamp 77 kcell t)]
[48
- (rear-nonsticky t no-fill t create-time "19951023:05:55:19" creator
"rsw@gnu.org" idstamp 48 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:05:55:19" no-fill t
rear-nonsticky t idstamp 48 kcell t)]
[57
- (rear-nonsticky t no-fill t create-time "19951023:10:07:06" creator
"rsw@gnu.org" idstamp 57 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:10:07:06" no-fill t
rear-nonsticky t idstamp 57 kcell t)]
[58
- (rear-nonsticky t no-fill t create-time "19951023:10:07:26" creator
"rsw@gnu.org" idstamp 58 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:10:07:26" no-fill t
rear-nonsticky t idstamp 58 kcell t)]
[49
- (rear-nonsticky t no-fill t create-time "19951023:05:55:55" creator
"rsw@gnu.org" idstamp 49 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:05:55:55" no-fill t
rear-nonsticky t idstamp 49 kcell t)]
[55
- (rear-nonsticky t no-fill t create-time "19951023:08:56:41" creator
"rsw@gnu.org" idstamp 55 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:08:56:41" no-fill t
rear-nonsticky t idstamp 55 kcell t)]
[50
- (rear-nonsticky t no-fill t create-time "19951023:05:57:26" creator
"rsw@gnu.org" idstamp 50 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:05:57:26" no-fill t
rear-nonsticky t idstamp 50 kcell t)]
[51
- (rear-nonsticky t no-fill t create-time "19951023:05:58:31" creator
"rsw@gnu.org" idstamp 51 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:05:58:31" no-fill t
rear-nonsticky t idstamp 51 kcell t)]
[56
- (rear-nonsticky t no-fill t create-time "19951023:08:57:09" creator
"rsw@gnu.org" idstamp 56 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:08:57:09" no-fill t
rear-nonsticky t idstamp 56 kcell t)]
[52
- (rear-nonsticky t no-fill t create-time "19951023:05:59:59" creator
"rsw@gnu.org" idstamp 52 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:05:59:59" no-fill t
rear-nonsticky t idstamp 52 kcell t)]
[53
- (rear-nonsticky t no-fill t create-time "19951023:06:00:48" creator
"rsw@gnu.org" idstamp 53 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:06:00:48" no-fill t
rear-nonsticky t idstamp 53 kcell t)]
[54
- (rear-nonsticky t no-fill t create-time "19951023:06:05:50" creator
"rsw@gnu.org" idstamp 54 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951023:06:05:50" no-fill t
rear-nonsticky t idstamp 54 kcell t)]
[26
- (rear-nonsticky t create-time "19940128:03:56:23" creator "rsw@gnu.org"
idstamp 26 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940128:03:56:23" rear-nonsticky t
idstamp 26 kcell t)]
[27
- (rear-nonsticky t create-time "19940128:22:36:54" creator "rsw@gnu.org"
idstamp 27 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940128:22:36:54" rear-nonsticky t
idstamp 27 kcell t)]
[59
- (rear-nonsticky t no-fill t create-time "19951024:03:40:05" creator
"rsw@gnu.org" idstamp 59 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951024:03:40:05" no-fill t
rear-nonsticky t idstamp 59 kcell t)]
[60
- (rear-nonsticky t no-fill t create-time "19951024:03:40:13" creator
"rsw@gnu.org" idstamp 60 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951024:03:40:13" no-fill t
rear-nonsticky t idstamp 60 kcell t)]
[61
- (rear-nonsticky t no-fill t create-time "19951024:03:40:42" creator
"rsw@gnu.org" idstamp 61 kcell t)]
+ (creator "rsw@gnu.org" create-time "19951024:03:40:42" no-fill t
rear-nonsticky t idstamp 61 kcell t)]
[1
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 1 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 1 kcell t)]
[11
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 11 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 11 kcell t)]
+ [80
+ (no-fill t create-time "20220117:22:26:40" creator "rsw@gnu.org" idstamp 80
kcell t fontified t)]
+ [81
+ (no-fill t create-time "20220117:22:26:47" creator "rsw@gnu.org" idstamp 81
kcell t fontified t)]
+ [78
+ (no-fill t create-time "20220117:22:26:33" creator "rsw@gnu.org" idstamp 78
kcell t fontified t)]
[12
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 12 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 12 kcell t)]
[44
- (rear-nonsticky t create-time "19940728:21:56:49" creator "rsw@gnu.org"
idstamp 44 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940728:21:56:49" rear-nonsticky t
idstamp 44 kcell t)]
[36
- (rear-nonsticky t create-time "19940610:16:49:34" creator "rsw@gnu.org"
idstamp 36 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:16:49:34" rear-nonsticky t
idstamp 36 kcell t)]
[37
- (rear-nonsticky t create-time "19940610:16:50:02" creator "rsw@gnu.org"
idstamp 37 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:16:50:02" rear-nonsticky t
idstamp 37 kcell t)]
[38
- (rear-nonsticky t create-time "19940610:16:50:13" creator "rsw@gnu.org"
idstamp 38 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940610:16:50:13" rear-nonsticky t
idstamp 38 kcell t)]
[13
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 13 kcell t)]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 13 kcell t)]
[16
- (rear-nonsticky t create-time "19940104:17:38:29" creator "rsw@gnu.org"
idstamp 16 kcell t)]
- nil nil nil nil nil nil nil nil nil nil nil nil nil nil nil nil]
+ (creator "rsw@gnu.org" create-time "19940104:17:38:29" rear-nonsticky t
idstamp 16 kcell t)]
+ nil nil nil nil nil nil nil nil nil nil nil nil nil nil nil nil nil]
diff --git a/man/hyperbole.html b/man/hyperbole.html
index 282b6e19af..a590376b7f 100644
--- a/man/hyperbole.html
+++ b/man/hyperbole.html
@@ -187,13 +187,14 @@ ul.no-bullet {list-style: none}
<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">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>
+ <li><a id="toc-Promoting-and-Demoting-1"
href="#Promoting-and-Demoting">7.5.2 Promoting and Demoting</a></li>
+ <li><a id="toc-Relocating-and-Copying-1"
href="#Relocating-and-Copying">7.5.3 Relocating and Copying</a></li>
+ <li><a id="toc-Moving-Around-1" href="#Moving-Around">7.5.4 Moving
Around</a></li>
+ <li><a id="toc-Filling-1" href="#Filling">7.5.5 Filling</a></li>
+ <li><a id="toc-Transposing-1" href="#Transposing">7.5.6
Transposing</a></li>
+ <li><a id="toc-Splitting-and-Appending-1"
href="#Splitting-and-Appending">7.5.7 Splitting and Appending</a></li>
+ <li><a id="toc-Inserting-and-Importing-1"
href="#Inserting-and-Importing">7.5.8 Inserting and Importing</a></li>
+ <li><a id="toc-Exporting-1" href="#Exporting">7.5.9 Exporting</a></li>
</ul></li>
<li><a id="toc-Viewing-1" href="#Viewing">7.6 Viewing</a>
<ul class="no-bullet">
@@ -614,6 +615,8 @@ Editing
</pre></th></tr><tr><td align="left" valign="top">• <a
href="#Adding-and-Killing">Adding and Killing</a></td><td> </td><td
align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">• <a
href="#Promoting-and-Demoting">Promoting and
Demoting</a></td><td> </td><td align="left" valign="top">
+</td></tr>
<tr><td align="left" valign="top">• <a
href="#Relocating-and-Copying">Relocating and
Copying</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="#Moving-Around">Moving
Around</a></td><td> </td><td align="left" valign="top">
@@ -2510,10 +2513,13 @@ Spacing between words within a button label is
irrelevant to Hyperbole.
Button labels may wrap across several lines without causing a problem;
just be sure to select the first line of the button to activate it.
</p>
-<p>Explicit buttons may be added to any editable text file; for source
-code files, simply place buttons within comments. Buttons that you
-use for quick navigation to websites or other things you do often
-should be added to your personal button file. See <a
href="#Button-Files">Button Files</a>.
+<p>Explicit buttons may be added to any editable buffer including
+temporary buffers without any attached files (such buttons will
+last only the length of a single Emacs session). For source code
+files, simply place Hyperbole explicit buttons within comments.
+Buttons that you use for quick navigation to websites or other things
+you do often should be added to your personal button file.
+See <a href="#Button-Files">Button Files</a>.
</p>
<span id="index-button_002c-moving"></span>
<span id="index-moving-buttons"></span>
@@ -2743,7 +2749,8 @@ the Org-mode standard binding of <kbd>{M-<span
class="key">RET</span>}</kbd>, <c
<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>.
-<kbd>{C-h h c o}</kbd> will customize this setting interactively.
+<kbd>{C-h h c o}</kbd> (minibuffer menu Cust/Org-M-RET) will interactively
customize
+this setting.
</p>
<p>The
following table summarizes the effect of this option setting.
@@ -2960,14 +2967,13 @@ when selected.
<span id="index-Request-For-Comment"></span>
<span id="index-RFC"></span>
<span id="index-remote-file"></span>
-<span id="index-ftp"></span>
+<span id="index-http"></span>
</dd>
<dt><code>rfc</code></dt>
<dd><p>Retrieve and display an Internet Request for Comments (RFC) standards
document referenced at point. The following formats are recognized:
RFC822, rfc-822, and RFC 822. The <code>hpath:rfc</code> variable specifies
-the location from which to retrieve RFCs. Requires the Emacs builtin
-Tramp library for ftp file retrievals.
+the location from which to retrieve RFCs via HTTP.
</p>
<span id="index-ibtypes-kbd_002dkey"></span>
<span id="index-key-series"></span>
@@ -3328,7 +3334,7 @@ like www.gnu.org, are also recognized.
<span id="index-hpath_003afind"></span>
<span id="index-hpath_003asuffixes"></span>
<span id="index-Tramp"></span>
-<span id="index-ftp-1"></span>
+<span id="index-ftp"></span>
<span id="index-pathname"></span>
<span id="index-remote-path"></span>
<span id="index-filename"></span>
@@ -3347,10 +3353,14 @@ details). Emacs Lisp library files (filenames without
any directory
component that end in .el and .elc) are located using
the <code>load-path</code> directory list.
</p>
+<span id="index-hpath_003avariable_002dregexp"></span>
+<span id="index-pathname-variables"></span>
<p>The pathname may contain references to Emacs Lisp variables or shell
environment variables using the syntax, \"${variable-name}\".
-See <a href="#Link-Variable-Substitution">Link Variable Substitution</a>, for
how this handled.
+See <a href="#Link-Variable-Substitution">Link Variable Substitution</a>, for
how this handled. The constant,
+<code>hpath:variable-regexp</code>, matches to this pattern within pathnames.
</p>
+
<p>See the function documentation for <code>hpath:at-p</code> for possible
delimiters. See the variable documentation for <code>hpath:suffixes</code> for
suffixes that are added to or removed from the pathname when searching
@@ -5393,26 +5403,28 @@ selected region, since that will destroy the outline
structure.
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Adding-and-Killing"
accesskey="1">Adding and Killing</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Relocating-and-Copying"
accesskey="2">Relocating and Copying</a></td><td> </td><td
align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Promoting-and-Demoting"
accesskey="2">Promoting and Demoting</a></td><td> </td><td
align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Relocating-and-Copying"
accesskey="3">Relocating and Copying</a></td><td> </td><td
align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Moving-Around"
accesskey="3">Moving Around</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#Moving-Around"
accesskey="4">Moving Around</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Filling"
accesskey="4">Filling</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#Filling"
accesskey="5">Filling</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Transposing"
accesskey="5">Transposing</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#Transposing"
accesskey="6">Transposing</a></td><td> </td><td align="left"
valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Splitting-and-Appending"
accesskey="6">Splitting and Appending</a></td><td> </td><td
align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Splitting-and-Appending"
accesskey="7">Splitting and Appending</a></td><td> </td><td
align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Inserting-and-Importing"
accesskey="7">Inserting and Importing</a></td><td> </td><td
align="left" valign="top">
+<tr><td align="left" valign="top">• <a href="#Inserting-and-Importing"
accesskey="8">Inserting and Importing</a></td><td> </td><td
align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a href="#Exporting"
accesskey="8">Exporting</a></td><td> </td><td align="left"
valign="top">
+<tr><td align="left" valign="top">• <a href="#Exporting"
accesskey="9">Exporting</a></td><td> </td><td align="left"
valign="top">
</td></tr>
</table>
<hr>
<span id="Adding-and-Killing"></span><div class="header">
<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>
+Next: <a href="#Promoting-and-Demoting" accesskey="n" rel="next">Promoting and
Demoting</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">7.5.1 Adding and
Killing</h4>
@@ -5444,13 +5456,12 @@ kills the entire contents of the cell regardless of the
location of
point. You may then yank the contents into another cell or another
buffer with <kbd>{C-y}</kbd>.
</p>
-
<hr>
-<span id="Relocating-and-Copying"></span><div class="header">
+<span id="Promoting-and-Demoting"></span><div class="header">
<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>
+Next: <a href="#Relocating-and-Copying" accesskey="n" rel="next">Relocating
and Copying</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">7.5.2
Relocating and Copying</h4>
+<span id="Promoting-and-Demoting-1"></span><h4 class="subsection">7.5.2
Promoting and Demoting</h4>
<span id="index-promotion"></span>
<span id="index-demotion"></span>
@@ -5527,6 +5538,12 @@ moves between fields within a table.
|----------------------------+-----------------------------|
</pre></div>
+<hr>
+<span id="Relocating-and-Copying"></span><div class="header">
+<p>
+Next: <a href="#Moving-Around" accesskey="n" rel="next">Moving Around</a>,
Previous: <a href="#Promoting-and-Demoting" accesskey="p" rel="prev">Promoting
and Demoting</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">7.5.3
Relocating and Copying</h4>
<span id="index-tree_002c-copying"></span>
<span id="index-tree_002c-moving"></span>
@@ -5627,7 +5644,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">7.5.3 Moving
Around</h4>
+<span id="Moving-Around-1"></span><h4 class="subsection">7.5.4 Moving
Around</h4>
<span id="index-outline_002c-motion"></span>
<p>In addition to normal emacs movement commands, you can move within a
@@ -5696,7 +5713,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">7.5.4 Filling</h4>
+<span id="Filling-1"></span><h4 class="subsection">7.5.5 Filling</h4>
<span id="index-outline_002c-filling"></span>
<span id="index-filling"></span>
@@ -5741,7 +5758,7 @@ a ‘no-fill’ property, then your formatting
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">7.5.5 Transposing</h4>
+<span id="Transposing-1"></span><h4 class="subsection">7.5.6 Transposing</h4>
<p>The Koutliner move and copy commands rearrange entire trees. The
following two commands, in contrast, exchange the locations of two
@@ -5773,7 +5790,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">7.5.6
Splitting and Appending</h4>
+<span id="Splitting-and-Appending-1"></span><h4 class="subsection">7.5.7
Splitting and Appending</h4>
<span id="index-splitting-a-cell"></span>
<span id="index-cell_002c-splitting"></span>
@@ -5805,7 +5822,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">7.5.7
Inserting and Importing</h4>
+<span id="Inserting-and-Importing-1"></span><h4 class="subsection">7.5.8
Inserting and Importing</h4>
<span id="index-outline_002c-inserting-into"></span>
<span id="index-outline_002c-importing-into"></span>
@@ -5894,24 +5911,32 @@ 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">7.5.8 Exporting</h4>
+<span id="Exporting-1"></span><h4 class="subsection">7.5.9 Exporting</h4>
<span id="index-outline_002c-exporting-from"></span>
<span id="index-outline_002c-HTML-conversion"></span>
<span id="index-exporting"></span>
<span id="index-HTML-conversion"></span>
-<span id="index-kexport_003ahtml"></span>
<p>Koutlines may be <em>exported</em> to other file formats. Presently, the
only format supported is conversion to HTML for publishing on the
World-Wide Web.
</p>
-<p><kbd>{M-x kexport:html <span class="key">RET</span>}</kbd> prompts for the
koutline buffer or
-file to export, the HTML file or buffer to which to output, and the
-title to use for the HTML file. Completion of filenames is provided.
+<span id="index-kexport_003adisplay"></span>
+<span id="index-browse_002durl_002dbrowser_002dfunction-2"></span>
+<p><kbd>{M-x kexport:display <span class="key">RET</span>}</kbd> exports the
current Koutline buffer
+to a temporary HTML file and displays the file in the web browser given by
+<code>browse-url-browser-function</code>. Any tree in the HTML outline may be
+expanded or collapsed by clicking the left mouse button on its root cell,
+for ease of viewing.
+</p>
+<span id="index-kexport_003ahtml"></span>
+<p>Alternatively, <kbd>{M-x kexport:html <span class="key">RET</span>}</kbd>
prompts for the koutline
+buffer or file to export, the HTML file or buffer to which to output, and
+the title to use for the HTML file. Completion of filenames is provided.
The conversion will then be done and the output file or buffer will be
-written; the output file will not be displayed.
+written; the output file will not be displayed. You must display it
+manually if desired.
</p>
-
<hr>
<span id="Viewing"></span><div class="header">
<p>
@@ -6226,6 +6251,21 @@ and to label cells with the alphanumeric style.
</p></dd>
</dl>
+<span id="index-klink_003aignore_002dmodes"></span>
+<span id="index-klink_003ac_002dstyle_002dmodes"></span>
+<span id="index-modes-to-ignore-klinks"></span>
+<span id="index-klinks_002c-ignoring"></span>
+<p>Because klinks use a very generic syntax, surrounded by <angle
brackets>,
+in certain modes, mostly C-based programming modes, certain non-klink syntax
+can be mistakenly identified as klinks. Therefore, the Koutliner provides
+two customizable variables which disable klink recognition in selected major
+modes, <code>klink:ignore-modes</code> and <code>klink:c-style-modes</code>.
Add a mode
+to one of these if you find any syntax that improperly registers as a klink.
+</p>
+<p>* kotl/klink.el (klink:ignore-modes, klink:c-style-modes): Add so
+ can customize.
+</p>
+
<hr>
<span id="Cell-Attributes"></span><div class="header">
<p>
@@ -8747,7 +8787,6 @@ Internal Image Display hpath:native-image-suffixes
Internal Custom Display hpath:internal-display-alist
External Display hpath:external-display-alist
Internal Standard Display hpath:display-where
-
</pre></div>
<p>Continue reading the next sections for information on how referents
@@ -8858,7 +8897,7 @@ Next: <a href="#Link-Variable-Substitution" accesskey="n"
rel="next">Link Variab
<span id="index-link_002c-viewer-program"></span>
<span id="index-external-display-1"></span>
-<span id="index-hpath_003aexternal_002ddisplay_002dalist"></span>
+<span id="index-hpath_003aget_002dexternal_002ddisplay_002dalist-1"></span>
<p>If you use Hyperbole under a window system,
the <code>hpath:get-external-display-alist</code> function in
<samp>hpath.el</samp>
supports hyperlinks that open files using external, non-Emacs tools, e.g.
@@ -8883,6 +8922,13 @@ for each available window system:
<code>hpath:external-display-alist-macos</code
<code>hpath:external-display-alist-x</code>. Examine and modify these
values to suit your needs.
</p>
+<span id="index-hpath_003aexternal_002dfile_002dsuffixes"></span>
+<p>Part of these values for each operating system come from the
+variable, <code>hpath:external-file-suffixes</code>’, which holds a
regular
+expression of operating system independent file suffixes to open outside
+Emacs.
+</p>
+
<hr>
<span id="Link-Variable-Substitution"></span><div class="header">
@@ -8965,7 +9011,7 @@ Next: <a href="#Invisible-Text-Searches" accesskey="n"
rel="next">Invisible Text
<span id="index-remote-pathnames"></span>
<p>Hyperbole always recognizes URLs within buffers when the Action Key is
pressed on them. But sometimes it is useful to enter a URL at a prompt
-and have it displayed. Hyperbole can recognize ftp and www URLs given to
+and have it displayed. Hyperbole can recognize s/ftp and www URLs given to
the <code>find-file</code> command (or any other <code>find-file-*</code>
commands).
But because there is added overhead with this feature, it is not enabled by
default.
@@ -11210,7 +11256,8 @@ Next: <a href="#Smart-Key-_002d-Java-Source-Code"
accesskey="n" rel="next">Smart
(Lisp code, debugger, compilation, or help) or in change-log-mode
on an Emacs Lisp bound identifier:
ACTION KEY
- Jumps to the definition of any selected Lisp construct. If on an
+ Jumps to the definition of any selected Lisp construct. This includes
+ Hyperbole implicit button type and action type references. If on an
Emacs Lisp require, load, or autoload clause and the (find-library)
function is defined, jumps to the library source, if possible.
ASSIST KEY
@@ -11689,7 +11736,7 @@ Next: <a href="#Smart-Key-_002d-HyRolo-Match-Buffers"
accesskey="n" rel="next">S
<span id="index-click_002c-world_002dwide-web"></span>
<span id="index-W3"></span>
<span id="index-URL-2"></span>
-<span id="index-browse_002durl_002dbrowser_002dfunction-2"></span>
+<span id="index-browse_002durl_002dbrowser_002dfunction-3"></span>
<span id="index-World_002dwide-Web-2"></span>
<span id="index-WWW-2"></span>
<span id="index-C_002dh-h-c-u-1"></span>
@@ -12640,12 +12687,12 @@ Next: <a href="#Function" accesskey="n"
rel="next">Function</a>, Previous: <a hr
<tr><td></td><td valign="top"><a
href="#index-koutliner_002c-C_002dx-i"><code>koutliner, C-x
i</code></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-koutliner_002c-C_002dy"><code>koutliner,
C-y</code></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-koutliner_002c-M_002d0-C_002dc-t"><code>koutliner, M-0 C-c
t</code></a>:</td><td> </td><td valign="top"><a
href="#Transposing">Transposing</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-koutliner_002c-M_002d1-TAB"><code>koutliner, M-1 <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-koutliner_002c-M_002d1-TAB"><code>koutliner, M-1 <span
class="key">TAB</span></code></a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-koutliner_002c-M_002dj"><code>koutliner,
M-j</code></a>:</td><td> </td><td valign="top"><a
href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-koutliner_002c-M_002dq"><code>koutliner,
M-q</code></a>:</td><td> </td><td valign="top"><a
href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-koutliner_002c-M_002dRET"><code>koutliner, M-<span
class="key">RET</span></code></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-koutliner_002c-M_002dTAB"><code>koutliner, 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-koutliner_002c-TAB"><code>koutliner, <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-koutliner_002c-M_002dTAB"><code>koutliner, M-<span
class="key">TAB</span></code></a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-koutliner_002c-TAB"><code>koutliner, <span
class="key">TAB</span></code></a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Key-Index_ky_letter-L">L</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-l"><code>l</code></a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
@@ -12653,8 +12700,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_002d0-M_002dTAB"><code>M-0
M-<span class="key">TAB</span></code></a>:</td><td> </td><td
valign="top"><a href="#Promoting-and-Demoting">Promoting and
Demoting</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="#Promoting-and-Demoting">Promoting and Demoting</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>
@@ -12988,7 +13035,8 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><th id="Function_fn_letter-B">B</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-browse_002durl_002dbrowser_002dfunction">browse-url-browser-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-browse_002durl_002dbrowser_002dfunction-1">browse-url-browser-function</a>:</td><td> </td><td
valign="top"><a href="#Action-Types">Action Types</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-browse_002durl_002dbrowser_002dfunction-2">browse-url-browser-function</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-browse_002durl_002dbrowser_002dfunction-2">browse-url-browser-function</a>:</td><td> </td><td
valign="top"><a href="#Exporting">Exporting</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-browse_002durl_002dbrowser_002dfunction-3">browse-url-browser-function</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW
URLs</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Function_fn_letter-C">C</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-c_002b_002b_002dcpp_002dinclude_002dpath">c++-cpp-include-path</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-C_002b_002b-Source-Code">Smart Key -
C++ Source Code</a></td></tr>
@@ -13117,17 +13165,19 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-hpath_003adisplay_002dwhere-1">hpath:display-where</a>:</td><td> </td><td
valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hpath_003adisplay_002dwhere-2">hpath:display-where</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-hpath_003adisplay_002dwhere-3">hpath:display-where</a>:</td><td> </td><td
valign="top"><a href="#Smart-Key-_002d-Magit-Mode">Smart Key - Magit
Mode</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-hpath_003aexternal_002ddisplay_002dalist">hpath:external-display-alist</a>:</td><td> </td><td
valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hpath_003aexternal_002ddisplay_002dalist_002dmacos">hpath:external-display-alist-macos</a>:</td><td> </td><td
valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hpath_003aexternal_002ddisplay_002dalist_002dmswindows">hpath:external-display-alist-mswindows</a>:</td><td> </td><td
valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hpath_003aexternal_002ddisplay_002dalist_002dx">hpath:external-display-alist-x</a>:</td><td> </td><td
valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hpath_003aexternal_002dfile_002dsuffixes">hpath:external-file-suffixes</a>:</td><td> </td><td
valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hpath_003afind"><code>hpath:find</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-hpath_003afind_002dfile_002durls_002dmode"><code>hpath:find-file-urls-mode</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-hpath_003aget_002dexternal_002ddisplay_002dalist"><code>hpath:get-external-display-alist</code></a>:</td><td> </td><td
valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-hpath_003aget_002dexternal_002ddisplay_002dalist-1"><code>hpath:get-external-display-alist</code></a>:</td><td> </td><td
valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-hpath_003ainternal_002ddisplay_002dalist">hpath:internal-display-alist</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-hpath_003ainternal_002ddisplay_002dalist-1">hpath:internal-display-alist</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-hpath_003anative_002dimage_002dsuffixes">hpath:native-image-suffixes</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-hpath_003asuffixes">hpath:suffixes</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-hpath_003avariable_002dregexp">hpath:variable-regexp</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-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>
@@ -13271,6 +13321,7 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Function_fn_letter-K">K</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-kcell_003aref_002dto_002did"><code>kcell:ref-to-id</code></a>:</td><td> </td><td
valign="top"><a href="#Action-Types">Action Types</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-kexport_003adisplay"><code>kexport:display</code></a>:</td><td> </td><td
valign="top"><a href="#Exporting">Exporting</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-kexport_003ahtml"><code>kexport:html</code></a>:</td><td> </td><td
valign="top"><a href="#Exporting">Exporting</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-kfile_003afind"><code>kfile:find</code></a>:</td><td> </td><td
valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-kfile_003awrite"><code>kfile:write</code></a>:</td><td> </td><td
valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
@@ -13284,8 +13335,10 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-kimport_003astar_002doutline"><code>kimport:star-outline</code></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-kimport_003asuffix_002dalist">kimport:suffix-alist</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-kimport_003atext"><code>kimport:text</code></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-klink_003ac_002dstyle_002dmodes">klink:c-style-modes</a>:</td><td> </td><td
valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-klink_003acreate"><code>klink:create</code></a>:</td><td> </td><td
valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-klink_003acreate-1"><code>klink:create</code></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-klink_003aignore_002dmodes">klink:ignore-modes</a>:</td><td> </td><td
valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-kotl_002dmode"><code>kotl-mode</code></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-kotl_002dmode-1"><code>kotl-mode</code></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-kotl_002dmode_002dhook">kotl-mode-hook</a>:</td><td> </td><td
valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
@@ -13345,7 +13398,7 @@ Next: <a href="#Concept-Index" accesskey="n"
rel="next">Concept Index</a>, Previ
<tr><td></td><td valign="top"><a
href="#index-kotl_002dmode_003ahide_002dtree-1"><code>kotl-mode:hide-tree</code></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-kotl_002dmode_003aindent_002dline"><code>kotl-mode:indent-line</code></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-kotl_002dmode_003aindent_002dregion"><code>kotl-mode:indent-region</code></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-kotl_002dmode_003aindent_002dtabs_002dmode">kotl-mode:indent-tabs-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-kotl_002dmode_003aindent_002dtabs_002dmode">kotl-mode:indent-tabs-mode</a>:</td><td> </td><td
valign="top"><a href="#Promoting-and-Demoting">Promoting and
Demoting</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-kotl_002dmode_003ajust_002done_002dspace"><code>kotl-mode:just-one-space</code></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-kotl_002dmode_003akill_002dcontents"><code>kotl-mode:kill-contents</code></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-kotl_002dmode_003akill_002dline"><code>kotl-mode:kill-line</code></a>:</td><td> </td><td
valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
@@ -13796,7 +13849,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-delimited-things">delimited
things</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-demo-file">demo
file</a>:</td><td> </td><td valign="top"><a href="#Manual-Overview">Manual
Overview</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-demonstration">demonstration</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-demotion">demotion</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-demotion">demotion</a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-diagonal-drag">diagonal
drag</a>:</td><td> </td><td valign="top"><a
href="#Saving-and-Restoring-Window-Configurations">Saving and Restoring Window
Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-diagonal-drag-1">diagonal
drag</a>:</td><td> </td><td valign="top"><a
href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a
Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-digital-signature">digital
signature</a>:</td><td> </td><td valign="top"><a
href="#Glossary">Glossary</a></td></tr>
@@ -13931,7 +13984,6 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-frame_002c-zoom">frame,
zoom</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frames-control">frames
control</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-ftp">ftp</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-ftp-1">ftp</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-function">function</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-function-1">function</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-functon-call-implicit-button">functon call implicit
button</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
@@ -13988,6 +14040,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-horizontal-drag-1">horizontal
drag</a>:</td><td> </td><td valign="top"><a
href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a
Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HTML-conversion">HTML
conversion</a>:</td><td> </td><td valign="top"><a
href="#Exporting">Exporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HTML-tag-pair">HTML tag
pair</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-http">http</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-HyControl">HyControl</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-HyControl-corner-placement">HyControl corner
placement</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-HyControl-edge-placement">HyControl edge
placement</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
@@ -14072,7 +14125,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<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>
<tr><td></td><td valign="top"><a
href="#index-initialization-file">initialization
file</a>:</td><td> </td><td valign="top"><a
href="#Autonumbering">Autonumbering</a></td></tr>
<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-inserting-tabs">inserting
tabs</a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</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="#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>
@@ -14147,12 +14200,13 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-klink_002c-inserting">klink,
inserting</a>:</td><td> </td><td valign="top"><a
href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_002c-internal">klink,
internal</a>:</td><td> </td><td valign="top"><a
href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_002c-view-spec">klink,
view spec</a>:</td><td> </td><td valign="top"><a
href="#Links">Links</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-klinks_002c-ignoring">klinks,
ignoring</a>:</td><td> </td><td valign="top"><a
href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-knowledge-transfer">knowledge
transfer</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-koutline-link">koutline
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-koutline-mode">koutline
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-Koutliner-commands">Koutliner
commands</a>:</td><td> </td><td valign="top"><a href="#Menu-Commands">Menu
Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Koutliner-menu">Koutliner
menu</a>:</td><td> </td><td valign="top"><a href="#Menu-Commands">Menu
Commands</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-Koutliner_002c-toggle-tab-behavior">Koutliner, toggle tab
behavior</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-Koutliner_002c-toggle-tab-behavior">Koutliner, toggle tab
behavior</a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Concept-Index_cp_letter-L">L</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-label-separator_002c-changing">label separator,
changing</a>:</td><td> </td><td valign="top"><a
href="#Autonumbering">Autonumbering</a></td></tr>
@@ -14332,6 +14386,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-modeline_002c-Smart-Keys">modeline, Smart
Keys</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-modeline_002c-unbury-buffer">modeline, unbury
buffer</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-modeline_002c-view-spec">modeline, 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-modes-to-ignore-klinks">modes to
ignore klinks</a>:</td><td> </td><td valign="top"><a
href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-mouse">mouse</a>:</td><td> </td><td valign="top"><a
href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse-bindings">mouse
bindings</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-mouse-drag_002c-link-creation">mouse drag, link
creation</a>:</td><td> </td><td valign="top"><a href="#By-Dragging">By
Dragging</a></td></tr>
@@ -14367,13 +14422,13 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<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-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-tables">Org
tables</a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</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="#Relocating-and-Copying">Relocating and Copying</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="#Promoting-and-Demoting">Promoting and Demoting</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>
@@ -14417,6 +14472,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<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-variables">pathname
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-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>
<tr><td></td><td valign="top"><a
href="#index-permanent-identifier-1">permanent
identifier</a>:</td><td> </td><td valign="top"><a
href="#Idstamps">Idstamps</a></td></tr>
@@ -14431,7 +14487,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<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>
+<tr><td></td><td valign="top"><a
href="#index-promotion">promotion</a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-proportional-scrolling">proportional
scrolling</a>:</td><td> </td><td valign="top"><a
href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-proportional-scrolling-1">proportional
scrolling</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart
Scrolling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pulldown-menu">pulldown
menu</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
@@ -14578,7 +14634,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-table-of-contents">table of
contents</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-table-of-contents-1">table of
contents</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-table-of-contents-2">table of
contents</a>:</td><td> </td><td valign="top"><a
href="#Action-Types">Action Types</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-tabs_002c-inserting">tabs,
inserting</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-tabs_002c-inserting">tabs,
inserting</a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-tag">tag</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-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-tags-file">tags
file</a>:</td><td> </td><td valign="top"><a
href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
@@ -14608,14 +14664,14 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-Tramp-1">Tramp</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-transposing-cells">transposing
cells</a>:</td><td> </td><td valign="top"><a
href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-copying">tree,
copying</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-tree_002c-demoting">tree,
demoting</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-tree_002c-demoting">tree,
demoting</a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-exporting">tree,
exporting</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-tree_002c-filling">tree,
filling</a>:</td><td> </td><td valign="top"><a
href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-hide-subtree">tree,
hide subtree</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-tree_002c-killing">tree,
killing</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-tree_002c-mailing">tree,
mailing</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-tree_002c-moving">tree,
moving</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-tree_002c-promoting">tree,
promoting</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-tree_002c-promoting">tree,
promoting</a>:</td><td> </td><td valign="top"><a
href="#Promoting-and-Demoting">Promoting and Demoting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-show">tree,
show</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-tree_002c-show-1">tree,
show</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-tree_002c-show-subtree">tree,
show subtree</a>:</td><td> </td><td valign="top"><a
href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
diff --git a/man/hyperbole.info b/man/hyperbole.info
index 906d723d70..4aa2b930b0 100644
Binary files a/man/hyperbole.info and b/man/hyperbole.info differ
diff --git a/man/hyperbole.pdf b/man/hyperbole.pdf
index 03989b51a7..75071b038e 100644
Binary files a/man/hyperbole.pdf and b/man/hyperbole.pdf differ
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index 70a4099e01..5192ef4e6a 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -358,6 +358,7 @@ Koutliner
Editing
* Adding and Killing::
+* Promoting and Demoting::
* Relocating and Copying::
* Moving Around::
* Filling::
@@ -1923,10 +1924,13 @@ Spacing between words within a button label is
irrelevant to Hyperbole.
Button labels may wrap across several lines without causing a problem;
just be sure to select the first line of the button to activate it.
-Explicit buttons may be added to any editable text file; for source
-code files, simply place buttons within comments. Buttons that you
-use for quick navigation to websites or other things you do often
-should be added to your personal button file. @xref{Button Files}.
+Explicit buttons may be added to any editable buffer including
+temporary buffers without any attached files (such buttons will
+last only the length of a single Emacs session). For source code
+files, simply place Hyperbole explicit buttons within comments.
+Buttons that you use for quick navigation to websites or other things
+you do often should be added to your personal button file.
+@xref{Button Files}.
@cindex button, moving
@cindex moving buttons
@@ -2142,7 +2146,8 @@ the Org-mode standard binding of @bkbd{M-@key{RET}},
@code{org-meta-return}.
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}.
-@bkbd{C-h h c o} will customize this setting interactively.
+@bkbd{C-h h c o} (minibuffer menu Cust/Org-M-RET) will interactively customize
+this setting.
The
following table summarizes the effect of this option setting.
@@ -2342,13 +2347,12 @@ when selected.
@cindex Request For Comment
@cindex RFC
@cindex remote file
-@cindex ftp
+@cindex http
@item rfc
Retrieve and display an Internet Request for Comments (RFC) standards
document referenced at point. The following formats are recognized:
RFC822, rfc-822, and RFC 822. The @code{hpath:rfc} variable specifies
-the location from which to retrieve RFCs. Requires the Emacs builtin
-Tramp library for ftp file retrievals.
+the location from which to retrieve RFCs via HTTP.
@findex ibtypes kbd-key
@cindex key series
@@ -2702,10 +2706,14 @@ details). Emacs Lisp library files (filenames without
any directory
component that end in .el and .elc) are located using
the @code{load-path} directory list.
+@vindex hpath:variable-regexp
+@cindex pathname variables
@noindent
The pathname may contain references to Emacs Lisp variables or shell
environment variables using the syntax, \"$@{variable-name@}\".
-@xref{Link Variable Substitution}, for how this handled.
+@xref{Link Variable Substitution}, for how this handled. The constant,
+@code{hpath:variable-regexp}, matches to this pattern within pathnames.
+
@noindent
See the function documentation for @code{hpath:at-p} for possible
@@ -4519,6 +4527,7 @@ selected region, since that will destroy the outline
structure.
@menu
* Adding and Killing::
+* Promoting and Demoting::
* Relocating and Copying::
* Moving Around::
* Filling::
@@ -4528,7 +4537,7 @@ selected region, since that will destroy the outline
structure.
* Exporting::
@end menu
-@node Adding and Killing, Relocating and Copying, Editing, Editing
+@node Adding and Killing, Promoting and Demoting, Editing, Editing
@subsection Adding and Killing
@kindex koutliner, C-j
@@ -4559,9 +4568,8 @@ kills the entire contents of the cell regardless of the
location of
point. You may then yank the contents into another cell or another
buffer with @bkbd{C-y}.
-
-@node Relocating and Copying, Moving Around, Adding and Killing, Editing
-@subsection Relocating and Copying
+@node Promoting and Demoting, Relocating and Copying, Adding and Killing,
Editing
+@subsection Promoting and Demoting
@cindex promotion
@cindex demotion
@@ -4639,6 +4647,8 @@ moves between fields within a table.
|----------------------------+-----------------------------|
@end example
+@node Relocating and Copying, Moving Around, Promoting and Demoting, Editing
+@subsection Relocating and Copying
@cindex tree, copying
@cindex tree, moving
@@ -4941,17 +4951,25 @@ create.
@cindex outline, HTML conversion
@cindex exporting
@cindex HTML conversion
-@findex kexport:html
Koutlines may be @dfn{exported} to other file formats. Presently, the
only format supported is conversion to HTML for publishing on the
World-Wide Web.
-@bkbd{M-x kexport:html @key{RET}} prompts for the koutline buffer or
-file to export, the HTML file or buffer to which to output, and the
-title to use for the HTML file. Completion of filenames is provided.
-The conversion will then be done and the output file or buffer will be
-written; the output file will not be displayed.
+@findex kexport:display
+@vindex browse-url-browser-function
+@bkbd{M-x kexport:display @key{RET}} exports the current Koutline buffer
+to a temporary HTML file and displays the file in the web browser given by
+@code{browse-url-browser-function}. Any tree in the HTML outline may be
+expanded or collapsed by clicking the left mouse button on its root cell,
+for ease of viewing.
+@findex kexport:html
+Alternatively, @bkbd{M-x kexport:html @key{RET}} prompts for the koutline
+buffer or file to export, the HTML file or buffer to which to output, and
+the title to use for the HTML file. Completion of filenames is provided.
+The conversion will then be done and the output file or buffer will be
+written; the output file will not be displayed. You must display it
+manually if desired.
@node Viewing, Links, Editing, Koutliner
@section Viewing
@@ -5233,6 +5251,21 @@ outline to display blank lines, to use ellipses after
collapsed lines
and to label cells with the alphanumeric style.
@end table
+@vindex klink:ignore-modes
+@vindex klink:c-style-modes
+@cindex modes to ignore klinks
+@cindex klinks, ignoring
+Because klinks use a very generic syntax, surrounded by <angle brackets>,
+in certain modes, mostly C-based programming modes, certain non-klink syntax
+can be mistakenly identified as klinks. Therefore, the Koutliner provides
+two customizable variables which disable klink recognition in selected major
+modes, @code{klink:ignore-modes} and @code{klink:c-style-modes}. Add a mode
+to one of these if you find any syntax that improperly registers as a klink.
+
+* kotl/klink.el (klink:ignore-modes, klink:c-style-modes): Add so
+ can customize.
+
+
@node Cell Attributes, Koutliner History, Links, Koutliner
@section Cell Attributes
@@ -7473,7 +7506,6 @@ Internal Image Display hpath:native-image-suffixes
Internal Custom Display hpath:internal-display-alist
External Display hpath:external-display-alist
Internal Standard Display hpath:display-where
-
@end example
@noindent
@@ -7572,7 +7604,7 @@ external, window-system specific viewers.
@cindex link, viewer program
@cindex external display
-@vindex hpath:external-display-alist
+@findex hpath:get-external-display-alist
If you use Hyperbole under a window system,
the @code{hpath:get-external-display-alist} function in @file{hpath.el}
supports hyperlinks that open files using external, non-Emacs tools, e.g.@:
@@ -7597,6 +7629,13 @@ for each available window system:
@code{hpath:external-display-alist-macos},
@code{hpath:external-display-alist-x}. Examine and modify these
values to suit your needs.
+@vindex hpath:external-file-suffixes
+Part of these values for each operating system come from the
+variable, @code{hpath:external-file-suffixes}', which holds a regular
+expression of operating system independent file suffixes to open outside
+Emacs.
+
+
@c @cindex MIME
@c @cindex mailcap
@c @cindex external viewer
@@ -7676,7 +7715,7 @@ Cust/Web-Search menu. Below is the equivalent Hyperbole
menubar menu.
@cindex remote pathnames
Hyperbole always recognizes URLs within buffers when the Action Key is
pressed on them. But sometimes it is useful to enter a URL at a prompt
-and have it displayed. Hyperbole can recognize ftp and www URLs given to
+and have it displayed. Hyperbole can recognize s/ftp and www URLs given to
the @code{find-file} command (or any other @code{find-file-*} commands).
But because there is added overhead with this feature, it is not enabled by
default.
@@ -9681,7 +9720,8 @@ When pressed on a Lisp symbol within any of these types
of buffers
(Lisp code, debugger, compilation, or help) or in change-log-mode
on an Emacs Lisp bound identifier:
ACTION KEY
- Jumps to the definition of any selected Lisp construct. If on an
+ Jumps to the definition of any selected Lisp construct. This includes
+ Hyperbole implicit button type and action type references. If on an
Emacs Lisp require, load, or autoload clause and the (find-library)
function is defined, jumps to the library source, if possible.
ASSIST KEY