Changing the doc.

mod/assignment/lib.php

@@ -2306,12 +2306,17 @@ function assignment_get_all_submissions($assignment, $sort="", $dir="DESC") {
     */
 }
 
-/// Given a course_module object, this function returns any
-/// "extra" information that may be needed when printing
-/// this activity in a course listing.
-///
-/// See get_array_of_activities() in course/lib.php
-///
+/**
+ * Add a get_coursemodule_info function in case any assignment type wants to add 'extra' information
+ * for the course (see resource).
+ *
+ * Given a course_module object, this function returns any "extra" information that may be needed 
+ * when printing this activity in a course listing.  See get_array_of_activities() in course/lib.php.
+ * 
+ * @param $coursemodule object The coursemodule object (record).
+ * @return object An object on information that the coures will know about (most noticeably, an icon).
+ * 
+ */
 function assignment_get_coursemodule_info($coursemodule) {
     global $CFG;