Emacs Docs

Appearance

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 package is installed prior to loading Hyperbole; it provides fast line-level searching across many files with interactive search pattern narrowing):

lisp
Menu Item       Command                 Description
=====================================================================
Add             hyrolo-add              Add a hyrolo entry
ConsultFind     hyrolo-consult-grep     Interactive 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 hyrolo Org tags
WordFind        hyrolo-word             Find all entries containing
                                          a string of whole words
Yank            hyrolo-yank             Insert at point the first
                                          matching hyrolo entry
=====================================================================

The FileFind 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.

The Yank menu item inserts at point the first entry found that matches the given expression. With any prefix argument other than C-u, the universal argument, the search expression is treated as a regular expression rather than a string. By default, sub-entries are not included in the match inserted; but with C-u, the universal argument, as the prefix argument, they are included.

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:

orgmode
*    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:

orgmode
***      Staffer