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

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

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

set_smells( ([ "leaf":"You smell a hint of the morning dew from the leaf",
               "stem": (: stem_function :),
               "petal";"You detect a hint of pollen from the 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_smell, remove_smell, remove_smells, query_smell, query_smells

