This is an automated email from the ASF dual-hosted git repository.

janc pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/mynewt-core.git

commit 0b2a79cb35f30530123ce054c25a4ca019bbef94
Author: Wojciech Pietraszewski <wojciech.pietraszew...@codecoup.pl>
AuthorDate: Thu Jun 27 16:20:30 2024 +0200

    kernel/os_callout: Remove doxygen comments from the source file
    
    Moves documentation entries to the header file.
---
 kernel/os/include/os/os_callout.h | 15 +++++++++++++++
 kernel/os/src/os_callout.c        | 14 --------------
 2 files changed, 15 insertions(+), 14 deletions(-)

diff --git a/kernel/os/include/os/os_callout.h 
b/kernel/os/include/os/os_callout.h
index 2002de734..cd65a75ff 100644
--- a/kernel/os/include/os/os_callout.h
+++ b/kernel/os/include/os/os_callout.h
@@ -128,7 +128,22 @@ os_callout_queued(struct os_callout *c)
  * @cond INTERNAL_HIDDEN
  */
 
+/**
+ * This function is called by the OS in the time tick. It searches the list
+ * of callouts, and sees if any of them are ready to run. If they are ready
+ * to run, it posts an event for each callout that's ready to run,
+ * to the event queue provided to os_callout_init().
+ */
 void os_callout_tick(void);
+
+/**
+ * Returns the number of ticks to the first pending callout. If there are no
+ * pending callouts then return OS_TIMEOUT_NEVER instead.
+ *
+ * @param now               The time now
+ *
+ * @return                  Number of ticks to first pending callout
+ */
 os_time_t os_callout_wakeup_ticks(os_time_t now);
 
 /**
diff --git a/kernel/os/src/os_callout.c b/kernel/os/src/os_callout.c
index 0526a4c91..18d4db6f7 100644
--- a/kernel/os/src/os_callout.c
+++ b/kernel/os/src/os_callout.c
@@ -114,12 +114,6 @@ err:
 }
 
 
-/**
- * This function is called by the OS in the time tick.  It searches the list
- * of callouts, and sees if any of them are ready to run.  If they are ready
- * to run, it posts an event for each callout that's ready to run,
- * to the event queue provided to os_callout_init().
- */
 void
 os_callout_tick(void)
 {
@@ -158,14 +152,6 @@ os_callout_tick(void)
     os_trace_api_ret(OS_TRACE_ID_CALLOUT_TICK);
 }
 
-/*
- * Returns the number of ticks to the first pending callout. If there are no
- * pending callouts then return OS_TIMEOUT_NEVER instead.
- *
- * @param now The time now
- *
- * @return Number of ticks to first pending callout
- */
 os_time_t
 os_callout_wakeup_ticks(os_time_t now)
 {

Reply via email to