docs: добавь поясняющие комментарии к модулям и инструментам

2026-10-02 16:45:50 +03:00
parent 6cbce6c360
commit 427fc70100
488 changed files with 2877 additions and 1 deletions
--- a/c/gas-logger/ports/c28x/gas_logger_c28x.c
+++ b/c/gas-logger/ports/c28x/gas_logger_c28x.c
@@ -1,3 +1,9 @@
+/*
+ * Критические секции регистратора для TI C28x. При входе сохраняется прежнее состояние
+ * прерываний, при выходе восстанавливается именно оно: безусловное разрешение нарушило бы
+ * вложенную критическую секцию.
+ */
+
 #include "gas_logger_c28x.h"
 /* __disable_interrupts/__restore_interrupts are TI C28x compiler intrinsics. */
 uint32_t gl_c28x_enter(void *user) { (void)user; return __disable_interrupts(); }
--- a/c/gas-logger/ports/c28x/gas_logger_c28x.h
+++ b/c/gas-logger/ports/c28x/gas_logger_c28x.h
@@ -1,3 +1,9 @@
+/*
+ * Критические секции регистратора для TI C28x. При входе сохраняется прежнее состояние
+ * прерываний, при выходе восстанавливается именно оно: безусловное разрешение нарушило бы
+ * вложенную критическую секцию.
+ */
+
 #ifndef GAS_LOGGER_C28X_H
 #define GAS_LOGGER_C28X_H
 #include <stdint.h>