(svn r26734) -Fix-ish: make clear the AI/GS List's Begin and Next return the item, not the value

src/script/api/script_list.hpp

@@ -84,15 +84,15 @@ public:
 	bool HasItem(int32 item);
 
 	/**
-	 * Go to the beginning of the list.
+	 * Go to the beginning of the list and return the item. To get the value use list.GetValue(list.Begin()).
-	 * @return the item value of the first item.
+	 * @return the first item.
 	 * @note returns 0 if beyond end-of-list. Use IsEnd() to check for end-of-list.
 	 */
 	int32 Begin();
 
 	/**
-	 * Go to the next item in the list.
+	 * Go to the next item in the list and return the item. To get the value use list.GetValue(list.Next()).
-	 * @return the item value of the next item.
+	 * @return the next item.
 	 * @note returns 0 if beyond end-of-list. Use IsEnd() to check for end-of-list.
 	 */
 	int32 Next();