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

%^RED%^%^BOLD%^SYNTAX ::: %^RESET%^set_listens( map_targ )

This function is present in all objects. It will setup the mapping passed
in the arguement map_targ for the listens present inside the object.

set_listens( ([ "leaf":"You listen contently to the wind gently blowing
the leaves.",
               "stem": (: stem_function :),
               "petal":"You hear a buzzing coming from in the flower..." ]) );

You may have as many or as few entries in this function as you wish.
It can accept both strings and functions as values in the key:value pairs
on the mapping. Please see ^&CYAN%^%^BOLD%^coding mappings%^RESET%^ for more help on mappings.

see also ::

set_listen, remove_listen, remove_listens, query_listen, query_listens

