Internal Viewers ​

When given a filename to display, Hyperbole first checks if its suffix is matched by hpath:native-image-suffixes. If so and if the function image-mode is defined, it uses that mode together with the value of hpath:display-where to display the image within an Emacs buffer.

If no match is found, the hpath:internal-display-alist variable is checked for a filename match. Its value is an association list whose elements are (<file-name-regular-expression> . <function-of-one-arg>) pairs. Any path whose name matches a <file-name-regular-expression> will be displayed by calling the associated <function-of-one-arg> with the filename as the argument. The first regular expression that matches each filename is the one used. This can be used to format raw data files for convenient display.

By default, this setting handles the following types of files:

• Audio Files ​

Major audio format files are played with the play-sound-file command.

• Info Manuals ​

Files with a .info suffix (may also be compressed) are displayed in the Info browser.

• RDB Files ​

Files with an .rdb suffix are displayed as relational databases using the RDB package available with InfoDock.

Links to standard files, those which don’t match any special referent category described earlier, are displayed in an Emacs window specified by the hpath:display-where setting. It may be changed with the Cust/Referents {C-h h c r} menu.

Available options are:

• Any-Frame ​

Display in the selected window of another existing frame

• Current-Win ​

Display in the selected (current) window

• Diff-Frame-One-Win ​

Display in the selected window of another existing frame, deleting its other windows

• New-Frame ​

Display in a new single window frame

• Other-Win ​

Display in another, possibly new window of the selected frame (this is the default)

• Single-Win ​

Display in a window of the selected frame and delete its other windows

Alternatively, you can use the Hyperbole menubar menu as shown here:

Display Referents Menu

Image B.2: Display Referents Menu

See External Viewers, for instructions on associating filenames with external, window-system specific viewers.