Core Help Root: Commands: @grep


PROGRAMMER COMMAND

Syntax: @grep [options] <regexp> <object> <object>...

This command allows you to search through the database for items matching the regexp. Depending on the options selected, <object> may be either the root object to start searching from, or one (or more) of the indivdual objects to search.

Options can be:

+d?escend Start searching from the following <object> and work down it's descendants list.
+f?ull Lists the method <regexp> was found in, as well as the line that contains the <regexp>.
+l?ist Lists the methods the <regexp> was found in.
+r?eplace-with=<text> Text to replace item matched by <regexp> with.

The following example will search through the database, starting with the $root object, and progress down it's descendants list searching for .tell. The numbers following the method names, are the line numbers within those methods that contain the <regexp>:

>@grep +d .tell $root
Searching for ".tell"...
$root.uninit_root(): 25
$root.initialize(): 16, 22 and 23
$root.uninitialize(): 16, 17, 18, 27, 28, 30, 31, 32, 45, 46, 47, 55, 56, 57, 58 and 59
$root.add_method(): 15
$root.debug(): 12
..

Caution: It is advised that you don't descend from $root very often, as this tends to lag the server.



the Cold Dark