# osd-search(3)

[Home] [Commands] [Variables] [Macro-Dev] [Glossary]

## 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).

(c) Copyright JASSPA 2009
Last Modified: 2009/08/29
Generated On: 2009/10/12

</HMTL>