branch: externals/hyperbole
commit bac4fd78fbbae8963b1a6433e7eabdcf6fe17dba
Author: bw <[email protected]>
Commit: bw <[email protected]>
hui.el - Eliminate recursive require with 'hywiki
---
README.toc.md | 31 +++++++++++++++++++++++++++----
hui.el | 5 +++--
hywiki.el | 4 ++--
kotl/kotl-mode.el | 8 +++++---
4 files changed, 37 insertions(+), 11 deletions(-)
diff --git a/README.toc.md b/README.toc.md
index 18cb88f5d8..0231bc28e0 100644
--- a/README.toc.md
+++ b/README.toc.md
@@ -7,11 +7,10 @@
send us a thank you or a testimonial describing your usage if you like
Hyperbole to [[email protected]](mailto:[email protected])].
-
-
- [GNU Hyperbole 9.0.2pre - The Everyday Hypertextual Information
Manager](#gnu-hyperbole-902pre---the-everyday-hypertextual-information-manager)
- [Reference Manual](#reference-manual)
- [Videos](#videos)
+ - [Articles](#articles)
- [Summary](#summary)
- [Installation](#installation)
- [Invocation](#invocation)
@@ -26,8 +25,6 @@
- [User Quotes](#user-quotes)
- [Why was Hyperbole developed?](#why-was-hyperbole-developed)
-
-
## Reference Manual
@@ -74,6 +71,30 @@ otherwise, skip to the next section.
- [Linking personal info with implicit
buttons](https://youtu.be/TQ_fG7b1iHI)
+## Articles
+
+ - [HyWiki: My Favorite Part of
Hyperbole](https://kirankp.com/blog/gnu-hyperbole/)
+
+ - [Hyperbole VisionQuest Part
1](https://github.com/termitereform/JunkPile/blob/master/HyperboleNotes.org)
+
+ - [Hyperbole VisionQuest Part
2](https://github.com/termitereform/JunkPile/blob/master/HyperboleNotes2.org)
+
+ - [A Taste of
Hyperbole](https://www.reddit.com/r/emacs/comments/1kty4mb/a_taste_of_hyperbole_automatically_linking_to_org/)
+
+ - [My Understanding of GNU
Hyperbole](https://www.reddit.com/r/emacs/comments/nirwpk/my_understanding_of_gnu_hyperbole/)
+
+ - [What does GNU Hyperbole
do?](https://tilde.town/~ramin_hal9001/articles/intro-to-hyperbole.html)
+
+ - [John Wiegley - The Philosophy Behind
Hyperbole](https://mail.gnu.org/archive/html/hyperbole-users/2019-01/msg00037.html)
+
+ - [Daily ways GNU Hyperbole helps me stay in flow and reduces cognitive
load](https://www.reddit.com/r/emacs/comments/jk3cn0/daily_ways_gnu_hyperbole_helps_me_stay_in_flow/)
+
+ - [Doing a Research Project and using GNU Hyperbole's Integrated
Features](https://www.reddit.com/r/emacs/comments/1g2184d/doing_a_research_project_and_using_gnu_hyperboles/)
+
+ - [AI-generated Hyperbole Architectural
Documentation](https://deepwiki.com/rswgnu/hyperbole)
+
+ - [Hypermedia and
Hyperbole](https://www.mgmarlow.com/words/2023-10-26-hyperbole/)
+
## Summary
`GNU Hyperbole` (pronounced Ga-new Hi-per-bo-lee), or just `Hyperbole`, is
@@ -255,6 +276,8 @@ window control menu if it was not already bound prior to
Hyperbole's
initialization. A long video demonstrating many of HyControl's
features is available at https://youtu.be/M3-aMh1ccJk.
+## Hyperbole Manual
+
The above are the best interactive ways to learn about Hyperbole.
Hyperbole also includes the Hyperbole Manual, a full reference manual,
not a simple introduction. It is included in the "man/" subdirectory
diff --git a/hui.el b/hui.el
index f818c7edb3..3a2f55714e 100644
--- a/hui.el
+++ b/hui.el
@@ -3,7 +3,7 @@
;; Author: Bob Weiner
;;
;; Orig-Date: 19-Sep-91 at 21:42:03
-;; Last-Mod: 19-Feb-26 at 00:29:40 by Bob Weiner
+;; Last-Mod: 19-Feb-26 at 01:08:15 by Bob Weiner
;;
;; SPDX-License-Identifier: GPL-3.0-or-later
;;
@@ -27,7 +27,6 @@
(require 'hmail)
(require 'hbut)
(eval-when-compile (require 'hactypes))
-(eval-when-compile (require 'hywiki)) ;; Because 'hyperbole' requires this too
;;; ************************************************************************
;;; Public declarations
@@ -38,8 +37,10 @@
(defvar completion-to-accept) ; "completion.el"
(defvar hyperbole-mode-map) ; "hyperbole.el"
+(declare-function actypes::link-to-wikiword "hywiki")
(declare-function bookmark-bmenu-bookmark "bookmark")
(declare-function hui:menu-choose "hui-mini")
+(declare-function hywiki-referent-exists-p "hywiki")
(declare-function kcell-view:absolute-reference "kotl/kview")
(declare-function kcell-view:idstamp "kotl/kview")
(declare-function klink:absolute "kotl/klink")
diff --git a/hywiki.el b/hywiki.el
index 2b7bacaa90..0d7e5cb315 100644
--- a/hywiki.el
+++ b/hywiki.el
@@ -3,7 +3,7 @@
;; Author: Bob Weiner
;;
;; Orig-Date: 21-Apr-24 at 22:41:13
-;; Last-Mod: 19-Feb-26 at 00:57:14 by Bob Weiner
+;; Last-Mod: 19-Feb-26 at 01:08:50 by Bob Weiner
;;
;; SPDX-License-Identifier: GPL-3.0-or-later
;;
@@ -144,7 +144,7 @@
(require 'hpath)
(require 'hproperty)
(require 'hsys-consult)
-(eval-when-compile (require 'hui)) ;; For `hui:actype'
+(require 'hui) ;; For `hui:actype'
(require 'hui-mini) ;; For `hui:menu-act'
(require 'hypb) ;; Requires `seq'
(require 'outline) ;; For `outline-mode-syntax-table'
diff --git a/kotl/kotl-mode.el b/kotl/kotl-mode.el
index 76f4b08d53..b997d739e1 100644
--- a/kotl/kotl-mode.el
+++ b/kotl/kotl-mode.el
@@ -3,7 +3,7 @@
;; Author: Bob Weiner
;;
;; Orig-Date: 6/30/93
-;; Last-Mod: 19-Jan-26 at 22:34:04 by Mats Lidell
+;; Last-Mod: 19-Feb-26 at 01:12:25 by Bob Weiner
;;
;; SPDX-License-Identifier: GPL-3.0-or-later
;;
@@ -2491,8 +2491,10 @@ Optional prefix arg RELATIVE-LEVEL means one of the
following:
1. when = 0, add as the parent's first child cell (first cell in list);
2. when < 0, add that number of cells as preceding siblings;
- 3. when \\='(4) (universal arg, \\`C-u'), add as the first child of the
current cell;
- 4. when > 0 or nil (meaning 1), add that number of cells as following
siblings."
+ 3. when \\='(4) (universal arg, \\`C-u'), add as the first child of the
+ current cell;
+ 4. when > 0 or nil (meaning 1), add that number of cells as following
+ siblings."
(interactive "*P")
(unless (or (integerp relative-level) (listp relative-level) )
(error "(kotl-mode:add-cell): `relative-level' must be an integer or a
list of integers, not '%s'" relative-level))
