[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/hyperbole 49f6799 1/3: Update INSTALL and hyperbole.tex
|
From: |
ELPA Syncer |
|
Subject: |
[elpa] externals/hyperbole 49f6799 1/3: Update INSTALL and hyperbole.texi manual install instructions |
|
Date: |
Sun, 16 May 2021 16:57:10 -0400 (EDT) |
branch: externals/hyperbole
commit 49f67999c1d6d05d66650f1b3de82c8cab352b1f
Author: Bob Weiner <rsw@gnu.org>
Commit: Bob Weiner <rsw@gnu.org>
Update INSTALL and hyperbole.texi manual install instructions
---
ChangeLog | 3 ++
INSTALL | 44 ++++++++++++++++++++---
man/hyperbole.html | 104 +++++++++++++++++++++++++++++------------------------
man/hyperbole.info | Bin 553862 -> 554216 bytes
man/hyperbole.pdf | Bin 1308520 -> 1308789 bytes
man/hyperbole.texi | 88 ++++++++++++++++++++++++++-------------------
6 files changed, 152 insertions(+), 87 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 4dd5ba6..c516455 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -5,6 +5,9 @@
2021-05-16 Bob Weiner <rsw@gnu.org>
+* INSTALL (Manual Tarball Archive Installation): Add.
+ man/hyperbole.texi (Manual Tarball Archive Installation): Update.
+
* hyperbole.el (hyperb:maybe-load-autoloads): Add and call from hyperb:init.
* Makefile (hyperbole-autoloads.el, kotl/kotl-autoloads.el):
diff --git a/INSTALL b/INSTALL
index c17cde0..439daa6 100644
--- a/INSTALL
+++ b/INSTALL
@@ -15,7 +15,7 @@
* Installation
===========================================================================
-There are multiple package managers you can use to install Hyperbole once
+There are multiple wasy to obtain and install Hyperbole once
you have GNU Emacs set up at your site.
** The Built-in Emacs Package Manager
@@ -54,10 +54,12 @@ can be safely ignored.
** The Straight Package Manager (direct from Git Sources)
-If you prefer to track Hyperbole development between releases and like to try
out new features
-still in testing, then use the Straight package manager instead of the above,
which pulls the
-latest Hyperbole source code from its git repository. This also gives you a
cleaner installation
-process without showing you any byte compilation warnings.
+If you prefer to track Hyperbole development between releases and like
+to try out new features still in testing, then use the Straight
+package manager instead of the above, which pulls the latest Hyperbole
+source code from its git repository. This also gives you a cleaner
+installation process without showing you any byte compilation
+warnings.
;; Use this in your Emacs init file to install Straight
(progn
@@ -82,6 +84,38 @@ process without showing you any byte compilation warnings.
:repo "https://git.savannah.gnu.org/git/hyperbole.git";
:config (hyperbole-mode 1)))
+** Manual Tarball Archive Installation (stable or pre-release)
+
+If you are old-school, don't like package managers, and prefer doing
+everything by hand, then you can obtain Hyperbole from a tarball:
+
+Download either:
+
+1. a stable release 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;
+
+or
+
+2. the latest in-development pre-release tar.gz source archive linked
+to at the top of this web page:
+https://elpa.gnu.org/devel/hyperbole.html.
+
+Then decompress and unpack the archive to a directory of your
+choosing. Move into the "hyperbole/" directory and execute
+the following Posix shell command, "make bin", to
+byte-compile the Hyperbole lisp files. Then add the following
+lines to your personal Emacs initialization file,
+"~/.emacs":
+
+(unless (and (featurep 'hyperbole) hyperbole-mode)
+ (push "<directory-ending-with-hyperbole-where-you-unpacked>" load-path)
+ (require 'hyperbole)
+ (hyperbole-mode 1))
+
+Restart Emacs and you should see the "Hypb" hyperbole minor mode
+indicator in your modeline after startup.
===========================================================================
* Browsing the Source
diff --git a/man/hyperbole.html b/man/hyperbole.html
index 9193d0a..862cf41 100644
--- a/man/hyperbole.html
+++ b/man/hyperbole.html
@@ -234,8 +234,8 @@ ul.no-bullet {list-style: none}
<li><a id="toc-Installation-1" href="#Installation">B.1 Installation</a>
<ul class="no-bullet">
<li><a
id="toc-Stable-Package-Installation-_0028Emacs-Package-Manager_0029"
href="#Stable-Package-Installation">B.1.1 Stable Package Installation (Emacs
Package Manager)</a></li>
- <li><a id="toc-Manual-Stable-Release-Installation-1"
href="#Manual-Stable-Release-Installation">B.1.2 Manual Stable Release
Installation</a></li>
- <li><a
id="toc-Git-Pre_002drelease-Installation-_0028Straight-Package-Manager_0029"
href="#Git-Pre_002drelease-Installation">B.1.3 Git Pre-release Installation
(Straight Package Manager)</a></li>
+ <li><a
id="toc-Git-Pre_002drelease-Package-Installation-_0028Straight-Package-Manager_0029"
href="#Git-Pre_002drelease-Package-Installation">B.1.2 Git Pre-release Package
Installation (Straight Package Manager)</a></li>
+ <li><a id="toc-Manual-Tarball-Archive-Installation-1"
href="#Manual-Tarball-Archive-Installation">B.1.3 Manual Tarball Archive
Installation</a></li>
</ul></li>
<li><a id="toc-Invocation-1" href="#Invocation">B.2 Invocation</a></li>
<li><a id="toc-Customization-1" href="#Customization">B.3 Customization</a>
@@ -358,7 +358,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
Edition 8.0.0pre
-Printed May 13, 2021.
+Printed May 16, 2021.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -685,9 +685,9 @@ Installation
</pre></th></tr><tr><td align="left" valign="top">• <a
href="#Stable-Package-Installation">Stable Package
Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Manual-Stable-Release-Installation">Manual Stable Release
Installation</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Git-Pre_002drelease-Installation">Git Pre-release
Installation</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Manual-Tarball-Archive-Installation">Manual Tarball Archive
Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
@@ -1325,7 +1325,7 @@ under an external window system.
<span id="index-smart-keys_002c-unshifted"></span>
<p>If you set the variable, <code>hmouse-middle-flag</code>, to
‘<samp>t</samp>’ before
loading Hyperbole, then you may also use the middle mouse key as the Action
-Key). If you want both the middle mouse key as the Action Key and the
+Key. If you want both the middle mouse key as the Action Key and the
right mouse key as the Assist Key for ease of use, then within your
personal <samp>~/.emacs</samp> file, add: <code>(add-hook 'hyperbole-init-hook
'hmouse-add-unshifted-smart-keys)</code> and then restart Emacs.
@@ -6512,7 +6512,7 @@ Previous: <a href="#HyRolo-Keys" accesskey="p"
rel="prev">HyRolo Keys</a>, Up: <
<span id="index-rolo_002c-personal"></span>
<p>The files used in any rolo search are given by the
<code>hyrolo-file-list</code> variable, whose default value is typically
-<code>("~/.rolo.otl"</code>. Searches scan only your personal rolo
file.
+<code>"~/.rolo.otl"</code>. Searches scan only your personal rolo
file.
Any entries added to this list should be absolute filenames. If a
file in the list does not exist or is not readable, it is skipped.
Files are searched in the order in which they appear in the list. In
@@ -8186,9 +8186,9 @@ you have GNU Emacs set up at your site.
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a
href="#Stable-Package-Installation" accesskey="1">Stable Package
Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Manual-Stable-Release-Installation" accesskey="2">Manual Stable Release
Installation</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Git-Pre_002drelease-Package-Installation" accesskey="2">Git Pre-release
Package Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">• <a
href="#Git-Pre_002drelease-Installation" accesskey="3">Git Pre-release
Installation</a></td><td> </td><td align="left" valign="top">
+<tr><td align="left" valign="top">• <a
href="#Manual-Tarball-Archive-Installation" accesskey="3">Manual Tarball
Archive Installation</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
@@ -8197,7 +8197,7 @@ you have GNU Emacs set up at your site.
<hr>
<span id="Stable-Package-Installation"></span><div class="header">
<p>
-Next: <a href="#Manual-Stable-Release-Installation" accesskey="n"
rel="next">Manual Stable Release Installation</a>, Previous: <a
href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Git-Pre_002drelease-Package-Installation" accesskey="n"
rel="next">Git Pre-release Package Installation</a>, Previous: <a
href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<span
id="Stable-Package-Installation-_0028Emacs-Package-Manager_0029"></span><h4
class="subsection">B.1.1 Stable Package Installation (Emacs Package
Manager)</h4>
@@ -8240,40 +8240,11 @@ minute or two. You may see a bunch of compilation
warnings but these
can be safely ignored.
</p>
<hr>
-<span id="Manual-Stable-Release-Installation"></span><div class="header">
+<span id="Git-Pre_002drelease-Package-Installation"></span><div class="header">
<p>
-Next: <a href="#Git-Pre_002drelease-Installation" accesskey="n" rel="next">Git
Pre-release Installation</a>, Previous: <a href="#Stable-Package-Installation"
accesskey="p" rel="prev">Stable Package Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Manual-Tarball-Archive-Installation" accesskey="n"
rel="next">Manual Tarball Archive Installation</a>, Previous: <a
href="#Stable-Package-Installation" accesskey="p" rel="prev">Stable Package
Installation</a>, Up: <a href="#Installation" accesskey="u"
rel="up">Installation</a> [<a href="#SEC_Contents" title="Table of
contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index"
rel="index">Index</a>]</p>
</div>
-<span id="Manual-Stable-Release-Installation-1"></span><h4
class="subsection">B.1.2 Manual Stable Release Installation</h4>
-
-<p>If you are old-school, don’t like package managers, and prefer doing
-everything by hand, then you can obtain Hyperbole from a tarball:
-</p>
-<p>Download a stable release tar.gz source archive from either
-<a
href="ftp://ftp.gnu.org/gnu/hyperbole/";>ftp://ftp.gnu.org/gnu/hyperbole/</a> or
-<a
href="http://ftpmirror.gnu.org/hyperbole/";>http://ftpmirror.gnu.org/hyperbole/</a>,
which will find the closest
-mirror of the GNU ftp site and show it to you.
-</p>
-<p>Decompress and unpack the archive to a directory of your choosing. Move
-into the <samp>hyperbole/</samp> directory and execute the following Posix
-shell command, <code>make bin</code>, to byte-compile the Hyperbole lisp files.
-Then add the following lines to your personal Emacs initialization
-file, <samp>~/.emacs</samp>:
-</p>
-<div class="lisp">
-<pre class="lisp">(push
"<directory-ending-with-hyperbole-where-you-unpacked>"
load-path)
-(hyperbole-mode 1)
-</pre></div>
-
-<p>Restart Emacs and you should see the <code>Hypb</code> hyperbole minor mode
-indicator in your modeline after startup.
-</p>
-<hr>
-<span id="Git-Pre_002drelease-Installation"></span><div class="header">
-<p>
-Previous: <a href="#Manual-Stable-Release-Installation" accesskey="p"
rel="prev">Manual Stable Release Installation</a>, Up: <a href="#Installation"
accesskey="u" rel="up">Installation</a> [<a href="#SEC_Contents"
title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index"
title="Index" rel="index">Index</a>]</p>
-</div>
-<span
id="Git-Pre_002drelease-Installation-_0028Straight-Package-Manager_0029"></span><h4
class="subsection">B.1.3 Git Pre-release Installation (Straight Package
Manager)</h4>
+<span
id="Git-Pre_002drelease-Package-Installation-_0028Straight-Package-Manager_0029"></span><h4
class="subsection">B.1.2 Git Pre-release Package Installation (Straight
Package Manager)</h4>
<span id="index-Straight-package-manager"></span>
<span id="index-pre_002drelease-installation"></span>
@@ -8312,6 +8283,47 @@ process without showing you any byte compilation
warnings.
</pre></div>
<hr>
+<span id="Manual-Tarball-Archive-Installation"></span><div class="header">
+<p>
+Previous: <a href="#Git-Pre_002drelease-Package-Installation" accesskey="p"
rel="prev">Git Pre-release Package Installation</a>, Up: <a
href="#Installation" accesskey="u" rel="up">Installation</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Manual-Tarball-Archive-Installation-1"></span><h4
class="subsection">B.1.3 Manual Tarball Archive Installation</h4>
+
+<p>If you are old-school, don’t like package managers, and prefer doing
+everything by hand, then you can obtain Hyperbole from a tarball:
+</p>
+<p>Download either:
+</p>
+<p>1. a stable release tar.gz source archive from either:
+<a
href="ftp://ftp.gnu.org/gnu/hyperbole/";>ftp://ftp.gnu.org/gnu/hyperbole/</a> or
+<a
href="http://ftpmirror.gnu.org/hyperbole/";>http://ftpmirror.gnu.org/hyperbole/</a>,
which will find the closest
+mirror of the GNU ftp site and show it to you.
+</p>
+<p>or
+</p>
+<p>2. the latest in-development pre-release tar.gz source archive linked
+to at the top of this web page:
+<a
href="https://elpa.gnu.org/devel/hyperbole.html";>https://elpa.gnu.org/devel/hyperbole.html</a>.
+</p>
+
+<p>Then decompress and unpack the archive to a directory of your
+choosing. Move into the <samp>hyperbole/</samp> directory and execute
+the following Posix shell command, <code>make bin</code>, to
+byte-compile the Hyperbole lisp files. Then add the following
+lines to your personal Emacs initialization file,
+<samp>~/.emacs</samp>:
+</p>
+<div class="lisp">
+<pre class="lisp">(unless (and (featurep 'hyperbole) hyperbole-mode)
+ (push "<directory-ending-with-hyperbole-where-you-unpacked>"
load-path)
+ (require 'hyperbole)
+ (hyperbole-mode 1))
+</pre></div>
+
+<p>Restart Emacs and you should see the <code>Hypb</code> hyperbole minor mode
+indicator in your modeline after startup.
+</p>
+<hr>
<span id="Invocation"></span><div class="header">
<p>
Next: <a href="#Customization" accesskey="n" rel="next">Customization</a>,
Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>,
Up: <a href="#Setup" accesskey="u" rel="up">Setup</a> [<a
href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a
href="#Key-Index" title="Index" rel="index">Index</a>]</p>
@@ -13678,8 +13690,8 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-inserting-tabs">inserting
tabs</a>:</td><td> </td><td valign="top"><a
href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-insertion">insertion</a>:</td><td> </td><td valign="top"><a
href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-installation">installation</a>:</td><td> </td><td
valign="top"><a href="#Stable-Package-Installation">Stable Package
Installation</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-installation_002c-from-git">installation, from
git</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Installation">Git Pre-release
Installation</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-installation_002c-pre_002drelease">installation,
pre-release</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Installation">Git Pre-release
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-installation_002c-from-git">installation, from
git</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-installation_002c-pre_002drelease">installation,
pre-release</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-installation_002c-stable">installation,
stable</a>:</td><td> </td><td valign="top"><a
href="#Stable-Package-Installation">Stable Package Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-instance-number">instance
number</a>:</td><td> </td><td valign="top"><a href="#By-Menu">By
Menu</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-interactive-cmd-char_002c-_002bI">interactive cmd char,
+I</a>:</td><td> </td><td valign="top"><a
href="#Creating-Action-Types">Creating Action Types</a></td></tr>
@@ -14019,7 +14031,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-popup-menu_002c-Rolo">popup
menu, Rolo</a>:</td><td> </td><td valign="top"><a
href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-posting-buttons">posting
buttons</a>:</td><td> </td><td valign="top"><a
href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-posting-news">posting
news</a>:</td><td> </td><td valign="top"><a
href="#Buttons-in-News">Buttons in News</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-pre_002drelease-installation">pre-release
installation</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Installation">Git Pre-release
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-pre_002drelease-installation">pre-release
installation</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-precedence_002c-buttons">precedence,
buttons</a>:</td><td> </td><td valign="top"><a
href="#Button-Type-Precedence">Button Type Precedence</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-programming-interface">programming
interface</a>:</td><td> </td><td valign="top"><a
href="#Embedding-Hyperbole">Embedding Hyperbole</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-promotion">promotion</a>:</td><td> </td><td valign="top"><a
href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
@@ -14147,7 +14159,7 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a href="#index-starting-HyControl">starting
HyControl</a>:</td><td> </td><td valign="top"><a
href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-starting-Hyperbole">starting
Hyperbole</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-storage-manager">storage
manager</a>:</td><td> </td><td valign="top"><a
href="#Operational-and-Storage-Formats">Operational and Storage
Formats</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-Straight-package-manager">Straight package
manager</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Installation">Git Pre-release
Installation</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-Straight-package-manager">Straight package
manager</a>:</td><td> </td><td valign="top"><a
href="#Git-Pre_002drelease-Package-Installation">Git Pre-release Package
Installation</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-string">string</a>:</td><td> </td><td valign="top"><a
href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-string-1">string</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited
Things</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-submenus">submenus</a>:</td><td> </td><td valign="top"><a
href="#Menus">Menus</a></td></tr>
diff --git a/man/hyperbole.info b/man/hyperbole.info
index 480662b..b9a2760 100644
Binary files a/man/hyperbole.info and b/man/hyperbole.info differ
diff --git a/man/hyperbole.pdf b/man/hyperbole.pdf
index 24b3079..78d5ff4 100644
Binary files a/man/hyperbole.pdf and b/man/hyperbole.pdf differ
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index 3ee0407..071bea7 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -155,7 +155,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
Edition 8.0.0pre
-Printed May 13, 2021.
+Printed May 16, 2021.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -197,7 +197,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
@example
Edition 8.0.0pre
-May 13, 2021
+May 16, 2021
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -406,8 +406,8 @@ Setup
Installation
* Stable Package Installation::
-* Manual Stable Release Installation::
-* Git Pre-release Installation::
+* Git Pre-release Package Installation::
+* Manual Tarball Archive Installation::
Customization
@@ -949,7 +949,7 @@ under an external window system.
@cindex smart keys, unshifted
If you set the variable, @code{hmouse-middle-flag}, to @samp{t} before
loading Hyperbole, then you may also use the middle mouse key as the Action
-Key). If you want both the middle mouse key as the Action Key and the
+Key. If you want both the middle mouse key as the Action Key and the
right mouse key as the Assist Key for ease of use, then within your
personal @file{~/.emacs} file, add: @code{(add-hook 'hyperbole-init-hook
'hmouse-add-unshifted-smart-keys)} and then restart Emacs.
@@ -5523,7 +5523,7 @@ current frame to its state prior to the rolo search.
@cindex rolo, personal
The files used in any rolo search are given by the
@code{hyrolo-file-list} variable, whose default value is typically
-@code{("~/.rolo.otl"}. Searches scan only your personal rolo file.
+@code{"~/.rolo.otl"}. Searches scan only your personal rolo file.
Any entries added to this list should be absolute filenames. If a
file in the list does not exist or is not readable, it is skipped.
Files are searched in the order in which they appear in the list. In
@@ -6966,14 +6966,14 @@ you have GNU Emacs set up at your site.
@menu
* Stable Package Installation::
-* Manual Stable Release Installation::
-* Git Pre-release Installation::
+* Git Pre-release Package Installation::
+* Manual Tarball Archive Installation::
@end menu
@noindent
After installing Hyperbole, read the next section on Invocation.
-@node Stable Package Installation, Manual Stable Release Installation,
Installation, Installation
+@node Stable Package Installation, Git Pre-release Package Installation,
Installation, Installation
@subsection Stable Package Installation (Emacs Package Manager)
@cindex installation
@@ -7016,33 +7016,8 @@ 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.
-@node Manual Stable Release Installation, Git Pre-release Installation, Stable
Package Installation, Installation
-@subsection Manual Stable Release Installation
-
-If you are old-school, don't like package managers, and prefer doing
-everything by hand, then you can obtain Hyperbole from a tarball:
-
-Download a stable release tar.gz source archive from either
-@url{ftp://ftp.gnu.org/gnu/hyperbole/} or
-@url{http://ftpmirror.gnu.org/hyperbole/}, which will find the closest
-mirror of the GNU ftp site and show it to you.
-
-Decompress and unpack the archive to a directory of your choosing. Move
-into the @file{hyperbole/} directory and execute the following Posix
-shell command, @code{make bin}, to byte-compile the Hyperbole lisp files.
-Then add the following lines to your personal Emacs initialization
-file, @file{~/.emacs}:
-
-@lisp
-(push "<directory-ending-with-hyperbole-where-you-unpacked>" load-path)
-(hyperbole-mode 1)
-@end lisp
-
-Restart Emacs and you should see the @code{Hypb} hyperbole minor mode
-indicator in your modeline after startup.
-
-@node Git Pre-release Installation, , Manual Stable Release Installation,
Installation
-@subsection Git Pre-release Installation (Straight Package Manager)
+@node Git Pre-release Package Installation, Manual Tarball Archive
Installation, Stable Package Installation, Installation
+@subsection Git Pre-release Package Installation (Straight Package Manager)
@cindex Straight package manager
@cindex pre-release installation
@@ -7083,6 +7058,47 @@ process without showing you any byte compilation
warnings.
@end group
@end lisp
+@node Manual Tarball Archive Installation, , Git Pre-release Package
Installation, Installation
+@subsection Manual Tarball Archive Installation
+
+If you are old-school, don't like package managers, and prefer doing
+everything by hand, then you can obtain Hyperbole from a tarball:
+
+@noindent
+Download either:
+
+@noindent
+1. a stable release tar.gz source archive from either:
+@url{ftp://ftp.gnu.org/gnu/hyperbole/} or
+@url{http://ftpmirror.gnu.org/hyperbole/}, which will find the closest
+mirror of the GNU ftp site and show it to you.
+
+@noindent
+or
+
+@noindent
+2. the latest in-development pre-release tar.gz source archive linked
+to at the top of this web page:
+@url{https://elpa.gnu.org/devel/hyperbole.html}.
+
+
+Then decompress and unpack the archive to a directory of your
+choosing. Move into the @file{hyperbole/} directory and execute
+the following Posix shell command, @code{make bin}, to
+byte-compile the Hyperbole lisp files. Then add the following
+lines to your personal Emacs initialization file,
+@file{~/.emacs}:
+
+@lisp
+(unless (and (featurep 'hyperbole) hyperbole-mode)
+ (push "<directory-ending-with-hyperbole-where-you-unpacked>" load-path)
+ (require 'hyperbole)
+ (hyperbole-mode 1))
+@end lisp
+
+Restart Emacs and you should see the @code{Hypb} hyperbole minor mode
+indicator in your modeline after startup.
+
@node Invocation, Customization, Installation, Setup
@section Invocation