rewrite comments into one, unified style

code/kernel/hal/hal_rtc.c

@@ -1,4 +1,5 @@
-// hal_rtc.c - legacy CMOS RTC fallback clock
+// HAL RTC support. This file reads the CMOS clock as the fallback wall-clock source.
+
 #include <stdint.h>
 #include <stdbool.h>
 #include <string.h>
@@ -22,19 +23,23 @@
 
 static uint8_t gCenturyRegister;
 
+// Implements the rtc Read operation.
 static uint8_t RtcRead(uint8_t reg) {
     __outbyte(CMOS_INDEX_PORT, (uint8_t)(reg | 0x80u)); // keep NMI masked while selecting.
     return __inbyte(CMOS_DATA_PORT);
 }
 
+// Implements the rtc Update In Progress operation.
 static bool RtcUpdateInProgress(void) {
     return (RtcRead(RTC_REG_STATUS_A) & 0x80u) != 0;
 }
 
+// Implements the rtc Bcd To Binary operation.
 static uint8_t RtcBcdToBinary(uint8_t value) {
     return (uint8_t)(((value >> 4) * 10u) + (value & 0x0Fu));
 }
 
+// Implements the rtc Read Stable operation.
 static bool RtcReadStable(HAL_RTC_TIME* out) {
     if (!out) return false;
 
@@ -111,10 +116,12 @@ static bool RtcReadStable(HAL_RTC_TIME* out) {
     return true;
 }
 
+// Implements the rtc Leap Year operation.
 static bool RtcLeapYear(uint16_t year) {
     return ((year % 4u) == 0u && (year % 100u) != 0u) || ((year % 400u) == 0u);
 }
 
+// Implements the rtc Days In Month operation.
 static uint8_t RtcDaysInMonth(uint16_t year, uint8_t month) {
     static const uint8_t days[12] = { 31,28,31,30,31,30,31,31,30,31,30,31 };
     if (month < 1u || month > 12u) return 0;
@@ -122,6 +129,7 @@ static uint8_t RtcDaysInMonth(uint16_t year, uint8_t month) {
     return days[month - 1u];
 }
 
+// Implements the rtc Valid operation.
 static bool RtcValid(const HAL_RTC_TIME* t) {
     if (!t) return false;
     if (t->Year < 1970u || t->Year > 9999u) return false;
@@ -132,6 +140,7 @@ static bool RtcValid(const HAL_RTC_TIME* t) {
     return true;
 }
 
+// Implements the rtc Query Time operation.
 static KSTATUS HalRtcQueryTime(HAL_RTC_TIME* outTime) {
     if (!outTime) return STATUS_INVALID_PARAMETER;
 
@@ -144,10 +153,12 @@ static KSTATUS HalRtcQueryTime(HAL_RTC_TIME* outTime) {
     return STATUS_SUCCESS;
 }
 
+// Implements the rtc Set Century Register operation.
 void HalRtcSetCenturyRegister(uint8_t centuryRegister) {
     gCenturyRegister = centuryRegister;
 }
 
+// Implements the rtc Initialize operation.
 void HalRtcInitialize(HAL_RTC* out) {
     if (!out) return;
     out->QueryTime = HalRtcQueryTime;