MDL-30983 calendar: updated phpdocs for calendar/lib.php