Hyperbole User Manual
3.7.1.1 Creation Via Action Key Drags
The most efficient way to create an explicit button interactively is to
use the mouse Action Key to drag from a button source window to a window
showing its link referent. More specifically, you should split your
current Emacs frame into two windows: one which contains the point at
which you want a button to be inserted and another which shows the point
to which you want to link. Depress the mouse Action Key at the point at
which the button should be inserted, drag to the other window and
release it at the point of the link referent. The process becomes quite
simple with a little practice. (See section Creation Via Menus, for a
more detailed explanation of the explicit button creation process.)
Hyperbole uses the link referent context to determine the type of link
to make. If there are a few different types of links which are
applicable from the context, you will be prompted with a list of the
types. Simply use the Action Key or the first letter of the link
type to select one of the type names and to finish the link creation.
Hyperbole will then insert explicit button delimiters around the button
label and will display a message in the minibuffer indicating both the
button name and its action/link type.
If you run Emacs under a window system, you can emulate an Action Key
drag from the keyboard by: hitting {M-o}, the
hkey-operate command, at the button source location, moving
to the link destination, e.g. with {C-x o}, and then hitting
{M-o} again. This simulates a depress and then release of the
Action Key. {C-u M-o} emulates drags of the Assist Key.
This will not work when Hyperbole is run from a dumb terminal Emacs
session since drag actions are not supported without a window system.
