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

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

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

set_touches( ([ "leaf":"You touch the morning dew on the leaf",
               "stem": (: stem_function :),
               "petal":"Your fingers are covered in pollen as you touch the
flower's petal" ]) );

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_touch, remove_touch, remove_touches, query_touch, query_touches

