Releases: rswgnu/hyperbole
hyperbole-9.0.1
What's New in V9.0.1
** ACE WINDOW PACKAGE INTEGRATION - fast window and buffer switching
*** After installing the ace-window package and loading Hyperbole, execute
(hkey-ace-window-setup "\M-o") to enable the following capabilities:
*** Fast Window Links: The hkey-window-link command quickly creates links
to other windows:
{M-o w <window>} - creates an explicit button linked to point in <window>
{C-u M-o w <window>} - creates an unnamed implicit button linked to point
in <window>
{M-1 M-o w <window>} - creates a named implicit button linked to point
in <window>
See "(hyperbole)Create Link Button".
** ACTION AND ASSIST (SMART) KEYS (See "(hyperbole)Smart Keys").
*** Angle Bracket and Braces Thing Selection: In text and fundamental modes,
an Action Key press on an angle bracket or a curly brace selects the
region between a matching pair. See "(hyperbole)Smart Key Thing
Selection".
*** Drag Button Referents to Specific Windows: Just as you previously could
drag Dired or Buffer Menu items to display in a specific window, you
can now do the same with Hyperbole Buttons. Action or Assist Key drag
from a Hyperbole button and release in another window where you want
the button's referent (or the result of its action) displayed. If you
release the Smart Key outside of an Emacs window, the referent is
displayed in a new frame. See "(hyperbole)Displaying Items".
Visual pulsing of the source line and the destination buffer highlights
the transfer taking place (hmouse-pulse-flag controls this).
Dragging a button to a modeline splits the window of the modeline and
displays the referent in the leftmost or uppermost of the split windows.
*** Drag to Create Implicit Link Buttons: An Assist Mouse Key drag across
windows (when not starting from a draggable item) creates an implicit
link button with an action type determined by the referent at the point
of button release. This parallels the same Action Mouse Key drag which
creates explicit link buttons. See "(hyperbole)creating implicit
links".
Previously this drag would swap buffers in windows. Now you must drag
from open space in a modeline of the depress window to the buffer text
in the release window to swap buffers in windows.
Alternatively, with two windows in a frame, you can create an implicit
link button from point to the point of the other buffer with {C-h h i l}.
*** Hyperbole Symbol Tags: Hyperbole now includes a pre-built TAGS file so
that an Action Key press on any Hyperbole symbol jumps to its
definition without the need for any additional support. This also
works on Hyperbole type names (which have a hidden prefix) in a help
buffer where an Action Key press displays the type definition.
*** Lisp Load, Autoload and Require Expressions: Action Key press on any
named target in such expressions displays the associated library.
*** Lisp Action Button Help: Action Buttons that utilize regular Lisp
functions (rather than Hyperbole Action Types) can now have :help
functions run with a press of the Assist Key on such buttons. See
"(hyperbole)Action Buttons".
*** Smart Dired: Action Key subdirectory selection at point now works on
any dired header line, not just the first one. Use {i} to insert
multiple subdirectories in Dired mode. Smart Key end-of-line behavior
is no longer specified in Dired mode but handled globally for
consistency across modes. See "(hyperbole)Smart Key - Dired Mode".
** ACTION TYPES (See "(hyperbole)Action Types").
*** display-boolean, display-value, display-variable: Made all of these
interactive, so can be used as button actypes. See "(hyperbole)
actypes display-boolean".
*** Long Action Buttons: The length limit on action buttons has been removed
to allow for long, multi-line sexpressions.
** DOCUMENTATION
*** Hyperbole Concepts: New writeup in Koutline format for those who
want a quick read about how Hyperbole concepts all interrelate.
View it with {C-h h d c}.
*** Action Types: Add newer types and updated existing doc summaries
in the Hyperbole manual. See "(hyperbole)Action Types".
*** Doc Viewing: Updated to display many files from the Doc> menu in Org
mode, so can cycle through expanding and collapsing entries with TAB
when point is at the beginning of the buffer, allowing you to view
just the sections of interest. View minor mode is also enabled so
you can scroll forward and backward with SPC and DEL.
This includes DEMO, FAST-DEMO, HY-ABOUT, HY-NEWS and the Hyperbole
Files MANIFEST.
*** Emacs 2023 Talk Videos:
- Hyperbole Amps Up Emacs: Org slide file is included in
"HY-TALK/HYPERAMP.org" with the video at
"https://emacsconf.org/2023/talks/hyperamp/".
- Koutline for Stream of Thought Journaling: The video is at
"https://emacsconf.org/2023/talks/koutline/".
- What I learned by writing test cases for GNU Hyperbole: The video
is at "https://emacsconf.org/2023/talks/test/".
*** Emacs 2022 Talk Videos:
- Hyperbole and Org Mode: Org slide file is included in
"HY-TALK/HYPERORG.org" with the video at
"https://emacsconf.org/2022/talks/hyperorg/".
- Linking Personal Info with Implicit Buttons: The video is at
"https://emacsconf.org/2022/talks/buttons/".
- Build a Zettelkasten with HyRolo: The video is at
"https://emacsconf.org/2022/talks/rolodex/".
*** FAST-DEMO: Add ERT multiple test run
example.
*** New Menu Key Doc: Documented these Hyperbole minibuffer menu keys:
- {Q} always quits from the menu without selecting anything
- {X} both quits from the menu and disables Hyperbole minor
mode; {C-h h} re-enables it. See "(hyperbole)menu,
entry/exit commands".
*** Updated 150-page Reference Manual: Includes multiple indexes for easy
cross-referencing, Info viewer version and PDF for printing. View it:
- with the Emacs Info reader: {C-h h d i}.
- locally with a web browser: <browse-url "man/hyperbole.html">
- in pdf form: "man/hyperbole.pdf".
Some of the updates include:
**** HyRolo Searching: Update this section with doc on auto-expansion and
how to hide entries again.
**** Ibut Menu: Document in the manual, notably the new Ibut/Create menu
item. See "(hyperbole)menu, Ibut/Create". For the Ibut/Link menu
item, see "(hyperbole)menu, Ibut/Link".
**** Implicit Button Types: Add doc for 'hib-python-traceback'
and 'hyrolo-stuck-msg'. See "(hyperbole)Implicit Button Types".
**** Link Menu Items: With two windows on screen, link from source window
point to referent window point. Do a similar thing when more windows
are on screen via an Action Mouse Key drag between windows. See
"(hyperbole)Smart Mouse Drags between Windows".
**** Manual Glossary: Added Ace Window, Consult, Org Mode, and Org Roam
entries. See "(hyperbole)Glossary".
**** Smart Key - Org Mode: Expanded with doc for more extensive behavior.
See "(hyperbole)Smart Key - Org Mode".
*** README.md: Unify this as the only readme file and remove "README".
** EXPLICIT BUTTONS (See "(hyperbole)Explicit Buttons").
*** Ebut/Link Menu Item {C-h h e l}: Inserts a named ebutton that links to
point in another window. See "(hyperbole)menu item, Ebut/Link".
** GLOBAL BUTTONS (See "(hyperbole)Global Buttons").
*** Gbut/Link Menu Item: A single name creates a new global link button
to point. See "(hyperbole)menu item, Gbut/Link".
*** Auto Save: Automatically save the global button file after any edit.
** HYCONTROL (See "(hyperbole)HyControl").
*** I/J/K/M Key Bindings: In Window Control mode, move directionally
(based on QUERTY keyboard layout) among windows in the selected frame.
In Frame Control mode, move directionally among active frames. These
keys utilize and prompt to install the windmove and framemove packages
if not installed. See "(hyperbole)I/J/K/M".
** HYPERBOLE SYSTEM (See "(hyperbole)").
*** Any Colorized Display: Face display and colorization of Hyperbole
buttons now works on any display capable of displaying colors. See
"(hyperbole)Button Colors".
*** Create Buttons in Current Buffer: Stop prompting for a source buffer
when creating a Hyperbole button. Always use the current buffer and
point. See "(hyperbole)Creation".
*** DuckDuckGo Web Search: {C-h h f w k} runs a DuckDuckGo web search.
*** Hyperbole Keys Defer to Current Modes: Hyperbole bindings of {C-c RET},
{C-c .}, {C-c @}, and {C-c /} defer to any major mode, like org-mode,
outline-mode or kotl-mode that binds them to other commands. This also
works for outline-minor-mode.
*** Improved Button Help: {C-h A} now says whether a button is explicit or
implicit. For implicit buttons, it displays the doc from both its
implicit button type and its associated action type.
{C-h A} now also works on Emacs push-buttons and text property
buttons, displaying their attributes and associated action. See
"(hyperbole)Smart Key help".
*** Flymake Lint Warning Display: The new "hsys-flymake" library provides
commands to display the flymake warning at point as well as the full list
of warnings for th...
hyperbole-8.0.2pre
What's Changed
- Add files to website that are linked from README.md by @matsl in #195
- Don't byte compile test packages with external test dependencies by @matsl in #196
- Add target for native byte compilation by @matsl in #197
- Tests for shell related key series examples in the fast demo by @matsl in #198
- Add package-lint target by @matsl in #134
- Fix some package lint messages by @matsl in #199
- Use hload-path--make-directory-autoloads in Makefile by @matsl in #200
- Use defun for hact by @matsl in #120
- Remove xemacs compatibility code fragments by @matsl in #187
- Use messages-buffer, run test case only interactively by @matsl in #205
- Simplify test case by only testing unquoted file name by @matsl in #207
- Clean up after test case by @matsl in #208
- Patch by Stefan by @matsl in #209
- Use replace regexp in string by @matsl in #210
- Initial workflow to run make clean bin test for three versions on Emacs by @matsl in #211
- Rename global var to remove shadowing warnings by @matsl in #206
- Remove last mentioning xemacs by @matsl in #204
- Allow match on different apropos formats by @matsl in #201
- Doc strings within 80 char limit for hargs.el by @matsl in #213
- Doc strings within 80 char limit for hib-debbugs.el by @matsl in #214
- Doc strings within 80 char limit for hactypes.el by @matsl in #215
- Doc strings within 80 char limit for hbdata.el by @matsl in #216
- Doc strings within 80 char limit for hmouse-tag.el by @matsl in #221
- Doc strings within 80 char limit for kcell.el by @matsl in #223
- Doc strings within 80 char limit for kexport.el by @matsl in #224
- Doc strings within 80 char limit for hact.el by @matsl in #212
- Doc strings within 80 char limit for kfill.el by @matsl in #226
- Doc strings within 80 char limit for kimport.el by @matsl in #227
- Doc strings within 80 char limit for kotl-orgtbl.el by @matsl in #231
- Doc strings within 80 char limit for hbut.el by @matsl in #217
- Doc strings within 80 char limit for hhist.el by @matsl in #218
- Doc strings within 80 char limit for hib-doc-id.el by @matsl in #219
- Doc strings within 80 char limit for hib-kbd.el by @matsl in #220
- Doc strings within 80 char limit for kfile.el by @matsl in #225
- Doc strings within 80 char limit for klabel.el by @matsl in #228
- Doc strings within 80 char limit for klink.el by @matsl in #229
- Doc strings within 80 char limit for kproperty.el by @matsl in #232
- Doc strings within 80 char limit for kvspec.el by @matsl in #234
- Use loaddefs-generate when available by @matsl in #271
- hsys-youtube.el: Shorten docs strings to be within 80 char limit by @matsl in #251
- hui-em-but.el: Shorten docs strings to be within 80 char limit. by @matsl in #254
- hui-jmenu.el: Shorten docs strings to be within 80 char limit. by @matsl in #255
- hyrolo-demo.el: Shorten docs strings to be within 80 char limit. by @matsl in #266
- set.el: Shorten docs strings to be within 80 char limit. by @matsl in #270
- Adjust to new tramp regexp in emacs 29 by @matsl in #273
- Doc strings within 80 char limit for hmouse-info.el by @matsl in #243
- Doc strings within 80 char limit for hmoccur.el by @matsl in #241
- Doc strings within 80 char limit for hmouse-mod.el by @matsl in #245
- htz.el: Shorten docs strings to be within 80 char limit. by @matsl in #252
- hywconfig.el: Shorten docs strings to be within 80 char limit. by @matsl in #269
- Use maintenance release 28.2 by @matsl in #274
- Add 28.1 in again by @matsl in #276
- Cleanup - Remove unused function and do not use removed function by @matsl in #236
- Doc strings within 80 char limit for hinit.el by @matsl in #238
- Doc strings within 80 char limit for hload-path.el by @matsl in #239
- Doc strings within 80 char limit for hmouse-drv.el by @matsl in #242
- Doc strings within 80 char limit for hmouse-key.el by @matsl in #244
- Doc strings within 80 char limit for hmouse-sh.el by @matsl in #246
- hui-window.el: Shorten docs strings to be within 80 char limit. by @matsl in #260
- hversion.el: Shorten docs strings to be within 80 char limit. by @matsl in #262
- hyperbole.el: Shorten docs strings to be within 80 char limit. by @matsl in #265
- hyrolo-logic.el: Shorten docs strings to be within 80 char limit. by @matsl in #268
- Doc strings within 80 char limit for hibtypes.el by @matsl in #237
- hpath.el: Shorten docs strings to be within 80 char limit. by @matsl in #249
- hui-select.el: Shorten docs strings to be within 80 char limit. by @matsl in #259
- hycontrol.el: Shorten docs strings to be within 80 char limit. by @matsl in #263
- hypb.el: Shorten docs strings to be within 80 char limit. by @matsl in #264
- Doc strings within 80 char limit for hyrolo.el by @matsl in #277
- hvar.el: Shorten docs strings to be within 80 char limit. by @matsl in #261
- hui-mouse.el: Shorten docs strings to be within 80 char limit. by @matsl in #258
- First stab at register support by @matsl in #272
- hui-mini.el: Shorten docs strings to be within 80 char limit. by @matsl in #256
- hsys-org.el: Shorten docs strings to be within 80 char limit. by @matsl in #250
- Doc strings within 80 char limit for hsettings.el by @matsl in #248
- Doc strings within 80 char limit for hmouse-tag.el by @matsl in #247
- Doc strings within 80 char limit for hmail.el by @matsl in #240
- Doc strings within 80 char limit for hib-social.el by @matsl in #235
- Doc strings within 80 char limit for kotl-mode.el by @matsl in #230
- hui.el: Shorten docs strings to be within 80 char limit. by @matsl in #253
- Use line-beginning-position and line-end-position by @matsl in #281
- Doc strings within 80 char limit for kview.el by @matsl in #233
- Fix most remaining docstring lengths by @matsl in #278
- Update docstrings to not use single quotes, removes warning by @matsl in #280
- Shorten docstring that slipped through the net by @matsl in #282
- Show docstring warnings again by @matsl in #279
- Fix lexical-dynamic warnings by @matsl in #284
- Use defvar for hyperb:dir by @matsl in #285
- Silence warning about reference to free variable by @matsl in #283
- Use pattern substitution to derive the elc files by @matsl in #291
- Update main.yml by @matsl in #288
- Do not mention removed function-in-buffer by @matsl in #295
- Use kotl mode copy regions as kill ...
Hyperbole 8.0.0: May 2022 Release
** HYPERBOLE SYSTEM
*** Installation: Hyperbole package installation options are greatly expanded.
Stable or in-development branches may be installed with the Emacs package
manager. The Straight package manager may be used to keep up with
git-based development and submit pull requests. And stable and
in-development tar balls are available for manual installation. See
"(hyperbole)Installation".
*** Global Minor Mode: Hyperbole is now a global minor mode that can be
toggled with {M-x hyperbole-mode RET}, meaning all of its key bindings
can easily be enabled or disabled whenever desired. Your init file needs
to have (hyperbole-mode 1) in it instead of (require 'hyperbole) or
Hyperbole will not be enabled upon startup. See "(hyperbole)Usage".
Modeline Indicator: In the modeline where minor modes are shown,
"Hypb" now appears whenever Hyperbole is active.
Hooks: When hyperbole-mode is enabled, hyperbole-mode-hook and
hyperbole-mode-on-hook are run. When hyperbole-mode is disabled,
hyperbole-mode-hook and hyperbole-mode-off-hook are run.
Lexical Binding: All code is now largely lexically bound, improving
quality and debugability.
** ORG MODE
*** M-RET: Reworked M-RET interface so can control how much or little of
Hyperbole works in Org mode when Hyperbole minor mode is enabled.
See "(hyperbole)enable org-mode support" and "hsys-org.el".
*** hsys-org-enable-smart-keys: New customization to replace
'inhibit-hsys-org'. This applies only in Org major/minor modes when
hyperbole-mode is active. t means enable Smart Key support
everywhere. The symbol, buttons, is the default; it means the Smart
Keys are active only when point is within a Hyperbole button. A nil
value means no Smart Key support so {M-RET} behaves just as it does
normally in Org mode. See "(hyperbole)Org-mode". Use {C-h h c o}
to customize this setting.
This table summarizes the operation:
|--------------+-------------------+------------------+----------+------------------|
| Set To | Smart Key Context | Hyperbole Button | Org Link | Fallback Command |
|--------------+-------------------+------------------+----------+------------------|
| buttons | Ignore | Activate | Activate | org-meta-return |
| nil | Ignore | Ignore | Ignore | org-meta-return |
| t | Activate | Activate | Activate | None |
|--------------+-------------------+------------------+----------+------------------|
** EASILY CREATE YOUR OWN BUTTON TYPES
*** Simple Action Link Button Type Creation: `defal' is a new,
easy-to-use construct that generates new action button types from
a type name and a single simple format expression, allowing
non-programmers to create their own implicit action button link
types that execute key series, display URLs, display the contents
of pathnames or invoke functions. See "(hyperbole)Action Button
Link Types" or the "DEMO2#Defining New Action Button Types"
section.
*** Easy Implicit Link Button Type Creation: 'defil' is a new
construct for those familiar with regular expressions but not
much Emacs Lisp. This creates more flexible implicit button
types than 'defal' where the delimiters and text substitution
can be specified with regular expressions. Actions are limited
to executing key series, displaying URLs, displaying the
contents of pathnames or invoking functions. See
"(hyperbole)Implicit Button Link Types".
Elisp programmers should use the existing 'defib' macro for full
flexibility in implicit button type creation. See "hibtypes.el"
for examples and "(hyperbole)Programmatic Implicit Button Types"
for documentation.
** TEST CASES
*** Hyperbole Automated Testing: Extensive quality improvements throughout
Hyperbole thanks in part to over 230 test cases now included in the
test/ subdirectory. Simply run 'make test-all' or 'make test' from the
command-line when in the Hyperbole source directory and you should see
all tests pass. If any fail, you can press the Action Key to see the
source of the failure. Full testing is supported under POSIX systems
only. See "Makefile" and "test/MANIFEST".
*** Implicit Button Types to Run Tests: The file "hypb-ert.el" contains two
action link types:
hyperbole-run-test - run a single Hyperbole test by name
hyperbole-run-tests - run one more tests matching a pattern
Example uses:
Run the test hbut-defal-url
<hyperbole-run-test hbut-defal-url>
Run the tests specified by the test selector hbut-defal
<hyperbole-run-tests hbut-defal>
Run all tests
<hyperbole-run-tests t>
*** Installation Testing: install-test/local-install-test.sh automatically
installs Hyperbole for testing from one or more of its releases or
development branches. See "Makefile" and "install-test/MANIFEST".
** HYROLO (See "(hyperbole)HyRolo").
*** Faster searching within HyRolo match buffer: After performing a HyRolo
search with point in the match buffer, if you want different results,
you can quickly do a new regular expression HyRolo search with {r} or
a string/logical search with {C-u r}. This key had moved to previous
matches but that is already bound to {Shift-TAB} and {M-TAB}.
*** Auto-Expansion of Entries: If an entry is collapsed/hidden, moving to
any hidden part auto-expands it and then re-collapses it when point is
moved to another entry (just like isearch). A side-effect of this is
that the {h} hide entry subtree command now moves to the beginning of
the entry.
*** hyrolo-find-file: New command that selects and edits a file in
'hyrolo-file-list', defaulting to the first listed file when not given
a prefix arg. Available in the minibuffer menu as Rolo/File and the
pulldown menu as Rolo/Find-HyRolo-File.
*** Sorting Entries Rewritten: {C-h h r o} re-ordering HyRolo entries has
been rewritten for compatibility and improved debugging with the latest
Emacs releases.
*** hyrolo-highlight-face: Now uses the Emacs 'match' face by default.
*** Under MS Windows, the default HyRolo file is now "~/.rolo.otl" like
all other operating systems, instead of "~/_rolo.otl". Any older file
name will be relocated to the newer name.
** KOUTLINER (See "(hyperbole)Koutliner").
*** Export Koutlines to Collapsible Web Pages: {C-h h k f d} or
{M-x kexport:display RET} command creates and displays a web-based
expandable/collapsible outline from the Koutline in the current buffer.
See "(hyperbole)Exporting" and the new Koutliner Format submenu.
*** Org File Importation: Org files may now be imported to a Koutline using
{M-x kimport:file RET}.
*** Org Table Support: Org table editing now automatically works in the
Koutliner via Org table minor mode. Use {M-x orgtbl-mode RET} to
toggle this on and off. A press of the Action Key on a | symbol,
also toggles this minor mode on or off. See "(Org)Tables" for details.
Use a prefix arg with {TAB} to promote/demote Koutline trees when in
a table since {TAB} moves between fields within a table.
*** New Tree Movement Commands: Like Org mode, {[M-down]} and {[M-up]} move
the current tree past or before other trees at the same level. With a
prefix argument, move past that many trees.
*** New Tree Promotion/Demotion Keys: Tree promotion and demotion keys now
match many of the defaults in Org mode and Outline mode, plus some
easier to type ones. The tables below summarize which keys work whether
inside an Org table or outside. See "(hyperbole)Promoting and Demoting".
|----------------------------+-----------------------------|
| Promotion Inside Org Table | Demotion Inside Org Table |
|----------------------------+-----------------------------|
| M-0 Shift-TAB or M-0 M-TAB | M-0 TAB |
| C-c C-, | C-c C-. |
| C-c C-< | C-c C-> |
|----------------------------+-----------------------------|
|-----------------------------+----------------------------|
| Promotion Outside Org Table | Demotion Outside Org Table |
|-----------------------------+----------------------------|
| Shift-TAB or M-TAB | TAB |
| M-left | M-right |
| C-c C-, | C-c C-. |
| C-c C-< | C-c C-> |
|-----------------------------+----------------------------|
*** New Mail Tree Key Binding: The 'kotl-mode:mail-tree' command that
extracts the current view of a Koutline in text-only format and
creates an outgoing email message with it, has moved from {C-c @}
to {C-c C-@} to prevent conflict with the global hycontrol-window-grid
command bound to {C-c @}.
*** New Copy Command: The new command, 'kotl-mode:copy-tree-or-region-to-buffer',
bound to {C-c M-c} copies a Koutline tree or the active region
to a specified buffer. Prompts dictate whether invisible text
is included or not. This allows copying parts of Koutlines
directly into other buffers without having to copy to a
...
Hyperbole 8.0.0 Pre-release
Hyperbole V8 has many new features as well as improvements including Hyperbole is now a global minor mode so its key bindings are even easier to enable or disable when needed. See the README.md and HY-NEWS files for some details.
Hyperbole 7.1.3: September 2020 release
SMART (ACTION AND ASSIST) KEYS
- Global Org Link Activation: The Action Key now activates Org links in
non-Org buffers if 'inhibit-hsys-org' is nil (the default). The Assist
Key shows help.
- Org Agenda Item Display: The Action Key displays the Org node
associated with Agenda items such as TODOs in another window. The
Assist Key shows help.
- Org Mode: Raised to near top priority in implicit button types so that
pathnames, URLs, etc. within Org links are handled by Org rather than
Hyperbole.
- Smart Dired Sidebar: Smart Key support for the dired-sidebar
package. See "(hyperbole)Smart Key - Dired Sidebar Mode".
- Helm Mode: The Smart Keys do all sorts of things in helm completion buffers
and the associated minibuffer. See "(hyperbole)Smart Key - Helm Mode".
- Magit Mode: Action Key expands/collapses like {TAB} and Assist Key
jumps to items like {RET}. See "(hyperbole)Smart Key - Magit Mode".
BUTTON TYPES
- {Key Series} Button Support for Helm and Counsel: Key series buttons
with M-x commands now work properly when counsel-mode or helm-mode are
enabled and M-x is rebound.
- Markdown In-file Links: With point on the link title, in-file links are
now activated properly (previously point had to be on the link itself).
- Git#directory Buttons: New flag, hibtypes-git-use-magit-flag, which if
set to t and Magit is available, then when activating a git directory
button, such as git#/hyperbole, use Magit rather than Dired.
- Explicit Buttons Work Immediately: Previously you had to save the buffer
in which you created an explicit button before it would work. Now they
work immediately after creation.
DOCUMENTATION
- Helm Mode: Added Hyperbole Manual section, "Smart Key - Helm Mode"
that works on helm completions. See "(hyperbole)Smart Key -
Helm Mode".
- Hyperbole Slides: Slides used in a talk by the author on the history
and capabilities of Hyperbole, see "HY-TALK/HY-TALK.org".
- Magit Mode: Added Hyperbole Manual section, "Smart Key - Magit Mode"
that expands/collapses/jumps to Magit items. See "(hyperbole)Smart Key -
Magit Mode".
Hyperbole 7.1.0 TEST RELEASE - activate any labeled button; link-to-file with line and col numbers; documented link-to-bookmark
BUTTON TYPES
- In-buffer Labels: Fixed a number of in-buffer text handling issues with
the creation of explicit buttons, maximizing reuse of existing text in
labels.
- link-to-file Action Type: Extended to allow file path to include either
:line-num:column-num or just :line-num at the end (translated to character
location within the button).
DOCUMENTATION
- Bookmark Mode: Added Hyperbole Manual section, "Smart Key - Bookmark Mode"
that allows linking to Emacs Bookmarks. See "(hyperbole)Smart Key -
Bookmark Mode".
MENUS
- Activate Any Labeled Buffer Button: Hyperbole's top-level menu 'Act'
command either activates any button at point or prompts for the choice of
any labeled explicit or implicit button within the buffer to activate.
The pulldown menu item, Activate-Button-in-Buffer, behaves the same.
- Org-mode in Q&A Appendix: Rewrote this section to account for improved
integration.
Hyperbole 7.0.9: TEST RELEASE - region throws; frame dragging; improved org integration
Many issues were resolved in this test version as documented in the "Changes" file.
Only new features are listed here.
ACE WINDOW PACKAGE INTEGRATION - fast window and buffer switching
- After installing the ace-window package and loading Hyperbole, execute
(hkey-ace-window-setup "\M-o") to enable the following capabilities:
- Region Throws: The hkey-throw command bound to {M-o t} now throws the
active (highlighted) region, if any, into the target window's buffer,
rather than replacing its buffer with the source window buffer. If
you don't use region highlighting, i.e. transient-mark-mode, then use
{C-u M-o t} for the same effect. The buffer in the target window
must differ from the one in the source window. With no region
active, this command still throws the source buffer to the target
window. See "DEMO#Displaying File and Buffer Items and Moving Buffers".
SMART (ACTION AND ASSIST) KEYS
- Modeline Drag Window Resizing: Smart Key window resizing now provides
live feedback during the drag.
- Bottommost Modeline Frame Moving: After adding a 'drag-with-mode-line'
frame parameter with a value of t, a drag of any of its bottommost
modelines with either Smart Mouse Key repositions the frame on screen.
See "(hyperbole)Moving Frames" for information on how to configure this
feature.
CUSTOMIZATON
- hproperty:flash-face: Face used when flashing a button; now customizable.
- hproperty:highlight-face: Face used to highlight a line; now customizable.
- inhibit-hsys-org: See ORG MODE section below.
GLOSSARY
- Hlink Definitions: Added Action Button, Elink, Ilink, Glink definitions.
HYCONTROL
- Buffer/Window Swapping: Improved {~} so current buffer remains the same but
the selected window changes. Also made frame buffer swapping work anytime
there are two or more frames regardless of how many windows in each. See
"DEMO#Swapping Buffers".
HYROLO
- Hyrolo Add: Fixed new entry addition to add in sorted order and make logic
operators perform properly, after a bug in level calculation had been
introduced.
IMPLICIT BUTTONS
- Double Quoting Key Series: Key series delimited by {} may now be in double
quotes, e.g. "{C-x o}".
- Windows to Posix Paths: Much improved conversion of MSWindows UNC paths to
existing Posix mount points when running Emacs under Windows Subsystem for
Linux. See
- Flashing Implicit Buttons: More types of implicit buttons now flash when
activated.
- Improved Grep Output Parsing: Recognizes file names with spaces followed by
the null (^@, ASCII 0) character.
- Texinfo @-Quoted Path Variables: Hyperbole now can resolve paths as
complicated as this: @file{$@{hyperb:dir@}/DEMO#POSIX and MSWindows Paths}
in Texinfo files if the Action Key is pressed on the / or after, i.e. after
the variable name.
KEYS
- Deleted C-c C-r Global Binding: Removed {C-c C-r} key binding for explicit
button renaming due to conflicts with some major modes
ORG MODE
- Implicit Button Support: Org-mode's local binding of {M-RET} by default
now activates Hyperbole implicit buttons when within them.
- inhibit-hsys-org: New customization that when set non-nil disables
all Smart Key support in any Org major or minor mode.
- hsys-org-hbut-activate-p: Added to org-metareturn-hook so local binding
of {M-RET} in org-mode activates Hyperbole buttons when point is over
them. (It doesn't run the full set of Action Key actions).
PROGRAMMING
- Auto Imenu Reindexing: If using Emacs imenu package, the Action Key
will look up in-buffer identifier references with imenu. If imenu's
index is rendered invalid due to large changes in a buffer, Hyperbole
will now automatically rebuild the index to have correct pointers.
(Does not require use of the imenu-auto-rescan setting.
- hypb:mark-object: Gives Hyperbole-specific strings and symbols
a hyperbole property that distinguishes them from other objects.
- hypb:object-p: Tests whether has the hyperbole property. This is useful
in hpath:relative-to and hpath:absolute-to where any string with a
hyperbole property is ignored as a potential path. For example, this
prevents removal of trailing whitespace from normalized key series.
- hbut:act: Hyperbole button parameter is now optional and defaults to
the located button, the symbol, 'hbut:current.
- ibtypes tag lookup: Implicit button type names such as ibtypes::grep-msg
are now properly found in tags tables using their defib names
(e.g. grep-msg).
- hmouse-drag-p: tests whether absolute Smart Mouse Key depress and
release positions differ (relative to display/screen coordinates).
- hycontrol-quit: Unified the two Hycontrol mode quit commands into this one.
hycontrol-abort: Renamed from hycontrol-abort-mode.
- hyperb:autoloads-exist-p
hyperb:maybe-generate-autoloads
hyperb:generate-autoloads: Added and called from hyperb:init when
initializing Hyperbole to generate auto-autoload files when
running from a non-packaged source download of Hyperbole.
Hyperbole 7.0.8: TEST RELEASE - XML markup tag selection; global button renaming
BUTTONS
- Action Buttons: A new, universal syntax for creating implicit buttons
that execute any existing action types or Elisp functions. Such
buttons are delimited by angle brackets, < >, and come in three types:
action type invocations, function calls and variable displays. See
"(hyperbole)Action Buttons" for examples and details on this exciting
new capability.
- Labeled Implicit Buttons: Optional <[labels]> that precede implicit
buttons. This enables implicit buttons to be activated by name when
in the current buffer or anywhere when added to the global buttons
file (personal button file).
- Link to Buttons: New implicit button types that link to buttons based
on their categories and labels:
In Buffer Syntax Implicit Button Type
===========================================================================
<elink: explicit button label to link to: optional ebut file> link-to-ebut
<glink: global button label to link to> link-to-gbut
<ilink: implicit button label to link to: optional ibut file> link-to-ibut
- Other New Implicit Button Types:
debugger-source: Jump to the source of errors from the Python pytype package
ipython-stack-frame: Jump to the source of ipython stack traces and exceptions
- Other New Action Types:
link-to-bookmark: Display an Emacs bookmark
- Much Faster Implicit Buttons: Major speedup in implicit button identification
and activation even with the new generalized Action implicit button type
syntax, due to internal optimizations.
- Pathname Flashing: Pathname implicit buttons now flash when activated.
- Pathname References: Pathname implicit buttons may contain both link anchors
and line and column numbers. Format is:
"<path>[#<link-anchor>]:<line-num>[:<col-num>]"
- Shell Script Link Anchors: Link anchors now work for shell script editing modes
as well using comment lines as the anchors, e.g. "myscript.sh#Env Variables".
- Dir Variable Separators: Variables in paths no longer require a trailing directory
separator. Both of these are live Hyperbole paths:
"${hyperb:dir}DEMO#Smart Mouse Keys"
"${hyperb:dir}/DEMO#Smart Mouse Keys"
- Jump Thing: Added xml-mode support for pressing the Action Key when on a start or
end tag pair to select the whole region between them. {C-c .} also moves between
the start and matching end tag. See "(hyperbole)Smart Key Thing Selection".
DOCUMENTATION
- DEMO: New sections on Button Files and Global Buttons.
- Action Types: link-to-gbut, link-to-ibut - Added.
- hpath:native-image-suffixes: documented this setting for controlling
image types that Hyperbole displays within Emacs.
- Implicit Button Types: Split off type descriptions to this new
subsection and added these types: ripgrep-msg, ipython-stack-frame,
ilink (link to implicit button), glink (link to global button), and
elink (link to explicit button).
- DEMO (Action Buttons): Added description and examples.
- Path Variables: Better documented how these are handled.
- Hyperbole Manual, DEMO (Implicit Buttons): Added description and
example of implicit button labels.
- Glossary: Updated Implicit Button and Global Button entries with
changes.
KOUTLINER
- When 'c' (clip to lines per cell) is omitted from a viewspec, clipping
now changes to whatever the default number of lines per cell is
(typically, unlimited). The same goes for the 'l' spec (limit display
to a certain level of cells).
MENUS
- Pulldown Menus: Implicit-Button/Label: Added to add a label.
Implicit-Button/Rename - Added to rename the label
of an implicit button.
- Minibuffer Menus: hui-mini.el (hui:menus): Added Ibut/Label and
Ibut/Rename.
ORG MODE
- Radio Targets and Links: Smart Keys now handle these.
- Links: Smart Keys handle both internal and external Org mode links.
PROGRAMMING
- ibut:at-type-p: Added to test if point is on a specific type of
implicit button.
- hbut:key, ebut:key, ibut:key, hbut:rename, hui:hbut-rename,
hui:hbut-operate: Added to allow renaming of any type of labeled
Hyperbole button.
- hypb:region-with-text-property-value: Added and used in hysy-org.el.
- hsys-org-mode-function, hsys-org-mode-p: Added to determine when
hsys-org actions are activated.
- ebut:key-src-set-buffer, hbut:key-src-set-buffer, hbut:key-list,
hbut:ebut-key-list, hbut:ibut-key-list, hbut:label-list): Added
to allow selection of labeled Hyperbole buttons in currrent buffer by
name.
- gbut:get, hbut:map, ibut:label-map, ibut:key-src, ibut:key-to-label,
ibut:label-to-key, hui:ebut-act, ibut:summarize, ibut:label-start,
ibut:label-end, ibut:label-p, ibut:get, hui:ibut-label-create,
hui:ibut-rename, hui:ibut-message, ibut:alist, ibut:list, ibut:map,
ibut:next-occurrence, ibut:label-regexp, gbut:ibut-key-list, ebut:to,
gbut:to, ibut:to, ibut:label-separator, hbut:label-regexp,
ibut:rename, hbut:get: Added to support implicit button labels and
links to buttons.
hbut:label-p: Updated to handle implicit button labels.
ibut:label-separator-regexp, hbut:outside-comment-p: Added.
- elink, elink:start, elink:end: Added for in-buffer links to explicit buttons.
glink, glink:start, glink:end: Added for in-buffer links to global buttons.
ilink, ilink:start, ilink:end: Added for in-buffer links to implicit buttons.
- hsys-org-set-ibut-label: Added and used in org-mode ibtype.
org-mode, hsys-org-at-block-start-p: Added Action Key activation of
Org blocks when on 1st line of def.
SMART (ACTION AND ASSIST) KEYS
- Emacs Bookmark Menu Mode: Jump to the bookmark at point.
- hpath:find-program: Changed to prioritize hpath:native-image-suffixes
over hpath:internal-display-alist over hpath:external-display-alist-macos
instead of the reverse. This prevents external viewers from being
used when internal viewers are also in effect.
Hyperbole 7.0.7: TEST RELEASE - fixed new, more efficient htype symbol table lookups
BUTTONS
- Action Buttons: A new, universal syntax for creating implicit buttons
that execute any existing action types or Elisp functions. Such
buttons are delimited by angle brackets, < >, and come in three types:
action type invocations, function calls and variable displays. See
"(hyperbole)Action Buttons" for examples and details on this exciting
new capability.
- Labeled Implicit Buttons: Optional <[labels]> that precede implicit
buttons. This enables implicit buttons to be activated by name when
in the current buffer or anywhere when added to the global buttons
file (personal button file).
- Link to Buttons: New implicit button types that link to buttons based
on their categories and labels:
In Buffer Syntax Implicit Button Type
========================================================================
<elink: explicit button label to link to: optional ebut file> link-to-ebut
<glink: global button label to link to> link-to-gbut
<ilink: implicit button label to link to: optional ibut file> link-to-ibut
- Other New Implicit Button Types:
debugger-source: Jump to the source of errors from the Python pytype package
ipython-stack-frame: Jump to the source of ipython stack traces and exceptions
- Much Faster Implicit Buttons: Major speedup in implicit button identification
and activation even with the new generalized Action implicit button type
syntax, due to internal optimizations.
- Pathname Flashing: Pathname implicit buttons now flash when activated.
- Pathname References: Pathname implicit buttons may contain both link anchors
and line and column numbers. Format is:
"<path>[#<link-anchor>]:<line-num>[:<col-num>]"
- Shell Script Link Anchors: Link anchors now work for shell script editing modes
as well using comment lines as the anchors, e.g. "myscript.sh#Env Variables".
- Dir Variable Separators: Variables in paths no longer require a trailing directory
separator. Both of these are live Hyperbole paths:
"${hyperb:dir}DEMO#Smart Mouse Keys"
"${hyperb:dir}/DEMO#Smart Mouse Keys"
DOCUMENTATION
- DEMO: New sections on Button Files and Global Buttons.
- Action Types: link-to-gbut, link-to-ibut - Added.
- hpath:native-image-suffixes: documented this setting for controlling
image types that Hyperbole displays within Emacs.
- Implicit Button Types: Split off type descriptions to this new
subsection and added these types: ripgrep-msg, ipython-stack-frame,
ilink (link to implicit button), glink (link to global button), and
elink (link to explicit button).
- DEMO (Action Buttons): Added description and examples.
- Hyperbole Manual, DEMO (Implicit Buttons): Added description and
example of implicit button labels.
- Glossary: Updated Implicit Button and Global Button entries with
changes.
KOUTLINER
- When 'c' (clip to lines per cell) is omitted from a viewspec, clipping
now changes to whatever the default number of lines per cell is
(typically, unlimited). The same goes for the 'l' spec (limit display
to a certain level of cells).
MENUS
- Pulldown Menus: Implicit-Button/Label: Added to add a label.
Implicit-Button/Rename - Added to rename the label
of an implicit button.
- Minibuffer Menus: hui-mini.el (hui:menus): Added Ibut/Label and
Ibut/Rename.
ORG MODE
- Radio Targets and Links: Smart Keys now handle these.
- Links: Smart Keys handle both internal and external Org mode links.
PROGRAMMING
- ibut:at-type-p: Added to test if point is on a specific type of
implicit button.
- hypb:region-with-text-property-value: Added and used in hysy-org.el.
- hsys-org-mode-function, hsys-org-mode-p: Added to determine when
hsys-org actions are activated.
- ebut:key-src-set-buffer, hbut:key-src-set-buffer, hbut:key-list,
hbut:ebut-key-list, hbut:ibut-key-list, hbut:label-list): Added
to allow selection of labeled Hyperbole buttons in currrent buffer by
name.
- gbut:get, hbut:map, ibut:label-map, ibut:key-src, ibut:key-to-label,
ibut:label-to-key, hui:ebut-act, ibut:summarize, ibut:label-start,
ibut:label-end, ibut:label-p, ibut:get, hui:ibut-label-create,
hui:ibut-rename, hui:ibut-message, ibut:alist, ibut:list, ibut:map,
ibut:next-occurrence, ibut:label-regexp, gbut:ibut-key-list, ebut:to,
gbut:to, ibut:to, ibut:label-separator, hbut:label-regexp,
ibut:rename, hbut:get: Added to support implicit button labels and
links to buttons.
hbut:label-p: Updated to handle implicit button labels.
ibut:label-separator-regexp, hbut:outside-comment-p: Added.
- elink, elink:start, elink:end: Added for in-buffer links to explicit buttons.
glink, glink:start, glink:end: Added for in-buffer links to global buttons.
ilink, ilink:start, ilink:end: Added for in-buffer links to implicit buttons.
- hsys-org-set-ibut-label: Added and used in org-mode ibtype.
org-mode, hsys-org-at-block-start-p: Added Action Key activation of
Org blocks when on 1st line of def.
SMART (ACTION AND ASSIST) KEYS
- hpath:find-program: Changed to prioritize hpath:native-image-suffixes
over hpath:internal-display-alist over hpath:external-display-alist-macos
instead of the reverse. This prevents external viewers from being
used when internal viewers are also in effect.
Hyperbole 7.0.3: Ace Window Integration Improvements and MSWindows Path Support
ACE WINDOW PACKAGE INTEGRATION - fast window and buffer switching
- Selected Window Buffer Replace: Added the ability to 'replace' the
selected window's buffer with the buffer of another window. Use
{M-o r <window-id>}. To swap the buffers between the same two windows,
use {M-o m <window-id>. See "(hyperbole)Keyboard Drags" for setup and
use instructions.
- New Frame Commands: Any of these M-o commands that involve two windows
can use a new frame as the target window by using a <window-id> of 'z'.
So, {M-o t z} throws the current buffer to a new frame with a single
window displaying that buffer. The new frame will be the same size as
the prior frame to match the behavior of HyControl.
- Integrated Ace Window commands with Smart Key Drags and added commands
for use with the mouse that select Ace Window source and target windows
by clicking with the mouse: hmouse-click-to-drag,
hmouse-click-to-drag-stay, hmouse-click-to-drag-to,
hmouse-click-to-replace, hmouse-click-to-swap, hmouse-click-to-throw.
- {M-o i <window-id>} is now for use only when on a listing item such as
in Dired or Buffer Menu. It no longer creates Hyperbole buttons in
non-item areas to avoid confusion. Now it will just trigger an error
if not on a listing item.
SMART (ACTION AND ASSIST) KEYS
- MSWindows Paths: Hyperbole now recognizes typical MSWindows paths (both
local and remote shares) and can convert an in-buffer path between POSIX
and MSWindows formats multiple times, even paths involving mount points.
See "DEMO#POSIX and MSWindows Paths".
MSWindows paths may be used within links and implicit path
buttons just like POSIX paths, whether running Emacs under a POSIX
system or MSWindows. If under POSIX, a remote MSWindows path must be
accessed through a mount point to the network share. Hyperbole caches
such mount points when it is loaded. Use {M-x
hpath:cache-mswindows-mount-points RET} to update them if more mounts
are made later. See also the NEW COMMANDS section herein for how to
convert a path between POSIX and MSWindows formats.
- GitLab and Github Links: Added Gitlab implicit links with equivalent
functionality to those of Github. Added "people" reference support to
list people who are part of a formal organization as well as a "staff"
alias. Added "contributors" reference support to list project
contributors as well. Improved Github implicit issue links: gh#gh-34
and gh#issue/34 now properly reference an issue in the current project.
- Ripgrep: Added new ripgrep-msg implicit button type which jumps
to the source referenced by ripgrep (rg) output. By default,
ripgrep outputs pathnames only once before all matching lines
within that path. Ripgrep may also be used with the Hyperbole
`hypb:rgrep' command by setting 'hypb:rgrep-command'. See
"https://github.com/BurntSushi/ripgrep".
- Markdown Mode: Smart Keys now support Markdown internal file link
references and navigation.
- Org Mode: When in an *Org Help* buffer, the Smart Keys now defer to
org-mode to handle jumps to its own locations for compatibility.
Similarly, in org-mode buffers when not on an org link or heading,
and the {M-RET} Action Key is pressed, Hyperbole defers to Org's
org-meta-return command.
- Drag-based Kill, Copy and Yank: Added support for dragging across
frames.
- Python Identifiers: If a Jedi server is running and the Action Key is
pressed on a Python identifier, Hyperbole will use Jedi to find the
definition even within nested module references, e.g. a.b.c. Also
improved basic identifier definition finding.
- Company Mode Completion: Support for the Emacs company-mode completion
package. An Action Key press on a company-mode completion item will
display the definition of that item and an Assist Key press will
display its documentation, if any.
- Treemacs Mode: Now supports standard Hyperbole end-of-line proportional
scrolling.
- ChangeLog Mode: Smart Keys now work on Emacs Lisp references in
changelogs.
- Improved String Matching: For lines that begin with part of a string
that started on another line, Hyperbole now presumes that point is
within a string rather than between two strings, even though the
delimiters on the line make this ambiguous. This provides more
accurate string recognition.
- Improved Path Matching: For quote delimited paths, other quote marks
are excluded from matches, so if checking for a doubly quoted path,
single quotes are not allowed in the string.
HYCONTROL
- Help Buffer Quitting: If HyControl is active, normally {q} quits
it, but now if point is in an Emacs help buffer, {q} will quit
from the help buffer instead. Use {Q} to quit from HyControl
unconditionally.
NEW COMMANDS
- Buffer Sliding: Four new commands are available that can be
bound to things like control arrow keys: hkey-buffer-move-left,
hkey-buffer-move-right, hkey-buffer-move-down and
hkey-buffer-move-up. Each one slides the current buffer one
window in the direction specified and all other buffers slide
around to match.
- MSWindows and POSIX Path Toggling: In "hpath.el", added
(hpath:substitute-posix-or-mswindows-at-point) and
(hpath:substitute-posix-or-mswindows) commands to toggle the
format of a path at point or in a string between POSIX and
MSWindows styles.
PROGRAMMING
- Added hypb:map-plist, equivalent to mapcar but maps over
key-value pairs in property lists (where the key and value are
individual elements in the list).
- In "hui-select.el", added functions to return info. on the
context-sensitive region that this library selects.
(hui-select-get-region) returns the region that would be
selected at point and (hui-select-get-region-boundaries)
returns a cons of the start and end position of the same region.
- In "hpath.el (hpath:delimited-possible-path), added optional
include-positions parameter which if non-nil, adds start and end
positions to returned value.
- In "hversion.el", added (hyperb:wsl-os-p) flag to test whether
Emacs is running under Microsoft Windows Subsystem for Linux (WSL)
since the system-type variable does not reflect this.
DOCUMENTATION
- Popup Menus: Documented how to invoke the Koutliner and
HyRolo popup menus in Emacs. See "(hyperbole)Menu Commands".
- DEMO: Added sections:
"DEMO#Gitlab (Remote) References"
"DEMO#POSIX and MSWindows Paths"
- Updated Hyperbole Manual with new features.