Rolo Menu

The Rolo submenu of the Hyperbole menu offers a full set of commands for searching and maintaining a personal address book. It looks like so.

Rolo>  Add  ConsultFind  Display  Edit  FileFind  Info  Kill  Mail  Order  RegexFind  StringFind  TagFind  WordFind  Yank

The Rolo/ menu entry on the Hyperbole minibuffer menu provides the same set of commands as the menubar Rolo menu but with more concise labels.

The minibuffer Rolo/ menu offers the following commands (ConsultFind appears only when the Consult and Helm packages are installed prior to loading Hyperbole. They are especially noteworthy as they allow for fast line-level searching across many files with interactive search pattern narrowing):

Menu Item       Command                 Description
=====================================================================
Add             hyrolo-add              Add a hyrolo entry
ConsultFind     hyrolo-consult-grep     Interactively narrow grep matches
Display         hyrolo-display-matches  Display last matches again
Edit            hyrolo-edit             Edit an existing hyrolo entry
FileFind        hyrolo-find-file        Edit a hyrolo-file-list file
Info            id-info                 Display a hyrolo manual entry
Kill            hyrolo-kill             Delete a hyrolo entry
Mail            hyrolo-mail             Mail to an address at point
Order           hyrolo-sort             Sort all hyrolo levels
RegexFind       hyrolo-grep             Find all entries containing
                                          a regular expression
StringFind      hyrolo-fgrep            Find all entries containing
                                          a string (or logical
                                          expression)
TagFind         hyrolo-tags-view        Find HyWiki Org tags
WordFind        hyrolo-word             Find all entries containing
                                          a string of whole words
Yank            hyrolo-yank             Insert the first matching
                                          hyrolo entry at point
=====================================================================

The ’File’ menu item displays and edits the first file listed in hyrolo-file-list unless given a prefix argument, in which case it prompts with completion for the file to edit.

A prefix argument used with any of the above menu items that have ’Find’ in their names limits the search to a maximum number of matches given by the argument. The search is terminated whenever that number of matches is found.

With any of the above commands that prompt for a HyRolo name, such as Edit or Add (not the Find commands), you may use the form parent/child to locate a child entry below a specific parent. Hence, for a HyRolo which looks like so:

*    Company
**     Manager
***      Staffer

you can refer to the Staffer entry with the following hierarchical notation, Company/Manager/Staffer. This hierarchical notation is not used in search expressions since they search the entire HyRolo anyway. Thus, "Staffer" as a search pattern will find an entry containing "Staffer" at any level in a hierarchy, like so:

***      Staffer