diff --git a/install-test/install-test.sh b/install-test/install-test.sh index e2448cfd..93d1413b 100755 --- a/install-test/install-test.sh +++ b/install-test/install-test.sh @@ -40,4 +40,7 @@ else fi # Debug - after install -[[ -n "$debug" ]] && bash +if [[ -n "$debug" ]] +then + bash +fi diff --git a/man/hy-package.el b/man/hy-package.el deleted file mode 100644 index 0e51d47a..00000000 --- a/man/hy-package.el +++ /dev/null @@ -1,100 +0,0 @@ -;;; hy-package.el --- Hyperbole package.el installation and configuration instructions -*- lexical-binding: t; -*- -;; -;; Author: Bob Weiner -;; -;; Orig-Date: 15-Jul-26 at 12:28:58 -;; Last-Mod: 25-Jul-26 at 22:25:11 by Mats Lidell -;; -;; SPDX-License-Identifier: GPL-3.0-or-later -;; -;; Copyright (C) 2026 Free Software Foundation, Inc. -;; See the "../HY-COPY" file for license information. -;; -;; This file is part of GNU Hyperbole. - -;;; ************************************************************************ -;;; Requirements -;;; ************************************************************************ - -(require 'package) - -;;; ************************************************************************ -;;; Section 1: package.el setup -;;; ************************************************************************ - -;;; ======================================================================== -;;; NOTE: This section is only if you have not yet setup the package.el -;;; package manager. If you have, ignore this and skip to "#Section 2" -;;; for the Hyperbole `use-package' recipe. -;;; ======================================================================== - -;; Step 1: Add the function definition below near the top of your -;; "~/.emacs" or "~/.emacs.d/early-init.el" file. - -;; Step 2: Add a call to the function below its definition: -;; (setup-package) - -(defun setup-package () - (require 'package) - (setq package-enable-at-startup nil) ;; Prevent double loading of libraries - (add-to-list 'package-archives - ;; Leave only one of the following two lines uncommented - '("elpa-devel" . "https://elpa.gnu.org/devel/")) - ;; '("elpa" . "https://elpa.gnu.org/packages/")) - (unless (and (boundp 'package--initialized) package--initialized) - (package-initialize)) - ;; To ensure you have the latest index of packages, you'll have to - ;; uncomment the next line. It is commented because retrieving the - ;; list is slow. - ;; (package-refresh-contents) - ) - -;;; ************************************************************************ -;;; Section 2: package.el Hyperbole installation and configuration -;;; ************************************************************************ - -;; Step 1: Add the following expression to your "~/.emacs" or -;; "~/.emacs.d/init.el" file. - -(use-package hyperbole - - ;; ensure Hyperbole is installed - :ensure t - - ;; Initialize the global HyWiki minor mode to one of these values: - ;; :all - highlights and makes HyWikiWord links active in - ;; all text and programming buffer comments - ;; :pages - highlights and makes HyWikiWord links active in - ;; only within HyWiki page buffers - ;; nil - leaves HyWiki mode disabled. - :config - (progn - ;; Older Hyperbole releases do not have HyWiki - (when (fboundp 'hywiki-mode) - (hywiki-mode :all)) - - ;; Initialize the global Hyperbole minor mode to one of these values: - ;; 1 - enabled on startup so the Action and Assist Smart Keys are active - ;; 0 - off until you toggle it on - ;; If you left hywiki-mode enabled above, that enables hyperbole-mode too. - (unless (and (fboundp 'hywiki-mode) hywiki-mode) - (hyperbole-mode 1))) - - :bind - (("M-RET" . hkey-either) - ;; Uncomment the next binding if you want to emulate Hyperbole mouse drag - ;; events from your keyboard. - ;; See "https://www.gnu.org/s/hyperbole/man/hyperbole.html#Keyboard-Drags". - ;; ("M-o" . hkey-operate) - ) - - ;; Customize how Hyperbole and Org mode share the M-RET key: - ;; t - With hyperbole-mode enabled, Hyperbole controls the key - ;; 'buttons - With hyperbole-mode enabled, Hyperbole controls the key - ;; only when on a button or link; otherwise, Org controls it - ;; nil - In Org mode, Org controls the key - :custom - (hsys-org-enable-smart-keys t) - ) - -;;; End diff --git a/man/hy-straight.el b/man/hy-straight.el deleted file mode 100644 index 69aee1cb..00000000 --- a/man/hy-straight.el +++ /dev/null @@ -1,78 +0,0 @@ -;;; hy-straight.el --- Hyperbole Straight installation and configuration instructions -*- lexical-binding: t; -*- -;; -;; Author: Bob Weiner -;; -;; Orig-Date: 15-Jul-26 at 12:28:58 -;; Last-Mod: 25-Jul-26 at 22:25:45 by Mats Lidell -;; -;; SPDX-License-Identifier: GPL-3.0-or-later -;; -;; Copyright (C) 2026 Free Software Foundation, Inc. -;; See the "../HY-COPY" file for license information. -;; -;; This file is part of GNU Hyperbole. - -;;; ************************************************************************ -;;; Section 1: Straight setup -;;; ************************************************************************ - -;;; ======================================================================== -;;; NOTE: This section is only if you have not yet setup the Straight -;;; package manager. If you have, ignore this and skip to "#Section 2" -;;; for the Hyperbole `straight-use-package' recipe. -;;; ======================================================================== - -;; Step 1: Add the function definition below near the top of your -;; "~/.emacs" or "~/.emacs.d/early-init.el" file. - -;; Step 2: Add a call to the function below its definition: -;; (setup-straight) - -(defun setup-straight () - (when (< emacs-major-version 28) - (error "Hyperbole requires Emacs 28 or above, not %d" - emacs-major-version)) - (defvar bootstrap-version) - - ;; Prevent double loading of libraries - (setq package-enable-at-startup nil) - - (let ((bootstrap-file - (expand-file-name "straight/repos/straight.el/bootstrap.el" - user-emacs-directory)) - (bootstrap-version 5)) - (unless (file-exists-p bootstrap-file) - (with-current-buffer - (url-retrieve-synchronously - "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el" - 'silent 'inhibit-cookies) - (goto-char (point-max)) - (eval-print-last-sexp))) - (load bootstrap-file nil 'nomessage))) - -;;; ************************************************************************ -;;; Section 2: Straight Hyperbole installation and configuration -;;; ************************************************************************ - -;; Step 1: Add the following expression to your "~/.emacs" or -;; "~/.emacs.d/init.el" file. - -(straight-use-package - '(hyperbole - :host nil - - :repo "https://git.savannah.gnu.org/git/hyperbole.git" - - :config - (progn - (hywiki-mode :all) - (unless hywiki-mode - (hyperbole-mode 1))) - - :bind - (("M-RET" . hkey-either)) - - :custom - (hsys-org-enable-smart-keys t))) - -;;; End diff --git a/man/hyperbole.html b/man/hyperbole.html index ccdeeee0..15dadf5e 100644 --- a/man/hyperbole.html +++ b/man/hyperbole.html @@ -1,10 +1,10 @@ - + - + @@ -361,10 +358,8 @@
- +

GNU Hyperbole

@@ -386,7 +381,7 @@

GNU Hyperbole Edition 9.1.0 -Printed July 27, 2026. +Printed September 16, 2026. Published by the Free Software Foundation, Inc. Author: Bob Weiner @@ -438,297 +433,295 @@

GNU Hyperbole -
+ -
+

Table of Contents


- +

1 Introduction

This edition of the GNU Hyperbole Manual is for use with any version @@ -775,17 +768,15 @@

1 Introduction -
  • Manual Overview
  • -
  • Motivation
  • -
  • Hyperbole Overview
  • -
  • Mail Lists
  • +
  • Manual Overview
  • +
  • Motivation
  • +
  • Hyperbole Overview
  • +
  • Mail Lists

  • - +

    1.1 Manual Overview

    Hyperbole is an efficient, programmable hypertextual information management @@ -882,10 +873,8 @@

    1.1 Manual Overview - +

    1.2 Motivation

    Database vendors apply tremendous resources to help solve corporate @@ -923,10 +912,8 @@

    1.2 Motivation - +

    1.3 Hyperbole Overview

    @@ -1168,10 +1155,8 @@

    1.3 Hyperbole Overview

    - +

    1.4 Mail Lists

    If you use Hyperbole, you may join the mailing list @@ -1184,10 +1169,8 @@

    1.4 Mail Lists - +

    2 Usage

    Once Hyperbole has been installed for use at your site, loaded into your @@ -1197,16 +1180,14 @@

    2 Usage -
  • Invocation
  • -
  • Documentation
  • -
  • Hyperbole Hooks
  • +
  • Invocation
  • +
  • Documentation
  • +
  • Hyperbole Hooks

  • - +

    2.1 Invocation

    You can invoke Hyperbole’s commands in one of three ways: @@ -1230,16 +1211,22 @@

    2.1 Invocation + + + -

    {C-h h} enables Hyperbole if it has been disabled and displays a -Hyperbole menu in the minibuffer for quick keyboard or mouse-based -selection. Select an item from this menu by typing the item’s first -capital letter. Use {Q} (note this is capitalized) to quit from -the minibuffer menu while leaving Hyperbole enabled. Use {X} -(note this is capitalized) to quit from the minibuffer menu and -disable Hyperbole’s minor mode. + +

    {C-h h} enables Hyperbole if it has been disabled and displays +the top-level Hyperbole menu in the minibuffer for quick keyboard or +mouse-based selection. Within any Hyperbole minibuffer menu, select +an item by typing the item’s first capital letter. Use {Q} (note +this is capitalized) to quit from the minibuffer menu while leaving +Hyperbole enabled. Use {X} (note this is capitalized) to quit +from the minibuffer menu and disable Hyperbole’s minor mode. Use +{?} to get help on all of the items in the current menu. A +second {?} will hide this help.

    Use {C-h h d d} for an interactive demonstration of standard Hyperbole button capabilities. @@ -1262,10 +1249,8 @@

    2.1 Invocation - +

    2.2 Documentation

    @@ -1302,10 +1287,8 @@

    2.2 Documentation - +

    2.3 Hyperbole Hooks

    @@ -1332,10 +1315,8 @@

    2.3 Hyperbole Hooks - +

    3 Smart Keys

    @@ -1355,20 +1336,18 @@

    3 Smart Keys
    - +

    3.1 Smart Key Bindings

    @@ -1437,10 +1416,8 @@

    3.1 Smart Key Bindings

    - +

    3.2 Smart Key Operations

    @@ -1651,10 +1628,8 @@

    3.2 Smart Key Operations

    - +

    3.3 Smart Key Argument Selection

    @@ -1717,10 +1692,8 @@

    3.3 Smart Key Argu

    - +

    3.4 Smart Key Debugging

    Typically, {C-h A} and {C-u C-h A} which show Action and @@ -1757,10 +1730,8 @@

    3.4 Smart Key Debugging

    - +

    3.5 Smart Key Thing Selection

    @@ -1852,10 +1823,8 @@

    3.5 Smart Key Thing S

    - +

    3.6 Smart Mouse Key Modeline Clicks

    Smart Mouse Key clicks on a window’s modeline offer many powerful browsing @@ -1994,10 +1963,8 @@

    3.6 Smart Mouse

    - +

    3.7 Smart Mouse Key Drags

    @@ -2010,18 +1977,16 @@

    3.7 Smart Mouse Key Drags


    - +

    3.7.1 Creating and Deleting Windows

    @@ -2048,10 +2013,8 @@

    3.7.1 Creating

    - +

    3.7.2 Saving and Restoring Window Configurations

    @@ -2075,10 +2038,8 @@

    3

    - +

    3.7.3 Resizing Windows

    @@ -2094,10 +2055,8 @@

    3.7.3 Resizing Windows

    - +

    3.7.4 Moving Frames

    @@ -2125,10 +2084,8 @@

    3.7.4 Moving Frames - +

    3.7.5 Dragging Buffers, Windows and Items

    Smart Mouse Key drags let you display buffers and windows however you want @@ -2138,18 +2095,16 @@

    3.7.5


    - +

    3.7.5.1 Swapping Buffers

    @@ -2171,10 +2126,8 @@

    3.7.5.1 Swapping Buffers

    - +

    3.7.5.2 Displaying Buffers

    @@ -2193,10 +2146,8 @@

    3.7.5.2 Displaying Buf

    - +

    3.7.5.3 Cloning Windows

    @@ -2212,10 +2163,8 @@

    3.7.5.3 Cloning Windows

    - +

    3.7.5.4 Displaying Items

    @@ -2248,10 +2197,8 @@

    3.7.5.4 Displaying Items

    - +

    3.7.5.5 Keyboard Drags

    @@ -2450,10 +2397,8 @@

    3.7.5.5 Keyboard Drags

    - +

    4 Buttons

    @@ -2524,20 +2469,18 @@

    4 Buttons
    - +

    4.1 Explicit Buttons

    @@ -2609,10 +2552,8 @@

    4.1 Explicit Buttons - +

    4.2 Global Buttons

    @@ -2688,10 +2629,8 @@

    4.2 Global Buttons - +

    4.3 Implicit Buttons

    @@ -2812,15 +2751,13 @@

    4.3 Implicit Buttons -
  • Implicit Button Types
  • -
  • Action Buttons
  • +
  • Implicit Button Types
  • +
  • Action Buttons

  • - +

    4.3.1 Implicit Button Types

    @@ -3638,10 +3575,8 @@

    4.3.1 Implicit Button

    - +

    4.3.2 Action Buttons

    @@ -3735,10 +3670,8 @@

    4.3.2 Action Buttons

    - +

    4.4 Button Files

    @@ -3787,10 +3720,8 @@

    4.4 Button Files - +

    4.5 Action Types

    @@ -4241,10 +4172,8 @@

    4.5 Action Types - +

    4.6 Button Type Precedence

    @@ -4279,10 +4208,8 @@

    4.6 Button Type Preceden

    - +

    4.7 Utilizing Explicit Buttons

    Explicit buttons are a fundamental building block for creating personal @@ -4292,20 +4219,18 @@

    4.7 Utilizing Explic


    - +

    4.7.1 Creation

    Creating explicit buttons is fun and easy. You can always try them out @@ -4326,16 +4251,14 @@

    4.7.1 Creation -
  • Creation Via Menus
  • -
  • Creation Via Buffer Link
  • -
  • Creation Via Assist Key Drags
  • +
  • Creation Via Menus
  • +
  • Creation Via Buffer Link
  • +
  • Creation Via Assist Key Drags

  • - +

    4.7.1.1 Creation Via Menus

    @@ -4373,10 +4296,8 @@

    4.7.1.1 Creation Via Men

    - +

    4.7.1.3 Creation Via Assist Key Drags

    @@ -4483,10 +4402,8 @@

    4.7.1.3 Creat

    - +

    4.7.2 Renaming

    @@ -4518,10 +4435,8 @@

    4.7.2 Renaming - +

    4.7.3 Deletion

    @@ -4541,10 +4456,8 @@

    4.7.3 Deletion - +

    4.7.4 Editing

    @@ -4563,10 +4476,8 @@

    4.7.4 Editing - +

    4.7.5 Searching and Summarizing

    @@ -4601,10 +4512,8 @@

    4.7.5 Searching an

    - +

    4.7.6 Buttons in Mail

    @@ -4708,10 +4617,8 @@

    4.7.6 Buttons in Mail

    - +

    4.7.7 Buttons in News

    @@ -4759,10 +4666,8 @@

    4.7.7 Buttons in News