]> Kevux Git Server - controller/commitdiff
Cleanup: Documentation comments for program signal handlers. 0.7.2
authorKevin Day <Kevin@kevux.org>
Tue, 1 Jul 2025 02:51:33 +0000 (21:51 -0500)
committerKevin Day <Kevin@kevux.org>
Tue, 1 Jul 2025 02:51:33 +0000 (21:51 -0500)
The function references and "must not be NULL" messages are missing.

sources/c/program/controller/main/signal.h

index 1c029ab192bb2b463cf95605d2427b673a3c5eab..d310a104ff58bc829dc885f3a66af768186d69b0 100644 (file)
@@ -33,15 +33,16 @@ extern "C" {
  * @param main
  *   The main program and settings data.
  *
+ *   Must not be NULL.
+ *
  *   This alters main.program.signal_received, setting it to a received signal.
+ *   This alters main.program.signal_status.
  *
- *   This alters main.setting.state.status:
- *     Errors (with error bit) from: f_signal_open()
- *     Errors (with error bit) from: f_signal_wait()
+ *   This does not alter main.setting.state.status.
  *
- * @see f_signal_close()
- * @see f_signal_open()
- * @see f_signal_wait()
+ * @see f_signal_set_add()
+ * @see f_signal_set_empty()
+ * @see fll_program_standard_signal_received_wait()
  */
 #if !defined(_di_controller_signal_handler_) && !defined(_di_thread_support_)
   extern void controller_signal_handler(controller_t * const main);