[elpa] externals/hyperbole 946225e 2/3: Update installation instructions for new hyperbole-mode

[ELPA Syncer]

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

    Update installation instructions for new hyperbole-mode
---
 INSTALL            | 59 ++++++++++++++++++++++++++++++++----------------------
 man/hyperbole.texi |  7 +++----
 2 files changed, 38 insertions(+), 28 deletions(-)

diff --git a/INSTALL b/INSTALL
index 50324a9..d4b8824 100644
--- a/INSTALL
+++ b/INSTALL
@@ -12,35 +12,24 @@
 # This file is part of GNU Hyperbole.
 
 ===========================================================================
-*                       Browsing the Source
+*                         Installation
 ===========================================================================
 
-To explore the Hyperbole source code rather than installing it for use,
-download a tar.gz source archive from either:
+There are multiple package managers you can use to install Hyperbole once
+you have GNU Emacs set up at your site.
 
-    ftp://ftp.gnu.org/gnu/hyperbole/
-
-or
+** The built-in Emacs package manager
 
-    http://ftpmirror.gnu.org/hyperbole/
-
-which will find the closest mirror of the GNU ftp site and show it to you.
-
-===========================================================================
-*                         Installation
-===========================================================================
-
-Once you have Emacs set up at your site, GNU Hyperbole may be
-installed by using the Emacs Package Manager.  If you are not
-familiar with it, see the Packages section of the GNU Emacs Manual,
-"(emacs)Packages", or
-"https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html";. 
+The Emacs Package Manager installs the latest stable version release
+of GNU Hyperbole.  If you are not familiar with it, see the Packages
+section of the GNU Emacs Manual, "(emacs)Packages", or
+"https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html";.
 
 If you have Hyperbole 5.10 or higher already installed and simply want to
 upgrade it, invoke the Emacs Package Manager with {M-x list-packages RET},
 then use the {U} key followed by the {x} key to upgrade all out-of-date
 packages, Hyperbole among them.  Then skip the text below and move on to
-the next section, Invocation.
+the section, Invocation.
 
 Otherwise, to download and install the Hyperbole package, you should add
 several lines to your personal Emacs initialization file, typically "~/.emacs".
@@ -50,8 +39,8 @@ several lines to your personal Emacs initialization file, 
typically "~/.emacs".
 Below are the lines to add:
 
 (require 'package)
-(setq package-enable-at-startup nil) ;; Prevent double loading of libraries
-(package-initialize)
+(when (< emacs-major-version 27)
+  (package-initialize))
 (unless (package-installed-p 'hyperbole)
   (package-refresh-contents)   
   (package-install 'hyperbole))
@@ -64,6 +53,28 @@ downloaded and compiled for use with your version of Emacs; 
give it a
 minute or two.  You may see a bunch of compilation warnings but these
 can be safely ignored.
 
+**
+
+===========================================================================
+*                       Browsing the Source
+===========================================================================
+
+To explore the Hyperbole source code online rather than installing it
+for use (which will also give you the source code), open a web page
+to:
+
+  https://git.savannah.gnu.org/cgit/hyperbole.git/tree/
+
+Alternatively, you may download a tar.gz source archive from either:
+
+  ftp://ftp.gnu.org/gnu/hyperbole/
+
+or
+
+  http://ftpmirror.gnu.org/hyperbole/
+
+which will find the closest mirror of the GNU ftp site and show it to you.
+
 ===========================================================================
 *                          Invocation
 ===========================================================================
@@ -85,8 +96,8 @@ You can invoke Hyperbole commands in one of three ways:
    use a specific Hyperbole command such as an Action Key click {M-RET} on
    a pathname to display the associated file or directory.
 
-Use {C-h h d d} for an interactive demonstration of standard Hyperbole
-button capabilities.
+Use {C-h h d d} for an extensive, interactive demonstration of
+standard Hyperbole button capabilities.
 
 {C-h h k e} offers an interactive demonstration of the Koutliner,
 Hyperbole's multi-level autonumbered hypertextual outliner.
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index 60e6d11..b6046c2 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -6879,13 +6879,12 @@ Below are the lines to add:
 
 @lisp
 (require 'package)
-;; Prevent double loading of libraries
-(setq package-enable-at-startup nil)
-(package-initialize)
+(when (< emacs-major-version 27)
+  (package-initialize))
 (unless (package-installed-p 'hyperbole)
   (package-refresh-contents)   
   (package-install 'hyperbole))
-(require 'hyperbole)
+(hyperbole-mode 1)
 @end lisp
 
 Now save the file and restart Emacs.  Hyperbole will then be