[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/hyperbole 0c1f6b07a7 2/8: Action Key on top-level mini
|
From: |
ELPA Syncer |
|
Subject: |
[elpa] externals/hyperbole 0c1f6b07a7 2/8: Action Key on top-level mini menu name reloads Smart Keys and menus |
|
Date: |
Sun, 14 May 2023 03:58:32 -0400 (EDT) |
branch: externals/hyperbole
commit 0c1f6b07a71a1b9709731d2585625e6a87e59805
Author: Bob Weiner <rsw@gnu.org>
Commit: Bob Weiner <rsw@gnu.org>
Action Key on top-level mini menu name reloads Smart Keys and menus
Fix Dired drag item so works on . and .. entries.
---
ChangeLog | 16 +++++++++++
hbut.el | 55 +++++++++++++++++-------------------
hui-menu.el | 9 +++---
hui-mini.el | 29 +++++++++++++++----
hui-mouse.el | 2 +-
man/hyperbole.html | 80 ++++++++++++++++++++++++++++-------------------------
man/hyperbole.info | Bin 601614 -> 602191 bytes
man/hyperbole.pdf | Bin 1353645 -> 1353957 bytes
man/hyperbole.texi | 77 ++++++++++++++++++++++++++++-----------------------
9 files changed, 158 insertions(+), 110 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 271ce8dc9b..85f770c4ea 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -9,6 +9,22 @@
HY-CONCEPTS.kotl: Add to explain how Hyperbole concepts connect to one
another and Emacs. Add to minibuffer menu on {C-h h d c}.
+* hbut.el (hbut:comment): Remove nil-valued if clauses.
+
+2023-05-12 Bob Weiner <rsw@gnu.org>
+
+* hui-mouse.el (smart-dired): Fix 'dired-get-filename' so works on . and ..
+ entries.
+
+* hui-mini.el (hui:menu-choose): Action Key press on the top-level menu
+ prefix reloads Hyperbole minibuffer menus and Smart Key handlers to
+ reflect any recent changes.
+ man/hyperbole.texi (Menus): Add doc for above update.
+
+2023-05-11 Bob Weiner <rsw@gnu.org>
+
+* hui-mini.el (hui:menus): Rename DeleteIbutType to DeleteType.
+
2023-05-07 Bob Weiner <rsw@gnu.org>
* Makefile (manual): Add manual target to build manual without building other
diff --git a/hbut.el b/hbut.el
index 97951c439d..d035d2b1cd 100644
--- a/hbut.el
+++ b/hbut.el
@@ -3,7 +3,7 @@
;; Author: Bob Weiner
;;
;; Orig-Date: 18-Sep-91 at 02:57:09
-;; Last-Mod: 30-Apr-23 at 14:43:05 by Bob Weiner
+;; Last-Mod: 13-May-23 at 12:18:37 by Bob Weiner
;;
;; SPDX-License-Identifier: GPL-3.0-or-later
;;
@@ -1005,33 +1005,31 @@ Then use (hbut:act) to activate the button."
Use buffer commenting grammar, if any, otherwise don't comment.
Ignore email-related buffers."
(save-excursion
- (if (and comment-start (not (hmail:mode-is-p))
- (not (memq major-mode '(mail-mode message-mode))))
- (if (or (equal comment-end "")
- (null comment-end))
- (progn
- (beginning-of-line)
- (if (search-forward comment-start start t)
- nil
- (goto-char start)
- (insert comment-start)
- (if (not (eq (preceding-char) ?\ ))
- (insert ?\ ))))
- ;; Comments have both start and end delimiters
- (if (and (re-search-backward
- (concat (regexp-quote comment-start) "\\|"
- (regexp-quote comment-end))
- nil t)
- (looking-at (regexp-quote comment-start)))
- nil
- (goto-char start)
- (insert comment-start)
- (unless (eq (preceding-char) ?\ )
- (insert ?\ ))
- (goto-char (+ (point) (- end start)))
- (unless (eq (following-char) ?\ )
- (insert ?\ ))
- (insert comment-end))))))
+ (when (and comment-start (not (hmail:mode-is-p))
+ (not (memq major-mode '(mail-mode message-mode))))
+ (if (or (equal comment-end "")
+ (null comment-end))
+ (progn
+ (beginning-of-line)
+ (unless (search-forward comment-start start t)
+ (goto-char start)
+ (insert comment-start)
+ (unless (eq (preceding-char) ?\ )
+ (insert ?\ ))))
+ ;; Comments have both start and end delimiters
+ (unless (and (re-search-backward
+ (concat (regexp-quote comment-start) "\\|"
+ (regexp-quote comment-end))
+ nil t)
+ (looking-at (regexp-quote comment-start)))
+ (goto-char start)
+ (insert comment-start)
+ (unless (eq (preceding-char) ?\ )
+ (insert ?\ ))
+ (goto-char (+ (point) (- end start)))
+ (unless (eq (following-char) ?\ )
+ (insert ?\ ))
+ (insert comment-end))))))
;;; Regexps derived in part from "filladapt.el" by Kyle E. Jones under
;;; the GPL.
@@ -2209,7 +2207,6 @@ Signal an error when no such button is found in the
current buffer.
Leave point at the start of the button label which may be elsewhere
than the current point; callers should use `save-excursion` to retain
current."
- ;; !! Need to handle adding instances to labels, similar to ebut:operate.
(cond ((or (not (stringp new-lbl)) (< (length new-lbl) 1))
(error "(ibut:rename): Invalid 'new-lbl' argument: \"%s\"" new-lbl))
((or (not (stringp old-lbl)) (< (length old-lbl) 1))
diff --git a/hui-menu.el b/hui-menu.el
index 8a0d64229f..df9552e95d 100644
--- a/hui-menu.el
+++ b/hui-menu.el
@@ -3,7 +3,7 @@
;; Author: Bob Weiner
;;
;; Orig-Date: 28-Oct-94 at 10:59:44
-;; Last-Mod: 13-May-23 at 15:37:30 by Bob Weiner
+;; Last-Mod: 13-May-23 at 17:03:00 by Bob Weiner
;;
;; SPDX-License-Identifier: GPL-3.0-or-later
;;
@@ -356,11 +356,12 @@ REBUILD-FLAG is non-nil, in which case the menu is
rebuilt."
["Manual" (id-info "(hyperbole)Top") t]
"----"
["About" (hypb:display-file-with-logo "HY-ABOUT") t]
- ["Concepts" (find-file (expand-file-name
"HY-CONCEPTS.kotl" hyperb:dir)) t]
+ ["Concepts" (find-file (expand-file-name
+ "HY-CONCEPTS.kotl" hyperb:dir)) t]
["Demonstration" hyperbole-demo t]
["Files" (hypb:display-file-with-logo "MANIFEST") t]
["Glossary" (id-info "(hyperbole)Glossary") t]
- ("New-Features" (hypb:display-file-with-logo "HY-NEWS") t]
+ ["New-Features" (hypb:display-file-with-logo "HY-NEWS") t]
["Smart-Key-Summary" (id-browse-file (hypb:hkey-help-file))
t]
("Types"
["Action-Types-Manual"
@@ -372,7 +373,7 @@ REBUILD-FLAG is non-nil, in which case the menu is rebuilt."
(hui:htype-help-current-window 'actypes) t]
["Show-Implicit-Button-Types"
(hui:htype-help-current-window 'ibtypes 'no-sort) t])
- ["WhyUse" (find-file (expand-file-name "HY-WHY.kotl"
hyperb:dir)) t])
+ ["WhyUse" (find-file (expand-file-name "HY-WHY.kotl"
hyperb:dir)) t])
'("Explicit-Button"
:filter hui-menu-explicit-buttons
["Activate" hui:ebut-act t]
diff --git a/hui-mini.el b/hui-mini.el
index 685c23ef97..a08d5b43d9 100644
--- a/hui-mini.el
+++ b/hui-mini.el
@@ -3,7 +3,7 @@
;; Author: Bob Weiner
;;
;; Orig-Date: 15-Oct-91 at 20:13:17
-;; Last-Mod: 30-Apr-23 at 15:52:41 by Bob Weiner
+;; Last-Mod: 13-May-23 at 14:52:29 by Bob Weiner
;;
;; SPDX-License-Identifier: GPL-3.0-or-later
;;
@@ -41,7 +41,8 @@ Also exits any active minibuffer menu.")
(defvar hui:menu-keys ""
"String of keys pressed for current or last Hyperbole command.
-This excludes the prefix used to invoke the Hyperbole menu.")
+This excludes the prefix used to invoke the Hyperbole menu, except
+when on the top-level menu.")
(defvar hui:menu-p nil
"Non-nil iff the Hyperbole minibuffer menu is active.")
@@ -286,6 +287,10 @@ instead returns the one line help string for the key
sequence."
(setq input (event-basic-type input)))
(if (or (symbolp input)
(and (integerp input) (= input ?\r)))
+ ;; If no item selected, when on the menu name (ending with
+ ;; '>', input will be set to 1. If at the end of the menu,
+ ;; input will be set to 0. See `hui:menu-choose' for how
+ ;; these are handled.
(setq input (hargs:at-p)))
(erase-buffer)
(when (or (characterp input) (stringp input))
@@ -372,6 +377,9 @@ or if there are none, then its first character."
(defun hui:menu-choose (menu-alist &optional doc-flag help-string-flag)
"Prompt user to choose the first capitalized char of any item from
MENU-ALIST.
+Return the Lisp form associated with the selected item, which may be
+another menu.
+
The character may be entered in lowercase. If chosen by direct
selection with the Assist Key, return any help string for item,
else return the action form for the item.
@@ -422,6 +430,17 @@ documentation, not the full text."
(set--this-command-keys (concat hui:menu-keys hui:menu-abort))
(setq this-command #'hui:menu-abort)
nil)
+ ((and (eq key 1) (listp (car menu-alist))
+ (stringp (caar menu-alist))
+ (string-match "^Hy[.0-9]*[a-zA-Z0-9]*>$" (caar menu-alist)))
+ ;; RET pressed on Hyperbole top-level menu prefix, reload
+ ;; Smart Key handlers and minibuffer menus to reflect any updates.
+ (load "hui-mini")
+ (hmouse-update-smart-keys)
+ (hyperbole-minibuffer-menu)
+ (sit-for 2)
+ (message "Minibuffer menus and Smart Key actions reloaded.")
+ '(menu . hyperbole))
((memq key (list 1 top-char))
(setq hui:menu-keys (concat hui:menu-keys (char-to-string top-char)))
'(menu . hyperbole))
@@ -755,7 +774,7 @@ The menu is a menu of commands from MENU-ALIST."
("SmartKeys" (hkey-summarize 'current-window) "Summarizes
Smart Key mouse or keyboard handling.")
("Types/" (menu . types) "Provides
documentation on Hyperbole types.")
("WhyUse" (find-file (expand-file-name "HY-WHY.kotl" hyperb:dir))
- "Lists use cases for Hyperbole Hyperbole.")))
+ "Lists use cases for Hyperbole.")))
'(ebut .
(("EButton>")
("Act" hui:ebut-act
@@ -799,8 +818,8 @@ The menu is a menu of commands from MENU-ALIST."
"Activates implicit button at point or prompts for labeled implicit
button to activate.")
("Create" hui:ibut-create
"Labels and creates an implicit button of any type.")
- ("DeleteIButType" (hui:htype-delete 'ibtypes)
- "Deletes specified button type.")
+ ("DeleteType" (hui:htype-delete 'ibtypes)
+ "Deletes specified implicit button type.")
("Edit" hui:ibut-edit "Edits/modifies named implicit button
attributes.")
("Help" hui:hbut-help "Reports on button's attributes.")
("Info" (id-info "(hyperbole)Implicit Buttons")
diff --git a/hui-mouse.el b/hui-mouse.el
index d9eb783662..b0d7e854a9 100644
--- a/hui-mouse.el
+++ b/hui-mouse.el
@@ -890,7 +890,7 @@ If key is pressed:
(t (error "(smart-dired): No Dired expunge function")))))
(t (hpath:find (smart-dired-pathname-up-to-point)))))
((last-line-p) (quit-window))
- (t (hpath:find (dired-get-filename)))))
+ (t (hpath:find (dired-get-filename nil t)))))
(defun smart-dired-assist ()
"Use a single assist-key or mouse assist-key to manipulate directory entries.
diff --git a/man/hyperbole.html b/man/hyperbole.html
index b0ae46c5c5..12f3f42111 100644
--- a/man/hyperbole.html
+++ b/man/hyperbole.html
@@ -107,7 +107,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
Edition 8.0.1pre
-Printed May 7, 2023.
+Printed May 13, 2023.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -3847,7 +3847,7 @@ look like this:
</li><li>or by pressing <kbd class="kbd">{Shift-<kbd
class="key">TAB</kbd>}</kbd> or <kbd class="kbd">{M-b}</kbd> to move backward
an item.
</li></ul>
-<p>A prefix argument given to one of the movement commands, moves by tht
+<p>A prefix argument given to one of the movement commands, moves by that
number of items within the menu. A press of the Assist Key on an item
displays help for the item, including the action that it performs.
"/" at the end of an item name indicates that it brings up a submenu.
@@ -3863,13 +3863,25 @@ displays help for the item, including the action that
it performs.
<p>While a menu is active, to re-activate the top-level Hyperbole menu,
use <kbd class="kbd">{C-t}</kbd> or press the Action Key while on the menu
prefix
(before the ‘<samp class="samp">></samp>’ character). This
allows you to browse the
-submenus and then return to the top menu. You can quit from the
-minibuffer menus without selecting an item by using <kbd
class="kbd">{Q}</kbd>, or by
-pressing <kbd class="kbd">{<kbd class="key">RET</kbd>}</kbd> or <kbd
class="kbd">{M-<kbd class="key">RET</kbd>}</kbd> when at the end of a
-menu. <kbd class="kbd">{C-g}</kbd> aborts from the minibuffer whether you are
at a menu
-prompt or any other Hyperbole prompt. <kbd class="kbd">{X}</kbd> both quits
the menus
-and disables the Hyperbole global minor mode; <kbd class="kbd">{C-h h}</kbd>
restores
-the menus and re-enables Hyperbole minor mode.
+submenus and then return to the top menu.
+</p>
+<a class="index-entry-id" id="index-menu_002c-reload"></a>
+<a class="index-entry-id" id="index-Smart-Key_002c-reload"></a>
+<a class="index-entry-id" id="index-reload-minibuffer-menus"></a>
+<a class="index-entry-id" id="index-reload-Smart-Key-handlers"></a>
+
+<p>You can reload the Hyperbole minibuffer menus and Smart Key handlers
+to reflect any recent edits when on the top-level Hyperbole menu by
+pressing the Action Key on the menu name (first item that ends with
+’>’).
+</p>
+<p>You can quit from the minibuffer menus without selecting an item by
+using <kbd class="kbd">{Q}</kbd>, or by pressing <kbd class="kbd">{<kbd
class="key">RET</kbd>}</kbd> or <kbd class="kbd">{M-<kbd
class="key">RET</kbd>}</kbd>
+when at the end of a menu. <kbd class="kbd">{C-g}</kbd> aborts from the
minibuffer
+whether you are at a menu prompt or any other Hyperbole prompt.
+<kbd class="kbd">{X}</kbd> both quits the menus and disables the Hyperbole
global minor
+mode; <kbd class="kbd">{C-h h}</kbd> restores the menus and re-enables
Hyperbole minor
+mode.
</p>
<p>The top-level Hyperbole minibuffer menu items serve the following purposes:
</p>
@@ -4297,10 +4309,12 @@ screen size.
<a class="index-entry-id" id="index-I_002fJ_002fK_002fM"></a>
</dd>
<dt><kbd class="kbd">{I/J/K/M}</kbd></dt>
-<dd><p>In WINDOWS mode, the keys <kbd class="kbd">{I}</kbd><kbd
class="kbd">{J}</kbd>/<kbd class="kbd">{K}</kbd>/<kbd class="kbd">{M}</kbd> move
-directionally (based on QUERTY key layout) between windows in the
-selected frame. In FRAMES mode, they move directionally through visible
-frames. These use the <samp class="file">windmove</samp> and <samp
class="file">framemove</samp> libraries.
+<dd><p>In WINDOWS mode, the keys I, J, K, M move directionally (based on
+QUERTY key layout) between windows in the selected frame. In FRAMES
+mode, they move directionally through visible frames. These use the
+<samp class="file">windmove</samp> and <samp class="file">framemove</samp>
libraries. When any of these
+keys are pressed, Hyperbole will prompt to install the needed library
+if not already installed.
</p>
<a class="index-entry-id" id="index-screen_002c-W"></a>
<a class="index-entry-id" id="index-W"></a>
@@ -6103,30 +6117,21 @@ files or Koutline files.
</p>
<p>Rolo <em class="dfn">entries</em> begin with optional space, followed by a
delimiter of
one or more special characters followed by another space. Delimiters
-vary based on the type of file:
+vary based on the type of file, for example level 3 entry delimiters
+look like this:
</p>
-<dl class="table">
-<dt>Emacs Outline Mode</dt>
-<dd><p>*
-</p></dd>
-<dt>Koutline Mode</dt>
-<dd><p>1b3 or 1.2.3
-</p></dd>
-<dt>Markdown Mode</dt>
-<dd><p>#
-</p></dd>
-<dt>Org Mode</dt>
-<dd><p>*
-</p></dd>
-<dt>Text Mode</dt>
-<dd><p>*
-</p></dd>
-</dl>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Emacs Outline Mode: ***
+Koutline Mode: 1b3 or 1.2.3
+Markdown Mode: ###
+Org Mode: ***
+Text Mode: ***
+</pre></div></div>
<p>Entries may be arranged in a hierarchy, where child entries start with
-at least one more delimiter characters than do their parents. Top-level
-level entries use either a single delimiter character or a sequence of
-digits in the case of Koutlines.
+at least one more delimiter characters than do their parents. Top-level
+entries use either a single delimiter character or a sequence of digits
+in the case of Koutlines.
</p>
<p>Beyond this initial delimiter, entries are completely free-form text.
It is best to use a "lastname, firstname" format, however, when
adding
@@ -7549,9 +7554,6 @@ Previous: <a href="#Encapsulating-Systems" accesskey="p"
rel="prev">Encapsulatin
</div>
<h3 class="section" id="Embedding-Hyperbole-1">10.5 Embedding Hyperbole</h3>
-<p>[NOTE: We have never done this ourselves, though we have done similar
-things which leads us to infer that the task should not be difficult.]
-</p>
<a class="index-entry-id" id="index-Hyperbole-API"></a>
<a class="index-entry-id" id="index-API"></a>
<a class="index-entry-id" id="index-programming-interface"></a>
@@ -14450,6 +14452,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function, Variable and Fi
<tr><td></td><td class="printindex-index-entry"><a
href="#index-menu_002c-Msg">menu, Msg</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-menu_002c-Outline_002fExample">menu,
Outline/Example</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-menu_002c-Outliner">menu, Outliner</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Menus">Menus</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a
href="#index-menu_002c-reload">menu, reload</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-menu_002c-Rolo">menu, Rolo</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-menu_002c-Rolo-1">menu, Rolo</a>:</td><td> </td><td
class="printindex-index-section"><a href="#HyRolo-Menu">HyRolo
Menu</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-menu_002c-Screen">menu, Screen</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Menus">Menus</a></td></tr>
@@ -14624,6 +14627,8 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function, Variable and Fi
<tr><td></td><td class="printindex-index-entry"><a
href="#index-register_002c-klinks">register, klinks</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Klinks">Klinks</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-relative-autonumber">relative
autonumber</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-relative-identifier">relative
identifier</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Autonumbering">Autonumbering</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a
href="#index-reload-minibuffer-menus">reload minibuffer
menus</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Menus">Menus</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a
href="#index-reload-Smart-Key-handlers">reload Smart Key
handlers</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-remote-file">remote file</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Implicit-Button-Types">Implicit
Button Types</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-remote-path">remote path</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Implicit-Button-Types">Implicit
Button Types</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-remote-pathnames">remote pathnames</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Using-URLs-with-Find_002dFile">Using
URLs with Find-File</a></td></tr>
@@ -14713,6 +14718,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function, Variable and Fi
<tr><td></td><td class="printindex-index-entry"><a
href="#index-Smart-Key-summary">Smart Key summary</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Smart-Key-Operations">Smart Key
Operations</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-Smart-Key_002c-default-context">Smart Key, default
context</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-Smart-Key_002c-default-context-1">Smart Key, default
context</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Smart-Key-_002d-Default-Context">Smart Key - Default
Context</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a
href="#index-Smart-Key_002c-reload">Smart Key,
reload</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-Smart-Keyboard-Keys">Smart Keyboard
Keys</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Smart-Key-_002d-Argument-Completion">Smart Key - Argument
Completion</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-smart-keys_002c-unshifted">smart keys,
unshifted</a>:</td><td> </td><td class="printindex-index-section"><a
href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td class="printindex-index-entry"><a
href="#index-smart-marking">smart marking</a>:</td><td> </td><td
class="printindex-index-section"><a href="#Smart-Key-Thing-Selection">Smart Key
Thing Selection</a></td></tr>
diff --git a/man/hyperbole.info b/man/hyperbole.info
index 1ec4517d42..35de7575b5 100644
Binary files a/man/hyperbole.info and b/man/hyperbole.info differ
diff --git a/man/hyperbole.pdf b/man/hyperbole.pdf
index e6df4e2e43..588f4b09c5 100644
Binary files a/man/hyperbole.pdf and b/man/hyperbole.pdf differ
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index 7fdc3b19ff..468d5b58a2 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -7,7 +7,7 @@
@c Author: Bob Weiner
@c
@c Orig-Date: 6-Nov-91 at 11:18:03
-@c Last-Mod: 7-May-23 at 20:35:03 by Bob Weiner
+@c Last-Mod: 13-May-23 at 10:01:36 by Bob Weiner
@c %**start of header (This is for running Texinfo on a region.)
@setfilename hyperbole.info
@@ -156,7 +156,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
Edition 8.0.1pre
-Printed May 7, 2023.
+Printed May 13, 2023.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -198,7 +198,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
@example
Edition 8.0.1pre
-May 7, 2023
+May 13, 2023
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -3780,7 +3780,7 @@ A menu item can be selected in a number of ways:
@end itemize
@noindent
-A prefix argument given to one of the movement commands, moves by tht
+A prefix argument given to one of the movement commands, moves by that
number of items within the menu. A press of the Assist Key on an item
displays help for the item, including the action that it performs.
"/" at the end of an item name indicates that it brings up a submenu.
@@ -3796,13 +3796,25 @@ displays help for the item, including the action that
it performs.
While a menu is active, to re-activate the top-level Hyperbole menu,
use @bkbd{C-t} or press the Action Key while on the menu prefix
(before the @samp{>} character). This allows you to browse the
-submenus and then return to the top menu. You can quit from the
-minibuffer menus without selecting an item by using @bkbd{Q}, or by
-pressing @bkbd{@key{RET}} or @bkbd{M-@key{RET}} when at the end of a
-menu. @bkbd{C-g} aborts from the minibuffer whether you are at a menu
-prompt or any other Hyperbole prompt. @bkbd{X} both quits the menus
-and disables the Hyperbole global minor mode; @bkbd{C-h h} restores
-the menus and re-enables Hyperbole minor mode.
+submenus and then return to the top menu.
+
+@cindex menu, reload
+@cindex Smart Key, reload
+@cindex reload minibuffer menus
+@cindex reload Smart Key handlers
+
+You can reload the Hyperbole minibuffer menus and Smart Key handlers
+to reflect any recent edits when on the top-level Hyperbole menu by
+pressing the Action Key on the menu name (first item that ends with
+'>').
+
+You can quit from the minibuffer menus without selecting an item by
+using @bkbd{Q}, or by pressing @bkbd{@key{RET}} or @bkbd{M-@key{RET}}
+when at the end of a menu. @bkbd{C-g} aborts from the minibuffer
+whether you are at a menu prompt or any other Hyperbole prompt.
+@bkbd{X} both quits the menus and disables the Hyperbole global minor
+mode; @bkbd{C-h h} restores the menus and re-enables Hyperbole minor
+mode.
@noindent
The top-level Hyperbole minibuffer menu items serve the following purposes:
@@ -4204,10 +4216,12 @@ screen size.
@kindex screen, I/J/K/M
@kitem I/J/K/M
-In WINDOWS mode, the keys @bkbd{I}@bkbd{J}/@bkbd{K}/@bkbd{M} move
-directionally (based on QUERTY key layout) between windows in the
-selected frame. In FRAMES mode, they move directionally through visible
-frames. These use the @file{windmove} and @file{framemove} libraries.
+In WINDOWS mode, the keys I, J, K, M move directionally (based on
+QUERTY key layout) between windows in the selected frame. In FRAMES
+mode, they move directionally through visible frames. These use the
+@file{windmove} and @file{framemove} libraries. When any of these
+keys are pressed, Hyperbole will prompt to install the needed library
+if not already installed.
@kindex screen, W
@kitem W
@@ -5732,25 +5746,23 @@ files or Koutline files.
Rolo @dfn{entries} begin with optional space, followed by a delimiter of
one or more special characters followed by another space. Delimiters
-vary based on the type of file:
+vary based on the type of file, for example level 3 entry delimiters
+look like this:
-@table @asis
-@item Emacs Outline Mode
-*
-@item Koutline Mode
-1b3 or 1.2.3
-@item Markdown Mode
-#
-@item Org Mode
-*
-@item Text Mode
-*
-@end table
+@example
+@group
+Emacs Outline Mode: ***
+Koutline Mode: 1b3 or 1.2.3
+Markdown Mode: ###
+Org Mode: ***
+Text Mode: ***
+@end group
+@end example
Entries may be arranged in a hierarchy, where child entries start with
-at least one more delimiter characters than do their parents. Top-level
-level entries use either a single delimiter character or a sequence of
-digits in the case of Koutlines.
+at least one more delimiter characters than do their parents. Top-level
+entries use either a single delimiter character or a sequence of digits
+in the case of Koutlines.
Beyond this initial delimiter, entries are completely free-form text.
It is best to use a "lastname, firstname" format, however, when adding
@@ -7042,9 +7054,6 @@ that a press of the Action Key follows a URL.
@node Embedding Hyperbole, , Encapsulating Systems, Developing with Hyperbole
@section Embedding Hyperbole
-[NOTE: We have never done this ourselves, though we have done similar
-things which leads us to infer that the task should not be difficult.]
-
@cindex Hyperbole API
@cindex API
@cindex programming interface
- [elpa] externals/hyperbole updated (2cd6cbe153 -> 9096ea849e), ELPA Syncer, 2023/05/14
- [elpa] externals/hyperbole 616ee63b21 5/8: hsys-youtube.el - Doc and properly define yt- actypes, ELPA Syncer, 2023/05/14
- [elpa] externals/hyperbole 968c09d8a7 6/8: Restore Smart Key depress window buffer if switched before release, ELPA Syncer, 2023/05/14
- [elpa] externals/hyperbole 085cf5ae92 7/8: Merge branch 'master' into rsw, ELPA Syncer, 2023/05/14
- [elpa] externals/hyperbole 4d96e83e61 1/8: Add HY-CONCEPTS.kotl on {C-h h d c}, ELPA Syncer, 2023/05/14
- [elpa] externals/hyperbole 0c1f6b07a7 2/8: Action Key on top-level mini menu name reloads Smart Keys and menus,
ELPA Syncer <=
- [elpa] externals/hyperbole 9096ea849e 8/8: Merge pull request #325 from rswgnu/rsw, ELPA Syncer, 2023/05/14
- [elpa] externals/hyperbole 4194f18537 4/8: Catch potential error in mount point shell cmd call from hypb mode, ELPA Syncer, 2023/05/14
- [elpa] externals/hyperbole 3177f4b845 3/8: Update test/MANIFEST so is current, ELPA Syncer, 2023/05/14