Some more PHPDoc:

/**
 * Get a course from the course table
 *
 * @private ?
 *
 * @param string $field
 * Possible values:
 * <ul>
 * <li>id</li>
 * <li>name</li>
 * <li>idnumber</li>
 * <li>shortname</li>
 * </ul>
 *
 * @param string $value
 *
 * @return course Return a course record
 */
function get_course($field, $value){

}

/**
 * Get some courses from the course table
 *
 * @param string $field
 * Possible values:
 * <ul>
 * <li>id</li>
 * <li>name</li>
 * <li>idnumber</li>
 * <li>shortname</li>
 * </ul>
 *
 * @param array $values
 *
 * @return array Returns an array of course records
 */
function get_courses($field,$values){
}

What is a COURSE? Course table record? Something to remove or add?

Adding URL to the course to this object would be a great idea.

This funcionality is completed in CVS.
We have commit a simpletest.

The params of this functionality has changed.
There are more information returned in this operation.