 package org.yellcorp.lib.core
 {
 /**
- * Generic utilities for manipulating mapping objects. That is, Objects
- * with dynamic properties, Dictionaries, Arrays, subclasses of
- * flash.utils.Proxy, anything containing values that can be accessed using
- * [ ].
+ * Generic utilities for manipulating mapping objects.  A mapping object is
+ * any object that contains values associated with keys, and supports the
+ * <code>[]</code> operator, <code>for&#x2026;in</code> enumeration, and
+ * <code>for&#x2026;each</code> enumeration.  This includes Objects with
+ * dynamic properties, Dictionaries, Arrays, and subclasses of
+ * flash.utils.Proxy.
  */
 public class MapUtil
 {

     *                      provided, a new <code>Object</code> is created.
     *                      The results of <code>indexingFunc</code> will
     *                      be used as keys, with the keys from
     *                      <code>map</code> becoming the value.
     * @return The map containing the index.
     */
    public static function indexKeys(map:*, indexingFunc:Function, target:* = null):*

    }

    /**
     * Copies dynamic keys and values from one map to the target map. Values
     * for source keys overwrite any identically named keys in
     * <code>target</code>.
     *
     * @param source     The map to copy.
     * @param target     The target map. If omitted, will create a new
     *                   <code>Object</code>.
     * @return           The target map.
     */
    public static function copy(source:*, target:* = null):*
