44#
55# Orig-Date: 19-Oct-91 at 03:27:47
66#
7- # Copyright (C) 1989-2016 Free Software Foundation, Inc.
7+ # Copyright (C) 1989-2021 Free Software Foundation, Inc.
88# See the "HY-COPY" file for license information.
99#
1010# This file is part of GNU Hyperbole.
@@ -26,14 +26,50 @@ written by Bob Weiner. It is maintained by him and Mats Lidell.
2626* Summary
2727===========================================================================
2828
29- GNU Hyperbole (pronounced Ga-new Hi-per-bo-lee), or just Hyperbole, is an
30- easy-to-use, yet powerful and programmable hypertextual information
31- management system implemented as a GNU Emacs package. It offers rapid views
32- and interlinking of all kinds of textual information, utilizing Emacs for
33- editing. It can dramatically increase your productivity and greatly reduce
34- the number of keyboard/mouse keys you'll need to work efficiently.
35-
36- Hyperbole lets you:
29+ GNU Hyperbole (pronounced Ga-new Hi-per-bo-lee), or just Hyperbole, is like
30+ Markdown for hypertext. Hyperbole automatically recognizes dozens of
31+ common, pre-existing patterns in any buffer regardless of mode and can
32+ instantly activate them as hyperbuttons with a single key: email addresses,
33+ URLs, grep -n outputs, programming backtraces, sequences of Emacs keys,
34+ programming identifiers, Texinfo and Info cross-references, Org links,
35+ Markdown links and on and on. All you do is load Hyperbole and then your
36+ text comes to life with no extra effort or complex formatting.
37+
38+ Hyperbole includes easy-to-use, powerful hypertextual button types without
39+ the need to learn a markup language. Hyperbole's button types are written
40+ in Lisp and can be wholly independent of the web, i.e. web links are one
41+ type of Hyperbole link, not fundamental to its link architecture. However,
42+ Hyperbole is a great assistant when editing HTML or Javascript or when
43+ browsing web pages and links.
44+
45+ Hyperbole comes pre-built with most of the implicit button types you will
46+ need but with a little extra effort and a few lines of code (or even just a
47+ few words), you can define your own implicit button types to recognize your
48+ specific buttons and then activate them anywhere in Emacs. You press a
49+ single key, {M-RET} by default, on any kind of Hyperbole button to activate
50+ it, so you can rely on your muscle memory and let the computer do the hard
51+ work of figuring out what to do. {C-u M-RET} shows you what any button will
52+ do in any context before you activate it, so you can always be sure of what
53+ you are doing when needed or if some emails you a button (you can do that
54+ too).
55+
56+ Hyperbole is something to be experienced and interacted with, not understood
57+ from reading alone. It installs normally as a single Emacs package with no
58+ dependencies outside of standard Emacs libraries. Most of Hyperbole is a
59+ single global minor mode that you can activate and deactivate at will. And
60+ it can be uninstalled quickly as well if need be, so there is no risk to
61+ giving it a spin.
62+
63+ Once you have it installed and activated {C-u M-x hyperbole-mode RET}, try
64+ the interactive demo with {C-h h d d}. In fact, if you have Hyperbole
65+ loaded, you can press {M-RET} inside any of the brace delimited series of
66+ keys you see in this document and it will execute them on-the-fly (easy
67+ keyboard-macro style buttons in any text).
68+
69+ Hyperbole can dramatically increase your productivity and greatly reduce the
70+ number of keyboard/mouse keys you'll need to work efficiently.
71+
72+ In short, Hyperbole lets you:
3773
38741. Quickly create hyperlink buttons either from the keyboard or by dragging
3975between a source and destination window with a mouse button depressed.
0 commit comments