[elpa] externals/hyperbole 547c18f 26/53: Added gh#status to show github status; eliminated annot-bib matches from programming modes.

[Robert Weiner]

branch: externals/hyperbole
commit 547c18f59a74c40c015943cf91a8345900859284
Author: Bob Weiner <address@hidden>
Commit: Bob Weiner <address@hidden>

    Added gh#status to show github status; eliminated annot-bib matches from 
programming modes.
    
    2017-10-10  Bob Weiner  <address@hidden>
    
    * hyperbole.el (after-init-time): Add hyperb:init to the end of 
after-init-hook;
       previously was added at the beginning.  This is intended to ensure that 
Hyperbole
       key bindings are set after any others, notably {M-RET}.
    
    * hypb.el (hypb:rgrep-command): Changed to zgrep when available to handle 
compressed source files.
    
    2017-10-09  Bob Weiner  <address@hidden>
    
    * hibtypes.el (annot-bib): Eliminated matches for any programming mode 
(modes derived from `prog-mode').
    
    * README.md: Fixed link markup in Mailing Lists and Ftp and Git Source 
Code-only Downloads
    
    2017-10-08  Bob Weiner  <address@hidden>
    
    * man/hyperbole.texi (Implicit Buttons): Re-arranged types to reflect 
newest prioritization.
    
    * hib-social.el (github-reference): Added support for showing status of 
Github services
        with gh#status.
    
    2017-10-06  Bob Weiner  <address@hidden>
    
    * man/hyperbole.texi (Hiding and Showing): Added paragraph on using {C-x 4 
c} to clone
        a Koutline and display multiple views of it.  But commented this out 
because of an
        Emacs bug which alters the narrowing of indirect buffers after an 
outline hide or show.
---
 .hypb              | Bin 3645 -> 3832 bytes
 Changes            |  27 +++++++++++
 HY-ANNOUNCE-SHORT  |   5 ++-
 Makefile           |   3 +-
 README.md          |  18 ++++----
 README.md.html     |  32 +++++++-------
 hib-social.el      | 128 +++++++++++++++++++++++++++--------------------------
 hibtypes.el        |   3 +-
 hypb.el            |   3 +-
 hyperbole.el       |   2 +-
 man/hyperbole.html |  63 +++++++++++++-------------
 man/hyperbole.info | Bin 438289 -> 438357 bytes
 man/hyperbole.pdf  | Bin 798598 -> 798811 bytes
 man/hyperbole.texi |  79 ++++++++++++++++++++-------------
 14 files changed, 210 insertions(+), 153 deletions(-)

diff --git a/.hypb b/.hypb
index 914bbde..129b2b6 100644
Binary files a/.hypb and b/.hypb differ
diff --git a/Changes b/Changes
index 6f50c0d..90f7461 100644
--- a/Changes
+++ b/Changes
@@ -1,3 +1,30 @@
+2017-10-10  Bob Weiner  <address@hidden>
+
+* hyperbole.el (after-init-time): Added hyperb:init to the end of 
after-init-hook;
+   previously was added at the beginning.  This is intended to ensure that 
Hyperbole
+   key bindings are set after any others, notably {M-RET}.
+
+* hypb.el (hypb:rgrep-command): Changed to zgrep when available to handle 
compressed source files.
+
+2017-10-09  Bob Weiner  <address@hidden>
+
+* hibtypes.el (annot-bib): Eliminated matches for any programming mode (modes 
derived from `prog-mode').
+
+* README.md: Fixed link markup in Mailing Lists and Ftp and Git Source 
Code-only Downloads
+
+2017-10-08  Bob Weiner  <address@hidden>
+
+* man/hyperbole.texi (Implicit Buttons): Re-arranged types to reflect newest 
prioritization.
+
+* hib-social.el (github-reference): Added support for showing status of Github 
services
+    with gh#status.
+
+2017-10-06  Bob Weiner  <address@hidden>
+
+* man/hyperbole.texi (Hiding and Showing): Added paragraph on using {C-x 4 c} 
to clone
+    a Koutline and display multiple views of it.  But commented this out 
because of an
+    Emacs bug which alters the narrowing of indirect buffers after an outline 
hide or show.
+
 2017-10-06  Bob Weiner  <address@hidden>
 
 * man/hyperbole.texi (Version): Updated to 6.0.2d and rebuilt output formats.
diff --git a/HY-ANNOUNCE-SHORT b/HY-ANNOUNCE-SHORT
index 36a444f..d8114bb 100644
--- a/HY-ANNOUNCE-SHORT
+++ b/HY-ANNOUNCE-SHORT
@@ -74,8 +74,9 @@ See "Changes" file.
 
     - DEMO File: Added description and exercise using the new Find/Web menu.
 
-    - Added README.md.html introduction with images combining README, INSTALL
-      and HY-ABOUT information.
+    - Added README.md introduction with images combining README, INSTALL
+      and HY-ABOUT information.  This is automatically transformed to
+      README.md.html.
 
     - Full set of hand-written changes are now in the file "Changes".  The
       former name, ChangeLog, is now auto-generated from the version controlled
diff --git a/Makefile b/Makefile
index 85fcc5f..4e508d1 100644
--- a/Makefile
+++ b/Makefile
@@ -242,7 +242,7 @@ TAGS: $(EL_TAGS)
 version: doc
        @ echo ""
        @ echo "Any fgrep output means the version number has not been updated 
in that file."
-       fgrep -L $(HYPB_VERSION) Makefile HY-ABOUT HY-ANNOUNCE 
HY-ANNOUNCE-SHORT HY-NEWS hversion.el hyperbole-pkg.el man/hyperbole.texi 
man/version.texi
+       fgrep -L $(HYPB_VERSION) Makefile HY-ABOUT HY-ANNOUNCE 
HY-ANNOUNCE-SHORT HY-NEWS README.md hversion.el hyperbole-pkg.el 
man/hyperbole.texi man/version.texi
        @ echo ""
 
 # Build the Info, HTML and Postscript versions of the user manual and 
README.md.html.
@@ -261,6 +261,7 @@ $(man_dir)/hyperbole.pdf: $(man_dir)/hyperbole.texi 
$(man_dir)/version.texi $(ma
        cd $(man_dir) && $(TEXI2PDF) hyperbole.texi
 
 # github-markdown is an npm, installed with: npm install markdown-to-html -g
+#   Documentation is here: https://www.npmjs.com/package/markdown-to-html
 README.md.html: README.md
        github-markdown README.md > README.md.html
 
diff --git a/README.md b/README.md
index 14d93d3..df677af 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# GNU Hyperbole 6.0.2 - The Everyday Hypertextual Information Manager
+# GNU Hyperbole 6.0.2d - The Everyday Hypertextual Information Manager
 
 <!-- START doctoc generated TOC -->
 **Table of Contents**
@@ -99,24 +99,24 @@ through the GNU Emacs package manager.
 
 ## Mailing Lists
 
-    - address@hidden - User list for GNU Hyperbole
+   - address@hidden - User list for GNU Hyperbole
 
-           [info and 
subscription](http://lists.gnu.org/mailman/listinfo/hyperbole-users)
-        [web archive](http://lists.gnu.org/pipermail/hyperbole-users/)
+       [info and subscription]: 
http://lists.gnu.org/mailman/listinfo/hyperbole-users
+       [web archive]: http://lists.gnu.org/pipermail/hyperbole-users/
 
-    - address@hidden - List for bug reporting
+   - address@hidden - List for bug reporting
 
-        [info and 
subscription](http://lists.gnu.org/mailman/listinfo/bug-hyperbole)
-        [web archive](http://lists.gnu.org/archive/html/bug-hyperbole/)
+       [info and subscription]: 
http://lists.gnu.org/mailman/listinfo/bug-hyperbole
+       [web archive]: http://lists.gnu.org/archive/html/bug-hyperbole/
 
 ## Ftp and Git Source Code-only Downloads
 
 To explore the released Hyperbole source code rather than installing it for 
use,
 download a tar.gz source archive from either:</p>
 
-    - [ftp://ftp.gnu.org/gnu/hyperbole/]()
+   - ftp://ftp.gnu.org/gnu/hyperbole/
 
-    - [http://ftpmirror.gnu.org/hyperbole/]()
+   - http://ftpmirror.gnu.org/hyperbole/
 
 which will find the closest mirror of the GNU ftp site and show it to you.
 
diff --git a/README.md.html b/README.md.html
index 3313e74..059d709 100644
--- a/README.md.html
+++ b/README.md.html
@@ -1,5 +1,5 @@
 <h1>
-<a 
id="user-content-gnu-hyperbole-602---the-everyday-hypertextual-information-manager"
 class="anchor" 
href="#gnu-hyperbole-602---the-everyday-hypertextual-information-manager" 
aria-hidden="true"><span aria-hidden="true" class="octicon 
octicon-link"></span></a>GNU Hyperbole 6.0.2 - The Everyday Hypertextual 
Information Manager</h1>
+<a 
id="user-content-gnu-hyperbole-602d---the-everyday-hypertextual-information-manager"
 class="anchor" 
href="#gnu-hyperbole-602d---the-everyday-hypertextual-information-manager" 
aria-hidden="true"><span aria-hidden="true" class="octicon 
octicon-link"></span></a>GNU Hyperbole 6.0.2d - The Everyday Hypertextual 
Information Manager</h1>
 
 <p><strong>Table of Contents</strong></p>
 <ul>
@@ -97,24 +97,26 @@ If any term in here is new or unfamiliar to you, you can 
look it up in the
 through the GNU Emacs package manager.</p>
 <h2>
 <a id="user-content-mailing-lists" class="anchor" href="#mailing-lists" 
aria-hidden="true"><span aria-hidden="true" class="octicon 
octicon-link"></span></a>Mailing Lists</h2>
-<pre><code>- address@hidden - User list for GNU Hyperbole
-
-    [info and 
subscription](http://lists.gnu.org/mailman/listinfo/hyperbole-users)
-    [web archive](http://lists.gnu.org/pipermail/hyperbole-users/)
-
-- address@hidden - List for bug reporting
-
-    [info and 
subscription](http://lists.gnu.org/mailman/listinfo/bug-hyperbole)
-    [web archive](http://lists.gnu.org/archive/html/bug-hyperbole/)
-</code></pre>
+<ul>
+<li>
+<p><strong><a href="mailto:address@hidden";>address@hidden</a></strong> - User 
list for GNU Hyperbole</p>
+</li>
+<li>
+<p><strong><a href="mailto:address@hidden";>address@hidden</a></strong> - List 
for bug reporting</p>
+</li>
+</ul>
 <h2>
 <a id="user-content-ftp-and-git-source-code-only-downloads" class="anchor" 
href="#ftp-and-git-source-code-only-downloads" aria-hidden="true"><span 
aria-hidden="true" class="octicon octicon-link"></span></a>Ftp and Git Source 
Code-only Downloads</h2>
 <p>To explore the released Hyperbole source code rather than installing it for 
use,
 download a tar.gz source archive from either:</p>
-<pre><code>- [ftp://ftp.gnu.org/gnu/hyperbole/]()
-
-- [http://ftpmirror.gnu.org/hyperbole/]()
-</code></pre>
+<ul>
+<li>
+<p><a 
href="ftp://ftp.gnu.org/gnu/hyperbole/";>ftp://ftp.gnu.org/gnu/hyperbole/</a></p>
+</li>
+<li>
+<p><a 
href="http://ftpmirror.gnu.org/hyperbole/";>http://ftpmirror.gnu.org/hyperbole/</a></p>
+</li>
+</ul>
 <p>which will find the closest mirror of the GNU ftp site and show it to 
you.</p>
 <p>If you want to follow along with Hyperbole development and maintain a
 copy/clone of the current version-controlled git tree, use the
diff --git a/hib-social.el b/hib-social.el
index 6078f39..9ecec0a 100644
--- a/hib-social.el
+++ b/hib-social.el
@@ -306,68 +306,72 @@ USER defaults to the value of 
`hibtypes-github-default-user'.
 If given, PROJECT overrides any project value in REFERENCE.  If no
 PROJECT value is provided, it defaults to the value of
 `hibtypes-github-default-project'."
-  (if (or (null reference) (equal reference ""))
-      (error "(github-reference): Github reference must not be empty")
-    (let ((case-fold-search t)
-         (url-to-format (assoc-default "github" hibtypes-social-hashtag-alist 
#'string-match))
-         (ref-type))
-      (when url-to-format
-       (cond ((string-match "\\`\\(branch\\|commit\\|issue\\|pull\\|tag\\)/" 
reference)
-              ;; [branch | commit | issue | pull | tag]/ref-item
-              nil)
-             ((string-match 
"\\`/?\\(\\([^/address@hidden)/\\)\\([^/address@hidden)\\'" reference)
-              ;; /?user/project
-              (setq user (or user (match-string-no-properties 2 reference))
-                    project (or project (match-string-no-properties 3 
reference))
-                    reference nil))
-             ((string-match 
"\\`/?\\(\\([^/address@hidden)/\\)?\\([^/address@hidden)/\\(address@hidden)\\'" 
reference)
-              ;; /?[user/]project/ref-item
-              (setq user (or user (match-string-no-properties 2 reference))
-                    project (or project (match-string-no-properties 3 
reference))
-                    reference (match-string-no-properties 4 reference)))
-             ((string-match "\\`/\\([^/address@hidden)\\'" reference)
-              ;; /project
-              (setq project (or project (match-string-no-properties 1 
reference))
-                    reference nil)))
-       (unless (stringp user) (setq user hibtypes-github-default-user))
-       (unless (stringp project) (setq project 
hibtypes-github-default-project))
-       (when reference
-         (cond ((equal user "orgs")
-                ;; A specific organization reference
-                (setq ref-type reference
-                      reference ""))
-               ((member reference '("branches" "commits" "issues" "pulls" 
"tags"))
-                ;; All branches, commits, open issues, pull requests or commit 
tags reference
-                (setq ref-type reference
-                      reference ""))
-               ((and (< (length reference) 7) (string-match 
"\\`\\([gG][hH]-\\)?[0-9]+\\'" reference))
-                ;; Specific issue reference
-                (setq ref-type "issues/"))
-               ((string-match "\\`\\(commit\\|issue\\|pull\\)/" reference)
-                ;; Specific reference preceded by keyword branch, commit,
-                ;; issue, or pull
-                (setq ref-type (substring reference 0 (match-end 0))
-                      reference (substring reference (match-end 0))))
-               ((string-match "\\`[0-9a-f]+\\'" reference)
-                ;; Commit reference
-                (setq ref-type "commit/"))
-               (t
-                ;; Specific branch or commit tag reference
-                (setq ref-type "tree/")
-                (when (string-match "\\`\\(branch\\|tag\\)/" reference)
-                  ;; If preceded by optional keyword, remove that from the 
reference.
-                  (setq reference (substring reference (match-end 0)))))))
-       (if (and (stringp user) (stringp project))
-           (funcall hibtypes-social-display-function
-                    (if reference
-                        (format url-to-format user project ref-type reference)
-                      (format url-to-format user project "" "")))
-         (cond ((and (null user) (null project))
-                (error "(github-reference): Set `hibtypes-github-default-user' 
and `hibtypes-github-default-project'"))
-               ((null user)
-                (error "(github-reference): Set 
`hibtypes-github-default-user'"))
-               (t
-                (error "(github-reference): Set 
`hibtypes-github-default-project'"))))))))
+  (cond ((or (null reference) (equal reference ""))
+        (error "(github-reference): Github reference must not be empty"))
+       ((equal reference "status")
+        (funcall hibtypes-social-display-function "https://status.github.com";))
+       (t (let ((case-fold-search t)
+                (url-to-format (assoc-default "github" 
hibtypes-social-hashtag-alist #'string-match))
+                (ref-type))
+            (when url-to-format
+              (cond ((string-match 
"\\`\\(branch\\|commit\\|issue\\|pull\\|tag\\)/" reference)
+                     ;; [branch | commit | issue | pull | tag]/ref-item
+                     nil)
+                    ((string-match 
"\\`/?\\(\\([^/address@hidden)/\\)\\([^/address@hidden)\\'" reference)
+                     ;; /?user/project
+                     (setq user (or user (match-string-no-properties 2 
reference))
+                           project (or project (match-string-no-properties 3 
reference))
+                           reference nil))
+                    ((string-match 
"\\`/?\\(\\([^/address@hidden)/\\)?\\([^/address@hidden)/\\(address@hidden)\\'" 
reference)
+                     ;; /?[user/]project/ref-item
+                     (setq user (or user (match-string-no-properties 2 
reference))
+                           project (or project (match-string-no-properties 3 
reference))
+                           reference (match-string-no-properties 4 reference)))
+                    ((string-match "\\`/\\([^/address@hidden)\\'" reference)
+                     ;; /project
+                     (setq project (or project (match-string-no-properties 1 
reference))
+                           reference nil)))
+              (unless (stringp user) (setq user hibtypes-github-default-user))
+              (unless (stringp project) (setq project 
hibtypes-github-default-project))
+              (when reference
+                (cond ((equal user "orgs")
+                       ;; A specific organization reference
+                       (setq ref-type reference
+                             reference ""))
+                      ((member reference '("branches" "commits" "issues" 
"pulls" "tags"))
+                       ;; All branches, commits, open issues, pull requests or 
commit tags reference
+                       (setq ref-type reference
+                             reference ""))
+                      ((and (< (length reference) 7) (string-match 
"\\`\\([gG][hH]-\\)?[0-9]+\\'" reference))
+                       ;; Specific issue reference
+                       (setq ref-type "issues/"))
+                      ((string-match "\\`\\(commit\\|issue\\|pull\\)/" 
reference)
+                       ;; Specific reference preceded by keyword branch, 
commit,
+                       ;; issue, or pull
+                       (setq ref-type (substring reference 0 (match-end 0))
+                             reference (substring reference (match-end 0))))
+                      ((string-match "\\`[0-9a-f]+\\'" reference)
+                       ;; Commit reference
+                       (setq ref-type "commit/"))
+                      (t
+                       ;; Specific branch or commit tag reference
+                       (setq ref-type "tree/")
+                       (when (string-match "\\`\\(branch\\|tag\\)/" reference)
+                         ;; If preceded by optional keyword, remove that from 
the reference.
+                         (setq reference (substring reference (match-end 
0)))))))
+              (if (and (stringp user) (stringp project))
+                  (funcall hibtypes-social-display-function
+                           (if reference
+                               (format url-to-format user project ref-type 
reference)
+                             (format url-to-format user project "" "")))
+                (cond ((and (null user) (null project))
+                       (error "(github-reference): Set 
`hibtypes-github-default-user' and `hibtypes-github-default-project'"))
+                      ((null user)
+                       (error "(github-reference): Set 
`hibtypes-github-default-user'"))
+                      (t
+                       (error "(github-reference): Set 
`hibtypes-github-default-project'")))))
+            (unless url-to-format
+              (error "(github-reference): Add an entry for github to 
`hibtypes-social-hashtag-alist'"))))))
 
 ;;; Local git repository commit references
 
diff --git a/hibtypes.el b/hibtypes.el
index fcdb1dd..e294827 100644
--- a/hibtypes.el
+++ b/hibtypes.el
@@ -225,7 +225,8 @@ must have an attached file."
        buffer-file-name
        (let ((chr (aref (buffer-name) 0)))
         (not (or (eq chr ?\ ) (eq chr ?*))))
-       (not (memq major-mode '(c-mode objc-mode c++-mode java-mode 
markdown-mode)))
+       (not (or (derived-mode-p 'prog-mode)
+               (memq major-mode '(c-mode objc-mode c++-mode java-mode 
markdown-mode))))
        (let* ((ref-and-pos (hbut:label-p t "[" "]" t))
              (ref (car ref-and-pos)))
         (and ref (eq ?w (char-syntax (aref ref 0)))
diff --git a/hypb.el b/hypb.el
index 0244267..3bc087a 100644
--- a/hypb.el
+++ b/hypb.el
@@ -26,7 +26,8 @@
   "Prefix attached to all native Hyperbole help buffer names.
 This should end with a space.")
 
-(defcustom hypb:rgrep-command "grep -insIHr "
+(defcustom hypb:rgrep-command
+  (format "%sgrep -insIHr " (if (executable-find "zgrep") "z" ""))
   "*Grep command string and initial arguments to send to `hypb:rgrep' command.
 It must end with a space."
   :type 'string
diff --git a/hyperbole.el b/hyperbole.el
index 5ac5f6a..848e3d1 100644
--- a/hyperbole.el
+++ b/hyperbole.el
@@ -672,7 +672,7 @@ If FLAG is nil then text is shown, while if FLAG is t the 
text is hidden."
 (if after-init-time
     (hyperb:init)
   ;; Initialize after other key bindings are loaded at startup.
-  (add-hook 'after-init-hook #'hyperb:init))
+  (add-hook 'after-init-hook #'hyperb:init t))
 
 (makunbound 'hyperbole-loading)
 
diff --git a/man/hyperbole.html b/man/hyperbole.html
index 1c0d964..6a37bf3 100644
--- a/man/hyperbole.html
+++ b/man/hyperbole.html
@@ -1562,15 +1562,29 @@ Each line of the summary may be selected to jump to the 
associated section.
 <dd><p>Displays any in-file Markdown link referent.  Pathnames and urls are
 handled elsewhere.
 </p>
-<a name="index-ibtypes-annot_002dbib"></a>
-<a name="index-bibliography"></a>
-<a name="index-reference"></a>
+<a name="index-ibtypes-social_002dreference"></a>
+<a name="index-hashtag"></a>
+<a name="index-username"></a>
+<a name="index-social-media"></a>
+<a name="index-social-reference"></a>
+<a name="index-hibtypes_002dsocial_002ddefault_002dservice"></a>
 </dd>
-<dt><code>annot-bib</code></dt>
-<dd><p>Displays annotated bibliography entries defined within the same buffer
-as the reference.  References must be delimited by square brackets, must
-begin with a word constituent character, and must not be in buffers
-whose names begin with a &lsquo; &rsquo; or &lsquo;*&rsquo; character.
+<dt><code>social-reference</code></dt>
+<dd><p>Displays the web page associated with a social media hashtag or username
+reference at point.  Reference format is:
+</p>
+<div class="smallexample">
+<pre 
class="smallexample">[facebook|instagram|address@hidden&lt;hashtag-or-username&gt;
 or
+[fb|in|address@hidden&lt;hashtag-or-username&gt;
+</pre></div>
+
+<p>For example, &lsquo;<samp>address@hidden</samp>&rsquo; displays the home 
page for facebook user
+&lsquo;<samp>someuser</samp>&rsquo; and &lsquo;<samp>in#hashtag</samp>&rsquo; 
displays photos with the hashtag
+&lsquo;<samp>hashtag</samp>&rsquo;.  The first part of the label for a button 
of this type
+is the social media service name.  The service name defaults to the
+value of <code>hibtypes-social-default-service</code> (default value of
+&ldquo;twitter&rdquo;) when not given, so #hashtag would be the same as
+twitter#hashtag.
 </p>
 <a name="index-ibtypes-debbugs_002dgnu_002dmode"></a>
 <a name="index-bug-tracking"></a>
@@ -1606,29 +1620,15 @@ bug#id-number?attr1=val1&amp;attr2=val2&amp;attr3=val3
 of <em>bug</em>.  See the documentation at the top of
 the <samp>hib-debbugs.el</samp> file for detailed query format information.
 </p>
-<a name="index-ibtypes-social_002dreference"></a>
-<a name="index-hashtag"></a>
-<a name="index-username"></a>
-<a name="index-social-media"></a>
-<a name="index-social-reference"></a>
-<a name="index-hibtypes_002dsocial_002ddefault_002dservice"></a>
+<a name="index-ibtypes-annot_002dbib"></a>
+<a name="index-bibliography"></a>
+<a name="index-reference"></a>
 </dd>
-<dt><code>social-reference</code></dt>
-<dd><p>Displays the web page associated with a social media hashtag or username
-reference at point.  Reference format is:
-</p>
-<div class="smallexample">
-<pre 
class="smallexample">[facebook|instagram|address@hidden&lt;hashtag-or-username&gt;
 or
-[fb|in|address@hidden&lt;hashtag-or-username&gt;
-</pre></div>
-
-<p>For example, &lsquo;<samp>address@hidden</samp>&rsquo; displays the home 
page for facebook user
-&lsquo;<samp>someuser</samp>&rsquo; and &lsquo;<samp>in#hashtag</samp>&rsquo; 
displays photos with the hashtag
-&lsquo;<samp>hashtag</samp>&rsquo;.  The first part of the label for a button 
of this type
-is the social media service name.  The service name defaults to the
-value of <code>hibtypes-social-default-service</code> (default value of
-&ldquo;twitter&rdquo;) when not given, so #hashtag would be the same as
-twitter#hashtag.
+<dt><code>annot-bib</code></dt>
+<dd><p>Displays annotated bibliography entries defined within the same buffer
+as the reference.  References must be delimited by square brackets, must
+begin with a word constituent character, and must not be in buffers
+whose names begin with a &lsquo; &rsquo; or &lsquo;*&rsquo; character.
 </p>
 
 <a name="index-ibtypes-function_002din_002dbuffer"></a>
@@ -4622,6 +4622,9 @@ system yet, so that you can get effective views of an 
outline without
 editing it.  Some of these commands affect the current view spec.
 See <a href="#View-Specs">View Specs</a>.
 </p>
+
+<p>Here are the major commands for showing and hiding Koutline cells.
+</p>
 <dl compact="compact">
 <dd><a name="index-hide-tree"></a>
 <a name="index-tree_002c-show"></a>
diff --git a/man/hyperbole.info b/man/hyperbole.info
index 7ac02ce..e89e7ab 100644
Binary files a/man/hyperbole.info and b/man/hyperbole.info differ
diff --git a/man/hyperbole.pdf b/man/hyperbole.pdf
index 9d6a97a..ea03aa3 100644
Binary files a/man/hyperbole.pdf and b/man/hyperbole.pdf differ
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index 110b99c..a433425 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -1187,14 +1187,29 @@ Each line of the summary may be selected to jump to the 
associated section.
 Displays any in-file Markdown link referent.  Pathnames and urls are
 handled elsewhere.
 
address@hidden ibtypes annot-bib
address@hidden bibliography
address@hidden reference
address@hidden annot-bib
-Displays annotated bibliography entries defined within the same buffer
-as the reference.  References must be delimited by square brackets, must
-begin with a word constituent character, and must not be in buffers
-whose names begin with a ` ' or `*' character.
address@hidden ibtypes social-reference
address@hidden hashtag
address@hidden username
address@hidden social media
address@hidden social reference
address@hidden hibtypes-social-default-service
address@hidden social-reference
+Displays the web page associated with a social media hashtag or username
+reference at point.  Reference format is:
+
address@hidden
+[facebook|instagram|twitter]?[#@@]<hashtag-or-username> or
+[fb|in|tw]?[#@@]<hashtag-or-username>
address@hidden smallexample
+
address@hidden
+For example, @samp{fb@@someuser} displays the home page for facebook user
address@hidden and @samp{in#hashtag} displays photos with the hashtag
address@hidden  The first part of the label for a button of this type
+is the social media service name.  The service name defaults to the
+value of @code{hibtypes-social-default-service} (default value of
+``twitter'') when not given, so #hashtag would be the same as
+twitter#hashtag.
 
 @findex ibtypes debbugs-gnu-mode
 @cindex bug tracking
@@ -1229,29 +1244,14 @@ Note that @emph{issue} or @emph{debbugs} may be used as 
well in place
 of @emph{bug}.  See the documentation at the top of
 the @file{hib-debbugs.el} file for detailed query format information.
 
address@hidden ibtypes social-reference
address@hidden hashtag
address@hidden username
address@hidden social media
address@hidden social reference
address@hidden hibtypes-social-default-service
address@hidden social-reference
-Displays the web page associated with a social media hashtag or username
-reference at point.  Reference format is:
-
address@hidden
-[facebook|instagram|twitter]?[#@@]<hashtag-or-username> or
-[fb|in|tw]?[#@@]<hashtag-or-username>
address@hidden smallexample
-
address@hidden
-For example, @samp{fb@@someuser} displays the home page for facebook user
address@hidden and @samp{in#hashtag} displays photos with the hashtag
address@hidden  The first part of the label for a button of this type
-is the social media service name.  The service name defaults to the
-value of @code{hibtypes-social-default-service} (default value of
-``twitter'') when not given, so #hashtag would be the same as
-twitter#hashtag.
address@hidden ibtypes annot-bib
address@hidden bibliography
address@hidden reference
address@hidden annot-bib
+Displays annotated bibliography entries defined within the same buffer
+as the reference.  References must be delimited by square brackets, must
+begin with a word constituent character, and must not be in buffers
+whose names begin with a ` ' or `*' character.
 
 @c Handled instead by @xref{Smart Key - Identifier Menu Mode}.
 @c @findex ibtypes imenu-item
@@ -3746,6 +3746,23 @@ system yet, so that you can get effective views of an 
outline without
 editing it.  Some of these commands affect the current view spec.
 @xref{View Specs}.
 
address@hidden Emacs (as of Emacs 26) will sometimes undo the narrowing of an 
indirect buffer
address@hidden when outline items are hidden or shown.  Don't mention or add 
this feature until
address@hidden this bug is fixed.
address@hidden
address@hidden @cindex cloning
address@hidden @cindex outline, cloning
address@hidden @cindex outline, multiple views
address@hidden @kindex C-x 4 c
address@hidden If you want to see multiple perspectives of the same Koutline, 
use
address@hidden @address@hidden 4 address@hidden to create a clone of any 
current Koutline.  Any edits
address@hidden made to the original buffer or the clone are shared but when you 
alter
address@hidden the view in one, it does not affect the other, so you can expand 
and
address@hidden collapse or change viewspecs to create different perspectives.
+
address@hidden
+Here are the major commands for showing and hiding Koutline cells.
+
 @table @asis
 @cindex hide tree
 @cindex tree, show