MDL-41395 improved phpdoc's for coursecatlib.php