osd-search(3)

NAME

osd-search - Search and annotate the current buffer

SYNOPSIS

osd-search

DESCRIPTION

osd-search is a hidden macro which provides a method of searching for text patterns within the current buffer and annotating any matches through colored line hilighting. A selection of line colors are provided to allow different search patterns to be assigned their own color.

osd-search is generally used for annotating log files and alike, where indevidual lines are of interest in addition to the context about that line. The hilighting draws attention to the line, by providing a visual cue, allowing the contents of the file to be breifly scanned.

On invocation of osd-search from the menu Search -> Hilight Search a osd(2) dialog is presented to the user, search patterns and their associated hilighting assignment are selected through this interface. The dialog entries are defined as follows:

Search for


The text dialog entry box allows the search pattern to be entered. This may be a regular expression or plain text.

Color


The Color allows the line hilighting color scheme to be selected from a pop-up menu. The color Remove is special and allows previously applied line hilighting to be removed.

Case Sensitive


A check box that allows the search to be case sensitive or insensitive. This modifies the exact(2m) mode.

Magic Mode


A check box that enables/disables regular expression pattern matching. This modifies the magic(2m) mode.

Below


Searches and hilights lines matching the search pattern from the current cursor position to the end of the buffer.

Above


Searches and hilights lines matching the search pattern from the current cursor position to the top of the buffer.

All


Searches and hilights lines matching the search pattern for the whole buffer.

Clear All


Removes all line hilighting from the current buffer.

First


Moves to the top of the buffer and hilights the first line that matches the search pattern.

Next


Hilights the next line that matches the search pattern.

Reverse


Hilights the previous line that matches the search pattern.

Exit


Exits the hilighting search dialog.

NOTES

osd-search is a macro implemented in osdmisc.emf.

SEE ALSO

delete-hilight-lines(3), line-scheme(3), osd(2), $line-scheme(5).

Ref: osd-search(3) File: m3osd004.3 Date: 2022/06/12

(c) Copyright JASSPA 2026