www.delorie.com/gnu/docs/hyperbole/hyperbole_58.html

search

	Buy GNU books!

Hyperbole User Manual

8.4 Rolo Settings

If textual highlighting is available in your Emacs on your current display type, the rolodex uses the value of rolo-highlight-face as the face to use to highlight search matches.

The buffers containing the rolodex files are not killed after a search on the assumption that another search is likely to follow within this Emacs session. You may wish to change this behavior with the following setting: (setq rolo-kill-buffers-after-use t).

After an entry is killed, the modified rolodex file is automatically saved. If you would rather always save files yourself, use this setting: (setq rolo-save-buffers-after-use nil).

When adding an entry from within a buffer containing a mail message, the rolodex add function will extract the sender's name and e-mail address and prompt you with the name as a default. If you accept it, it will enter the name and the email address using the format given by the rolo-email-format variable. See its documentation if you want to change its value.

The files used in any rolodex search are given by the rolo-file-list variable, whose default value is ("~/.rolodex.otl"), so that searches initially scan only your personal rolodex. Any entries added to this list should be file pathnames. If a file in the list does not exist or is not readable, it is skipped. Files are searched in the order in which they appear in the list. In general, you should leave your personal rolodex file as the first entry in the list, since this is the only file to which the rolo menu Add command adds entries.

The rolodex entry start delimiter is given by the regular expression variable, rolo-entry-regexp, whose default value is "^\*+".

A rolodex file may begin with an optional header section which is copied to the match display buffer whenever any matches are found during a search. The start and end lines of this header are controlled by the regular expression variable, rolo-hdr-regexp, whose default value is "^===". This allows lines of all equal signs to visually separate matching entries from multiple files retrieved from a single search.