HyRolo Keys
After a rolo search is performed, point is left in the rolo match buffer, *HyRolo*, which uses hyrolo-mode to simplify browsing many HyRolo matches. Press {?} when in the match buffer for a summary of available keys, all of which are documented in this section.
If your HyRolo search did not match what you want, use {r} to start a new regular expression query or {C-u r} for a string query. The rest of the match buffer keys work with the search results currently displayed.
If your emacs version supports textual highlighting, each search match is highlighted for quick, visual location. {TAB} moves point forward to successive spans of text which match the search expression. If the matching text is hidden/invisible, it is shown; the body of the entry with the match, as well as all of its sub-entries are shown. {M-TAB} or {SHIFT-TAB} move point backward to earlier matches. These keys allow you to quickly find the matching entry of most interest to you if your search expression failed to narrow the matches sufficiently.
To extend the match expression with some more characters to find a particular entry, use {M-s}. This performs an interactive search forward for the match expression. You may add to or delete characters from this expression to find different occurrences or move to the next match with {C-s}. {C-r} reverses the direction of the search.
To search for a specific entry name in the match buffer, use {l} to interactively locate the text immediately following the entry start delimiter, typically one or more asterisks. This lets you find entries by last name quickly, eliminating other matches. Standard string, {C-s}, and regular expression, {C-M-s}, interactive search commands are also available within the rolo match buffer.
Single key outlining commands are also available for browsing matches. If your search matches a large number of entries, use {t} to get a top-level summary of entries. Only the first line of each first-level match is shown. If you want to see an overview of all the levels, use {o} which shows the first line of every entry level. If you want an overview of just the first two levels, {C-u 2 o} will work.
Press {s} to show (expand) the entry at point if it is hidden (collapsed). If point is on a file header, this will expand the header and show the entire set of matched entries for the file. The {h} does the reverse and hides entries. Within file headers it hides the file from the end of the current line forward, so you can leave parts of the header displayed, if desired. Press {a} to expand all entries in the buffer across all matched files.
If an entry is collapsed/hidden, moving to any hidden part auto-expands it. Use {h}, the hide entry subtree to hide it again, if desired; this leaves point at the beginning of the entry (does not apply in file headers) to facilitate further use of movement by entry commands.
Other keys are defined to help you work with matching entries.
{b}
Move to the previous entry at the same level as the current entry.
{f}
Move to the next entry at the same level as the current entry.
{n}
Move to the next entry at any level.
{p}
Move to the previous entry at any level.
{u}
Move to the previous higher entry one level up.
{,}
Move to the beginning of the entry. With a prefix argument, move to the beginning of highest ancestor level.
{.}
Move to the end of the entry. With a prefix argument, move to the end of the entire subtree.
{[}
Move to previous file/buffer location header beginning with @loc>.
{]}
Move to next file/buffer location header beginning with @loc>.
{<}
Move to the beginning of the buffer.
{>}
Move to the end of the buffer.
{DEL}
{SPC}
Scroll forward a windowful.
Use the {e} key to jump to and edit the current line in its original source file. If on a rolo entry and it contains a datestamp at its end, update the datestamp, unless this feature has been turned off via the Cust/Toggle-Rolo-Dates menu item. The variable, hyrolo-edit-hook, performs this update. This allows programmed modification of the way rolo edits work. The variable, hyrolo-add-hook, works the same way but is evaluated when a new entry is first added. The format of the datestamp is specified by hyrolo-date-format.
Once you have found an entry of interest and you want to remove the rolo match buffer, use {q} to quit. This will restore your current frame to its state prior to the rolo search.