Creation Via Menus

Explicit buttons are managed with the Hyperbole Ebut/ menu accessed with {C-h h e}. The Create item, {C-h h e c}, creates any type of explicit button. It prompts for an explicit button label (default is any selected region), an action type, and the action’s associated arguments. It then creates the button at point and surrounds the label with <(explicit button delimiters)> like so, to indicate success.

You can use the direct selection techniques mentioned in Smart Key Argument Selection, to select any completion-based arguments. If you do not mark a region before invoking the button create command, you will be prompted for both a label and a target buffer for the button and the delimited label text will be inserted into the target buffer after a successful button creation.

If a previous button with the same label exists in the same buffer, Hyperbole will add an instance number to the label when it adds the delimiters so that the name is unique. Thus, you don’t have to worry about accidental button name conflicts. If you want the same button to appear in multiple places within the buffer, just enter the label again and delimit it yourself or copy and paste the button with its delimiters. Hyperbole will interpret all occurrences of the same delimited label within a buffer as the same button.