=======================================================================

%^RED%^%^BOLD%^ SYNTAX :: %^RESET%^ set_search ( target, message )
%^RED%^%^BOLD%^ SYNTAX :: %^RESET%^ set_search ( target, function )

This function is present in all objects. It will add the search named
in the string target into the object. Either a string message can be
defined or a function pointer (: :) .

see also ::

set_searches, remove_search, remove_searches, query_search, query_searches

