branch: externals/hyperbole
commit 824215f5a60728c380e556710a0c771907a193e2
Author: Bob Weiner <r...@gnu.org>
Commit: Bob Weiner <r...@gnu.org>
Fix formatting issues in man/hyperbole.texi
---
man/hyperbole.html | 68 ++++++++++++++++++++++++++------------------------
man/hyperbole.info | Bin 577666 -> 577711 bytes
man/hyperbole.pdf | Bin 1330890 -> 1331183 bytes
man/hyperbole.texi | 71 +++++++++++++++++++++++++----------------------------
4 files changed, 70 insertions(+), 69 deletions(-)
diff --git a/man/hyperbole.html b/man/hyperbole.html
index 3747c3840a..3d47867895 100644
--- a/man/hyperbole.html
+++ b/man/hyperbole.html
@@ -370,7 +370,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
<PRE>
Edition 8.0.0pre
-Printed January 29, 2022.
+Printed January 30, 2022.
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -6280,7 +6280,7 @@ view specification of: blank lines turned off, cutoff
after one line
per cell, and showing ellipses for cells or trees which are collapsed.
</p>
<span id="index-klink_002c-view-spec"></span>
-<span id="index-view-spec-klink"></span>
+<span id="index-view-spec_002c-klink"></span>
</dd>
<dt><em>view spec</em></dt>
<dd><p>The third format sets a view spec for the current koutline. For
@@ -8607,11 +8607,12 @@ and move on to the next section, see <a
href="#Invocation">Invocation</a>.
several lines to your personal Emacs initialization file,
<samp>~/.emacs</samp>.
(For further details, see <a
href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Init-File";>The
Emacs Initialization File</a> in <cite>the GNU Emacs Manual</cite>).
</p>
-<p>Below are the lines to add:
-</p>
<div class="lisp">
-<pre class="lisp">(when (< emacs-major-version 27)
- (error "Hyperbole requires Emacs 27 or above; you are running version
%d" emacs-major-version))
+<pre class="lisp">;; Below are the lines to add:
+
+(when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above, not %d"
+ emacs-major-version))
(require 'package)
(unless (package-installed-p 'hyperbole)
(package-refresh-contents)
@@ -8656,13 +8657,15 @@ and move on to the next section, see <a
href="#Invocation">Invocation</a>.
several lines to your personal Emacs initialization file,
<samp>~/.emacs</samp>.
(For further details, see <a
href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Init-File";>The
Emacs Initialization File</a> in <cite>the GNU Emacs Manual</cite>).
</p>
-<p>Below are the lines to add:
-</p>
<div class="lisp">
-<pre class="lisp">(when (< emacs-major-version 27)
- (error "Hyperbole requires Emacs 27 or above; you are running version
%d" emacs-major-version))
+<pre class="lisp">;; Below are the lines to add:
+
+(when (< emacs-major-version 27)
+ (error "Hyperbole requires Emacs 27 or above, not %d"
+ emacs-major-version))
(require 'package)
-(add-to-list 'package-archives '("gnu-devel" .
"https://elpa.gnu.org/devel/"))
+(add-to-list 'package-archives
+ '("gnu-devel" .
"https://elpa.gnu.org/devel/"))
(unless (package-installed-p 'hyperbole)
(package-refresh-contents)
(package-install 'hyperbole))
@@ -8702,17 +8705,17 @@ and move on to the next section, see <a
href="#Invocation">Invocation</a>.
several lines to your personal Emacs initialization file,
<samp>~/.emacs</samp>.
(For further details, see <a
href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Init-File";>The
Emacs Initialization File</a> in <cite>the GNU Emacs Manual</cite>).
</p>
-<p>Below are the lines to add:
-</p>
<div class="lisp">
<pre class="lisp">;; Use this in your Emacs init file to install Straight
(progn
(when (< emacs-major-version 27)
- (error "Hyperbole requires Emacs 27 or above; you are running version
%d" emacs-major-version))
+ (error "Hyperbole requires Emacs 27 or above, not %d"
+ emacs-major-version))
(defvar bootstrap-version)
(setq package-enable-at-startup nil)
(let ((bootstrap-file
- (expand-file-name "straight/repos/straight.el/bootstrap.el"
user-emacs-directory))
+ (expand-file-name "straight/repos/straight.el/bootstrap.el"
+ user-emacs-directory))
(bootstrap-version 5))
(unless (file-exists-p bootstrap-file)
(with-current-buffer
@@ -8722,9 +8725,8 @@ several lines to your personal Emacs initialization file,
<samp>~/.emacs</samp>.
(goto-char (point-max))
(eval-print-last-sexp)))
(load bootstrap-file nil 'nomessage)))
-</pre><pre class="lisp">
-</pre><pre class="lisp">;; Then use this to install Hyperbole
+;; Then use this to install Hyperbole
(straight-use-package
'(hyperbole
:host nil
@@ -8747,17 +8749,17 @@ 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
+<dl compact="compact">
+<dt>1. a stable release tar.gz source archive from either:</dt>
+<dd><p><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>
+</dd>
+<dt>2. the latest in-development pre-release tar.gz source archive linked to
at the top of this web page:</dt>
+<dd><p><a
href="https://elpa.gnu.org/devel/hyperbole.html";>https://elpa.gnu.org/devel/hyperbole.html</a>.
+</p></dd>
+</dl>
<p>Then decompress and unpack the archive to a directory of your
choosing. Move into the <samp>hyperbole-<version>/</samp> directory and
execute
@@ -8769,8 +8771,10 @@ lines to your personal Emacs initialization file,
<div class="lisp">
<pre class="lisp">(unless (and (featurep 'hyperbole) hyperbole-mode)
(when (< emacs-major-version 27)
- (error "Hyperbole requires Emacs 27 or above; you are running version
%d" emacs-major-version))
- (push "<directory-ending-with-hyperbole-where-you-unpacked>"
load-path)
+ (error "Hyperbole requires Emacs 27 or above, not %d"
+ emacs-major-version))
+ (push "<directory-ending-with-hyperbole-where-you-unpacked>"
+ load-path)
(require 'hyperbole)
(hyperbole-mode 1))
</pre></div>
@@ -8872,7 +8876,7 @@ All of these variables are defined within
<samp>hpath.el</samp>.
</p>
<div class="example">
<pre class="example">Referent Category Variable Setting
-========================================================================
+======================================================================
Internal Image Display hpath:native-image-suffixes
Internal Custom Display hpath:internal-display-alist
External Display hpath:external-display-alist
@@ -8918,13 +8922,13 @@ display.
</p>
<p>By default, this setting handles the following types of files:
</p><dl compact="compact">
-<dt><em>Audio Files</em></dt>
+<dt><em>• Audio Files</em></dt>
<dd><p>Major audio format files are played with the
<code>play-sound-file</code> command.
</p></dd>
-<dt><em>Info Manuals</em></dt>
+<dt><em>• Info Manuals</em></dt>
<dd><p>Files with a <samp>.info</samp> suffix (may also be compressed) are
displayed in the Info browser.
</p></dd>
-<dt><em>RDB Files</em></dt>
+<dt><em>• RDB Files</em></dt>
<dd><p>Files with an <samp>.rdb</samp> suffix are displayed as relational
databases using the RDB package
available with InfoDock.
</p></dd>
@@ -14828,13 +14832,13 @@ Previous: <a href="#Function" accesskey="p"
rel="prev">Function</a>, Up: <a href
<tr><td></td><td valign="top"><a
href="#index-view">view</a>:</td><td> </td><td valign="top"><a
href="#Viewing">Viewing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-mode">view
mode</a>:</td><td> </td><td valign="top"><a
href="#Smart-Key-_002d-View-Mode">Smart Key - View Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec">view
spec</a>:</td><td> </td><td valign="top"><a href="#View-Specs">View
Specs</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-view-spec-klink">view spec
klink</a>:</td><td> </td><td valign="top"><a
href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-view-spec_002c-all-lines-and-levels">view spec, all lines and
levels</a>:</td><td> </td><td valign="top"><a href="#View-Specs">View
Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-blank-lines">view
spec, blank lines</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-changing">view
spec, changing</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-characters">view
spec, characters</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-ellipses">view
spec, ellipses</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-example">view
spec, example</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-view-spec_002c-klink">view spec,
klink</a>:</td><td> </td><td valign="top"><a
href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-label-type">view
spec, label type</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-view-spec_002c-lines-per-cell">view spec, lines per
cell</a>:</td><td> </td><td valign="top"><a href="#View-Specs">View
Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-setting">view
spec, setting</a>:</td><td> </td><td valign="top"><a
href="#View-Specs">View Specs</a></td></tr>
diff --git a/man/hyperbole.info b/man/hyperbole.info
index cf4a20d368..48a1afeafa 100644
Binary files a/man/hyperbole.info and b/man/hyperbole.info differ
diff --git a/man/hyperbole.pdf b/man/hyperbole.pdf
index a19ed2f7a1..cd90fb4dd4 100644
Binary files a/man/hyperbole.pdf and b/man/hyperbole.pdf differ
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index 005b8f4a72..4457698e6f 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: 30-Jan-22 at 12:16:37 by Bob Weiner
+@c Last-Mod: 30-Jan-22 at 12:57:08 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.0pre
-Printed January 29, 2022.
+Printed January 30, 2022.
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.0pre
-January 29, 2022
+January 30, 2022
Published by the Free Software Foundation, Inc.
Author: Bob Weiner
@@ -5293,7 +5293,7 @@ view specification of: blank lines turned off, cutoff
after one line
per cell, and showing ellipses for cells or trees which are collapsed.
@cindex klink, view spec
-@cindex view spec klink
+@cindex view spec, klink
@item view spec
The third format sets a view spec for the current koutline. For
example, @samp{<|ben>}, when activated, sets the view in the current
@@ -7338,13 +7338,13 @@ several lines to your personal Emacs initialization
file, @file{~/.emacs}.
(For further details, @pxref{Init File,,The Emacs Initialization File,emacs,
the GNU Emacs Manual}).
-@noindent
-Below are the lines to add:
-
@lisp
@group
+;; Below are the lines to add:
+
(when (< emacs-major-version 27)
- (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
+ (error "Hyperbole requires Emacs 27 or above, not %d"
+ emacs-major-version))
(require 'package)
(unless (package-installed-p 'hyperbole)
(package-refresh-contents)
@@ -7387,15 +7387,16 @@ several lines to your personal Emacs initialization
file, @file{~/.emacs}.
(For further details, @pxref{Init File,,The Emacs Initialization File,emacs,
the GNU Emacs Manual}).
-@noindent
-Below are the lines to add:
-
@lisp
@group
+;; Below are the lines to add:
+
(when (< emacs-major-version 27)
- (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
+ (error "Hyperbole requires Emacs 27 or above, not %d"
+ emacs-major-version))
(require 'package)
-(add-to-list 'package-archives '("gnu-devel" . "https://elpa.gnu.org/devel/";))
+(add-to-list 'package-archives
+ '("gnu-devel" . "https://elpa.gnu.org/devel/";))
(unless (package-installed-p 'hyperbole)
(package-refresh-contents)
(package-install 'hyperbole))
@@ -7433,19 +7434,18 @@ several lines to your personal Emacs initialization
file, @file{~/.emacs}.
(For further details, @pxref{Init File,,The Emacs Initialization File,emacs,
the GNU Emacs Manual}).
-@noindent
-Below are the lines to add:
-
-@lisp
+@smalllisp
@group
;; Use this in your Emacs init file to install Straight
(progn
(when (< emacs-major-version 27)
- (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
+ (error "Hyperbole requires Emacs 27 or above, not %d"
+ emacs-major-version))
(defvar bootstrap-version)
(setq package-enable-at-startup nil)
(let ((bootstrap-file
- (expand-file-name "straight/repos/straight.el/bootstrap.el"
user-emacs-directory))
+ (expand-file-name "straight/repos/straight.el/bootstrap.el"
+ user-emacs-directory))
(bootstrap-version 5))
(unless (file-exists-p bootstrap-file)
(with-current-buffer
@@ -7455,9 +7455,7 @@ Below are the lines to add:
(goto-char (point-max))
(eval-print-last-sexp)))
(load bootstrap-file nil 'nomessage)))
-@end group
-@group
;; Then use this to install Hyperbole
(straight-use-package
'(hyperbole
@@ -7465,7 +7463,7 @@ Below are the lines to add:
:repo "https://git.savannah.gnu.org/git/hyperbole.git";
:config (hyperbole-mode 1)))
@end group
-@end lisp
+@end smalllisp
Now save the file and restart Emacs. Hyperbole will then be downloaded
and compiled for use with your version of Emacs; give it a minute or two.
@@ -7479,20 +7477,15 @@ 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:
+@table @asis
+@item 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:
+@item 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}.
-
+@end table
Then decompress and unpack the archive to a directory of your
choosing. Move into the @file{hyperbole-<version>/} directory and execute
@@ -7505,8 +7498,10 @@ lines to your personal Emacs initialization file,
@group
(unless (and (featurep 'hyperbole) hyperbole-mode)
(when (< emacs-major-version 27)
- (error "Hyperbole requires Emacs 27 or above; you are running version %d"
emacs-major-version))
- (push "<directory-ending-with-hyperbole-where-you-unpacked>" load-path)
+ (error "Hyperbole requires Emacs 27 or above, not %d"
+ emacs-major-version))
+ (push "<directory-ending-with-hyperbole-where-you-unpacked>"
+ load-path)
(require 'hyperbole)
(hyperbole-mode 1))
@end group
@@ -7596,7 +7591,7 @@ All of these variables are defined within @file{hpath.el}.
@example
Referent Category Variable Setting
-========================================================================
+======================================================================
Internal Image Display hpath:native-image-suffixes
Internal Custom Display hpath:internal-display-alist
External Display hpath:external-display-alist
@@ -7637,13 +7632,14 @@ The first regular expression that matches each filename
is the one
used. This can be used to format raw data files for convenient
display.
+@noindent
By default, this setting handles the following types of files:
@table @emph
-@item Audio Files
+@item @bullet{} Audio Files
Major audio format files are played with the @code{play-sound-file} command.
-@item Info Manuals
+@item @bullet{} Info Manuals
Files with a @file{.info} suffix (may also be compressed) are displayed in the
Info browser.
-@item RDB Files
+@item @bullet{} RDB Files
Files with an @file{.rdb} suffix are displayed as relational databases using
the RDB package
available with InfoDock.
@end table
@@ -9126,6 +9122,7 @@ When company-mode is active:
@end group
@end format
+@page
@node Smart Key - Org Mode, Smart Key - Ivy, Smart Key - Company Mode, Smart
Keyboard Keys
@subsection Smart Key - Org Mode
