renamed RTC_IRQ_SECOND to more generic RTC_IRQ_PERIODIC and added [in|out] to doxygen @param statements