MDL-18375 calendar: PHPDoc tidy up