[elpa] externals/hyperbole 4d96e83e61 1/8: Add HY-CONCEPTS.kotl on {C-h h d c}

[ELPA Syncer]

branch: externals/hyperbole
commit 4d96e83e610cf214e3498fde28cdbc7b01fd5e4a
Author: Bob Weiner <rsw@gnu.org>
Commit: Bob Weiner <rsw@gnu.org>

    Add HY-CONCEPTS.kotl on {C-h h d c}
---
 .hypb            | Bin 2457 -> 2599 bytes
 ChangeLog        |  11 +++
 DEMO             |  40 +++++-----
 FAST-DEMO        |   4 +-
 HY-CONCEPTS.kotl | 232 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 HY-NEWS          |  30 ++++---
 MANIFEST         |   1 +
 Makefile         |   9 ++-
 hargs.el         |   4 +-
 hui-menu.el      |  10 ++-
 hui-mini.el      |   2 +
 11 files changed, 304 insertions(+), 39 deletions(-)

diff --git a/.hypb b/.hypb
index c1ddb112a4..1d7d2c5982 100644
Binary files a/.hypb and b/.hypb differ
diff --git a/ChangeLog b/ChangeLog
index 9287a99290..271ce8dc9b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2023-05-13  Bob Weiner  <rsw@gnu.org>
+
+* DEMO (Org Mode): Update Action Key handling writeup.
+
+* hui-menu.el (infodock-hyperbole-menu): Sync Documentation menu to minibuffer 
Doc/
+  Makefile (HYPERBOLE_FILES):
+  MANIFEST (HY-CONCEPTS.kotl):
+  hui-mini.el (Doc/Concepts):
+  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}.
+
 2023-05-07  Bob Weiner  <rsw@gnu.org>
 
 * Makefile (manual): Add manual target to build manual without building other
diff --git a/DEMO b/DEMO
index ed2fe8461d..5c9742b408 100644
--- a/DEMO
+++ b/DEMO
@@ -526,31 +526,35 @@ demonstrations and tours with this and other implicit 
button types.
 
 ** Org Mode
 
-For users of Emacs Org mode, Hyperbole does quite a few things.
+For users of Emacs Org mode, Hyperbole does quite a few things when
+the Action Key is pressed.
 
-First, the Action Key follows internal links in Org mode files.  When
-pressed on a link referent/target, the link definition is displayed,
-allowing two-way navigation between definitions and targets.
+  1. If on an Org todo keyword, cycle through the keywords in
+     that set or if final done keyword, remove it.
 
-Second, the Action Key follows Org mode external links.  The Assist Key
-displays help when pressed on an Org mode link.
+  2. If on an Org agenda item, jump to the item for editing.
 
-Third, within a radio target definition, the Action Key jumps to the first
-occurrence of an associated radio target.
+  3. Within a radio or internal target or a link to it, jump between
+     the target and the first link to it, allowing two-way navigation.
 
-Fourth, when point is on an outline heading in Org mode, the Action Key
-cycles the view of the subtree at point and the Assist Key cycles the view
-of all headings in the buffer.
+  4. Follow other internal links in Org mode files.
 
-Fifth, with point on the first line of a code block definition, the Action
-Key executes the code block via the Org mode standard binding of {C-c C-c},
-(org-ctrl-c-ctrl-c).
+  5. Follow Org mode external links.
 
-Sixth, the Action and Assist keys work on Hyperbole explicit and implicit
-buttons.
+  6. When on a Hyperbole button, activate the button.
 
-In any other context besides the end of a line, the Action Key invokes
-the Org mode standard binding of {M-RET}, (org-meta-return).
+  7. With point on the :dir path of a code block definition, display the
+     directory given by the path.
+
+  8. With point on any #+BEGIN_SRC, #+END_SRC, #+RESULTS, #+begin_example
+     or #+end_example header, execute the code block via the Org mode
+     standard binding of {C-c C-c}, (org-ctrl-c-ctrl-c).
+  
+  9. When point is on an Org mode heading, cycle the view of the subtree
+     at point.
+
+  10. In any other context besides the end of a line, invoke the Org mode
+      standard binding of {M-RET}, (org-meta-return).
 
 To disable ALL Hyperbole support within Org major and minor modes, set
 the custom option `hsys-org-enable-smart-keys' to nil.  Then the
diff --git a/FAST-DEMO b/FAST-DEMO
index be970e5ef5..f5eaf06cf8 100644
--- a/FAST-DEMO
+++ b/FAST-DEMO
@@ -244,7 +244,9 @@ pspell-config(1)         - prints information about a 
libpspell installation
        the associated man documentation page.
 
 
-* Action Buttons (generalized form of implicit buttons)
+* Action Buttons
+
+  These are a generalized form of implicit buttons.
 
   If you know your way around Emacs Lisp and want to quickly turn snippets of
   Lisp code or Lisp variables into Hyperbole buttons, just remove any outer
diff --git a/HY-CONCEPTS.kotl b/HY-CONCEPTS.kotl
new file mode 100644
index 0000000000..9f24c567ed
--- /dev/null
+++ b/HY-CONCEPTS.kotl
@@ -0,0 +1,232 @@
+;; -*- Mode: kotl -*- 
+"Kotl-4.0" ;; file-format
+
+   1. People often ask why so many different concepts and capabilities are part
+      of Hyperbole and how they relate to one another.  This is a rapid-fire,
+      technical summary of how each part of Hyperbole's design builds upon
+      other parts to provide advanced, yet easy-to-use capabilities throughout
+      Emacs.  This document does not explain how to use Hyperbole.  It is meant
+      to be viewed with Hyperbole's Koutliner, mentioned later in this 
document.
+
+     1a. The "FAST-DEMO" file on {C-h h d d} interactively introduces you to
+         Hyperbole in a step-by-step fashion.  That is a quick way to get a
+         feel for it.  For a much more extensive, interactive, introduction,
+         see the "DEMO" file instead.
+
+     1b. The "HY-WHY.kotl" file on {C-h h d w} summarizes Hyperbole use cases
+         if you are not yet motivated to use it.
+
+     1c. The "HY-ABOUT" file on {C-h h d a} is a gentler, less detailed
+         introduction to what Hyperbole offers.
+
+   2. GNU Hyperbole is a single turnkey Emacs package with no external package
+      requirements that offers an extensive, extensible, hypertextual
+      information management system. It works with all kinds of file formats,
+      including Org mode.
+
+   3. Hyperbole action types determine what Hyperbole's hyperbuttons do;
+      links are one set of actions that display referents, but an action
+      type can implement any Lisp behavior and is similar to a regular Lisp
+      function.  Action types, however, live in their own namespace (prefixed
+      with `actypes::') so their names do not conflict with Lisp functions.
+      
+      Any kind of Hyperbole button can invoke any action type or regular Lisp
+      function.
+
+   4. Hyperbole's Action {M-RET} and Assist Keys {C-u M-RET}, collectively
+      known as the Smart Keys, provide context-sensitive activation of
+      hyperbuttons and many other actions.  Hyperbuttons can span multiple
+      lines but you must activate them with a press on the first line of each
+      button.
+
+   5. Implicit buttons represent one category of Hyperbole buttons.  They are
+      built from an implicit button type that runs an action type when
+      activated with the Action Key.
+
+   6. Implicit button types and Action Key contexts recognize all sorts of
+      cross-references embedded in files, e.g. URLs, Org IDs or email
+      addresses, without the need for any markup, and trigger associated action
+      types.  Optionally you can add a delimited <[name]> in front of an
+      implicit button so that it can be activated by name.
+
+     6a. Brace-delimited key series (any series of Emacs key sequences strung
+         together in braces) is one type of implicit button, e.g. {C-u C-n
+         C-e}.  You can embed such sequences in any file and activate them
+         instantly with an Action Key press within the braces.  These let you
+         tie Emacs and Hyperbole commands together by simply typing out the
+         keys for reuse any time in the future.  No need to learn about Emacs'
+         keyboard macros or how to save them to files.
+
+     6b. Action Buttons are a generalized form of implicit buttons that are
+         delimited by angle brackets.  Such buttons allow invocation of any
+         Emacs function or action type by name, followed by any needed
+         arguments, when the Action Key is pressed within the button:
+
+       6b1. Count windows in the selected frame:
+              <message "This frame has %d windows" (count-windows)>
+
+       6b2. Display the early Internet standard mail specification:
+              <link-to-rfc 822>
+
+       6b3. See more examples here: "FAST-DEMO#Action Buttons".
+
+   7. Much of Hyperbole's functionality is accessed with its keyboard-driven
+      minibuffer menu where each item can be selected by typing its first
+      capitalized letter.  {C-h h} displays the top-level minibuffer menu.
+      You can then embed any menu command into a key series you store in
+      any file.  Then an Action Key press will run it.  To see what is new
+      in Hyperbole from the Doc/News item, you use the key series, {C-h h d
+      n}.
+
+   8. <(Explicit buttons)> can be created and embedded in most any type of
+      file or buffer; each sends a set of given parameters to an action
+      type when activated with an Action Key press.  See also "DEMO#Explicit
+      Buttons".
+
+   9. "HYPB" files serve as convenient home pages for embedding Hyperbole
+      buttons.  Each user has a personal button file accessed with {C-h h b
+      p} and each directory can have a local button file accessed with {C-h
+      h b d}.  See "DEMO#Buton Files".
+
+  10. Global buttons are either explicit or named implicit buttons that are
+      activated by choosing from a list of names, without the need to have
+      the button source buffer on screen, thus they are available globally.
+      All global buttons are stored in a user's personal "HYPB" file.  See
+      "DEMO#Global Buttons" for how to use these.
+
+  11. Hyperbole lets you set and control which windows or frames you want
+      all of your hyperlink referents displayed in.  Each time you activate
+      a Hyperbole button, it stores your current frame configuration on a
+      stack.  You can pop back to a prior one with {C-h h h}.  You can also
+      store per-frame window configurations in a ring or store and retrieve
+      them by name utilizing the Hyperbole Win/ menu on {C-h h w}.
+
+  12. You access Hyperbole's HyControl subsystem from the Screen/ menu on {C-h
+      h s}.  This lets you rapidly control the set of, location of and size of
+      per-frame windows (choose 'w' for WindowsControl) or frames (choose 'f'
+      for FramesControl) on your screen.  Use 't' to toggle between these two
+      modes and 'Q' when you want to quit from this mode.  A persistent prefix
+      argument for all of HyControl's commands lets you quickly adjust things
+      at any scale you like, e.g. widen a window by 20 characters at a time.
+      See "DEMO#HyControl".
+
+  13. Hyperbole's Koutliner subsystem on {C-h h k} is a powerful,
+      hierarchically auto-numbered outliner with automatic permanent hyperlink
+      ids for each outline node (called cells).  Any type of Hyperbole button
+      can be embedded within Koutlines and external links can be made to
+      specific cells together with a specific view of the outline using an
+      implicit link type call a klink.
+
+    13a. {C-h h k e} creates a personal copy of an example Koutline file that
+         you can edit as you like; the content of that file explains Koutliner
+         concepts and commands.
+
+    13b. Like magic, {C-h h k f d}, converts this Koutline to HTML and displays
+         it in your web browser, with each tree fully collapsible and
+         expandable with your mouse.
+
+  14. Hyperbole's HyRolo subsystem on {C-h h r} can be used just as a contact
+      manager but it really is a generalized, record-oriented retrieval system
+      for files.  Simply set hyrolo-file-list to any list of Koutline, Emacs
+      Outline, Org, or Markdown files, any of which can contain any type of
+      Hyperbole button, and it will rapidly display string, word, regular
+      expression or logical query matches within each hierarchical entry of
+      each file.  Try it here: "DEMO#HyRolo".
+
+  15. Hyperbole's Find/ menu on {C-h h f} unifies finding and filtering through
+      lists of files and lines within those files.  It simplifies access to
+      Emacs and Posix utilities without the need to remember specific command
+      names.
+
+  16. Hyperbole's Find/Web menu on {C-h h f w} gives you ready access to many
+      structured web searches without having to remember site URLs or query
+      parameters.  It also offers access to Emacs' webjump package (type {j}
+      for Jump) to quickly jump to specific websites, similar to what {C-x r b}
+      does for Emacs Bookmarks.
+
+  17. In summary, Hyperbole integrates many disparate information management
+      capabilities spread throughout Emacs and the web and augments them with a
+      new set of hyperbutton types and control systems, all easily accessible
+      from a unified, keyboard driven minibuffer menu.
+
+    17a. Hyperbole lets you rapidly get to information whether local or remote,
+         whether via search or filtering, and then interlink it with other
+         information, display it where you need on your screen, and edit it
+         rapidly using multiple views in the Koutliner or via its Org mode
+         compatibility.
+
+    17b. If you learn to use just the implicit button types in Hyperbole, those
+         alone should greatly improve your Emacs productivity.  Then as you
+         learn more of Hyperbole's concepts, you can accelerate your
+         information management further across time.
+
+
+"ben" ;; kvspec:current
+38 ;; id-counter
+alpha ;; label-type
+4 ;; label-min-width
+". " ;; label-separator
+3 ;; level-indent
+
+;; depth-first kcell attributes
+[[0
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42" id-counter 38)]
+ [1
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [25
+  (creator "rsw@gnu.org" create-time "20230513:18:35:44")]
+ [26
+  (creator "rsw@gnu.org" create-time "20230513:18:35:46")]
+ [27
+  (creator "rsw@gnu.org" create-time "20230513:18:45:15")]
+ [23
+  (creator "rsw@gnu.org" create-time "20230513:18:33:50")]
+ [3
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [4
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [32
+  (creator "rsw@gnu.org" create-time "20230513:19:22:15")]
+ [5
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [18
+  (creator "rsw@gnu.org" create-time "20230513:18:22:23")]
+ [19
+  (creator "rsw@gnu.org" create-time "20230513:18:22:27")]
+ [21
+  (creator "rsw@gnu.org" create-time "20230513:18:26:47")]
+ [22
+  (creator "rsw@gnu.org" create-time "20230513:18:27:02")]
+ [38
+  (creator "rsw@gnu.org" create-time "20230513:20:13:11")]
+ [6
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [7
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [8
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [9
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [10
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [11
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [12
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [36
+  (creator "rsw@gnu.org" create-time "20230513:19:50:06")]
+ [37
+  (creator "rsw@gnu.org" create-time "20230513:19:50:14")]
+ [13
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [14
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [15
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [16
+  (creator "rsw@gnu.org" create-time "20230513:18:17:42")]
+ [31
+  (creator "rsw@gnu.org" create-time "20230513:19:08:35")]
+ [29
+  (creator "rsw@gnu.org" create-time "20230513:19:06:51")]
+ nil nil nil nil nil nil nil nil nil]
diff --git a/HY-NEWS b/HY-NEWS
index 3bcf70955f..e82df5ea84 100644
--- a/HY-NEWS
+++ b/HY-NEWS
@@ -5,7 +5,7 @@
 *                                   V8.0.1pre
 ===========================================================================
 
-** ACTION TYPES
+** ACTION TYPES  (See "(hyperbole)Action Types").
 
   *** display-boolean, display-value, display-variable: Made all of these
       interactive, so can be used as button actypes.  See "(hyperbole)
@@ -25,10 +25,14 @@
         - Build a Zettelkasten with HyRolo: The video is at
           "https://emacsconf.org/2022/talks/rolodex/";.
 
+  *** Hyperbole Concepts: New writeup in Koutline format for those who
+      want a quick read about how Hyperbole concepts all interrelate.
+      View it with {C-h h d c}.
+
   *** Action Types: Added newer types and updated existing doc summaries
       in the Hyperbole manual.  See "(hyperbole)Action Types".
 
-  *** Documented these Hyperbole minibuffer menu keys:
+  *** New Menu Key Doc: Documented these Hyperbole minibuffer menu keys:
 
         - {Q} always quits from the menu without selecting anything
 
@@ -110,7 +114,12 @@
         - {,} Move to the beginning of the current entry
         - {.} Move to the end of the current entry
 
-      See "(hyperbole)Hyrolo Keys".
+      See "(hyperbole)HyRolo Keys".
+
+  *** Koutline and Markdown File Support: The `hyrolo-file-list' can now
+      contain Koutline or Markdown files and will search their outline entries
+      just like it does for Org and Emacs outline files.  See
+      "(hyperbole)HyRolo Concepts".
 
   *** Koutline Fast Search: Koutlines may now be included in
       `hyrolo-file-list' and individual cells extracted properly with any
@@ -123,11 +132,6 @@
        {f/b/n/p} move to another match
 
       all work on Koutline cells displayed in the match buffer.  See
-      "(hyperbole) HyRolo Concepts".
-
-  *** Koutline and Markdown File Support: The `hyrolo-file-list' can now
-      contain Koutline or Markdown files and will search their outline entries
-      just like it does for Org and Emacs outline files.  See
       "(hyperbole)HyRolo Concepts".
 
   *** Match Buffer Name Change: Changed match buffer name from "*Hyperbole
@@ -143,7 +147,7 @@
       exclusively.  See "(hyperbole)ConsultFind".
 
 
-** IMPLICIT BUTTONS
+** IMPLICIT BUTTONS  (See "(hyperbole)Implicit Buttons").
 
   *** Action Button Result Display: Action buttons now display in the
       minibuffer the result of evaluating any type of action expression,
@@ -224,6 +228,10 @@
 
   *** Minibuffer Menu Changes:
 
+        - Reload Menus and Smart Keys: Action Key press on top-level menu 
prefix
+          reloads Hyperbole minibuffer menus and Smart Key handlers to reflect
+          any recent edits.
+
         - Multi-line Menus: When a menu line is too long for the screen, it is
           automatically split into multiple lines and aligned by column for
           ease of access.
@@ -233,7 +241,7 @@
       as do {TAB} and {Shift-TAB}.  See "(hyperbole)minibuffer menu".
 
 
-** PROGRAMMING INTERFACE CHANGES
+** PROGRAMMING INTERFACE CHANGES  (See "(hyperbole)Embedding Hyperbole").
 
   *** (hypb:devdocs-lookup): Install and load devdocs package and then
       call its `devdocs-lookup' function.
@@ -414,7 +422,7 @@
       across modes.  See "(hyperbole)Smart Key - Dired Mode".
 
 
-** TEST CASES
+** TEST CASES  (See "${hyperb:dir}/test").
 
   *** Hyperbole Automated Testing: Automated test cases increased to over 285.
       Simply run 'make test-all' or 'make test' from the command-line when in
diff --git a/MANIFEST b/MANIFEST
index 6e86b0ef91..5d0c5adc91 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -5,6 +5,7 @@ DEMO-ROLO.otl        - Sample Hyperbole Rolo file for use with 
DEMO
 hyrolo-demo.el       - Code to support DEMO introduction to HyRolo
 HY-ABOUT             - Introductory description of GNU Hyperbole
 HY-ANNOUNCE          - GNU Hyperbole release announcement
+HY-CONCEPTS.kotl     - Techncial introduction to Hyperbole concept 
interrelations
 HY-COPY              - GNU Hyperbole Copyright
 HY-NEWS              - What's new in each release of GNU Hyperbole
 HY-TALK.org          - Source slides and video link from the author's 2020 
talk on Hyperbole
diff --git a/Makefile b/Makefile
index 3545971d98..6d881daee6 100644
--- a/Makefile
+++ b/Makefile
@@ -3,7 +3,7 @@
 # Author:       Bob Weiner
 #
 # Orig-Date:    15-Jun-94 at 03:42:38
-# Last-Mod:      7-May-23 at 20:33:02 by Bob Weiner
+# Last-Mod:     13-May-23 at 14:57:28 by Bob Weiner
 #
 # Copyright (C) 1994-2023  Free Software Foundation, Inc.
 # See the file HY-COPY for license information.
@@ -200,7 +200,8 @@ ELC_KOTL = $(EL_KOTL:.el=.elc)
 HY-TALK  = HY-TALK/.hypb HY-TALK/HYPB HY-TALK/HY-TALK.org
 
 HYPERBOLE_FILES = dir info html $(EL_COMPILE) $(EL_KOTL) \
-       $(ELC_COMPILE) $(HY-TALK) ChangeLog COPYING Makefile HY-ABOUT 
HY-ANNOUNCE HY-NEWS \
+       $(ELC_COMPILE) $(HY-TALK) ChangeLog COPYING Makefile HY-ABOUT 
HY-ANNOUNCE \
+        HY-CONCEPTS.kotl HY-NEWS \
        HY-WHY.kotl INSTALL DEMO DEMO-ROLO.otl FAST-DEMO MANIFEST README 
README.md TAGS _hypb \
         .hypb smart-clib-sym topwin.py hyperbole-banner.png 
$(man_dir)/hkey-help.txt \
        $(man_dir)/hyperbole.texi $(man_dir)/hyperbole.css 
$(man_dir)/version.texi
@@ -347,7 +348,7 @@ TAGS: $(EL_TAGS)
 clean:
        $(RM) hyperbole-autoloads.el kotl/kotl-autoloads.el $(ELC_COMPILE) 
$(ELC_KOTL) TAGS
 
-version: doc
+version:
        @ echo ""
        @ fgrep -L $(HYPB_VERSION) hyperbole-pkg.el Makefile HY-ABOUT HY-NEWS 
README.md hversion.el hyperbole.el man/hyperbole.texi man/version.texi > 
WRONG-VERSIONS
        @ # If any file(s) have wrong version number, print them and exit with 
code 1
@@ -360,7 +361,7 @@ version: doc
        @ echo ""
 
 # Build the README.md.html and Info, HTML and Postscript versions of the user 
manual
-doc: README.md.html manual
+doc: version README.md.html manual
 
 # Build the Info, HTML and Postscript versions of the user manual
 manual: info html pdf
diff --git a/hargs.el b/hargs.el
index 5f9d59138b..4f2f423a8d 100644
--- a/hargs.el
+++ b/hargs.el
@@ -3,7 +3,7 @@
 ;; Author:       Bob Weiner
 ;;
 ;; Orig-Date:    31-Oct-91 at 23:17:35
-;; Last-Mod:     16-Mar-23 at 21:41:09 by Bob Weiner
+;; Last-Mod:     11-May-23 at 23:00:00 by Bob Weiner
 ;;
 ;; SPDX-License-Identifier: GPL-3.0-or-later
 ;;
@@ -651,7 +651,7 @@ help when appropriate."
              (set-buffer (window-buffer (minibuffer-window)))
              (cond
               ;;
-              ;; Selecting a menu item
+              ;; Selecting a Hyperbole minibuffer menu item
               ((eq hargs:reading-type 'hmenu)
                (when assist-bool
                  (setq hargs:reading-type 'hmenu-help))
diff --git a/hui-menu.el b/hui-menu.el
index 19dca91b6e..8a0d64229f 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:     29-Mar-23 at 22:05:18 by Bob Weiner
+;; Last-Mod:     13-May-23 at 15:37:30 by Bob Weiner
 ;;
 ;; SPDX-License-Identifier: GPL-3.0-or-later
 ;;
@@ -355,9 +355,12 @@ REBUILD-FLAG is non-nil, in which case the menu is 
rebuilt."
                 '("Documentation"
                   ["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]
                   ["Demonstration"  hyperbole-demo t]
+                  ["Files"       (hypb:display-file-with-logo "MANIFEST") t]
                   ["Glossary"    (id-info "(hyperbole)Glossary") t]
-                  ["Manifest"    (hypb:display-file-with-logo "MANIFEST") 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"
@@ -368,7 +371,8 @@ REBUILD-FLAG is non-nil, in which case the menu is rebuilt."
                    ["Show-Action-Types"
                     (hui:htype-help-current-window 'actypes) t]
                    ["Show-Implicit-Button-Types"
-                    (hui:htype-help-current-window 'ibtypes 'no-sort) t]))
+                    (hui:htype-help-current-window 'ibtypes 'no-sort) 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 9489e13aaa..685c23ef97 100644
--- a/hui-mini.el
+++ b/hui-mini.el
@@ -744,6 +744,8 @@ The menu is a menu of commands from MENU-ALIST."
        '(doc .
         (("Doc>")
          ("About"       (hypb:display-file-with-logo "HY-ABOUT") "Overview of 
Hyperbole.")
+         ("Concepts"    (find-file (expand-file-name "HY-CONCEPTS.kotl" 
hyperb:dir))
+          "Explains connections among Hyperbole concepts.")
          ("Demo"        hyperbole-demo                           "Demonstrates 
Hyperbole features.")
          ("Files"       (hypb:display-file-with-logo "MANIFEST")
           "Summarizes Hyperbole system files.  Click on an entry to view it.")