 		
 		// -- Basic Operations: Contains, Add, Remove, Clear ------------------
 		
+		/**
+		 * Indicates if the given object is contained in this list.
+		 * @param o the object to check for containment
+		 * @return true if the list contains the object, false otherwise.
+		 */
 		public function contains(o:Object):Boolean
 		{
 			return (_map[o] != undefined);
 		}
 		
+		/**
+		 * Internal method for adding an object to the list. This method should
+		 * be used by the Data class only.
+		 * @param o the object to add
+		 * @return the added object
+		 * @private
+		 */
 		internal function add(o:Object):Object
 		{
 			_map[o] = _list.length;

			return o;
		}
		
		internal function clear():void
		{
			_map = new Dictionary();

	import flare.util.Sort;
	import flare.util.Sort;

	/**
	 * A list of nodes or edges maintained by a Data instance.
	 */
	public class DataList extends Proxy
	{
		/** Hashed set of items in the data list. */
		private var _map:Dictionary = new Dictionary();
		/** Array of items in the data set. */
		private var _list:Array = [];
		/** Default property values to be applied to new items. */
		private var _defs:Object = null;
		/** Cache of Stats objects for item properties. */
		private var _stats:Object = {};
		/** The underlying array storing the list. */
		internal function get list():Array { return _list; }
		
