[cadcdev-svn-commits] [SCM] branch master updated. 77d9e22dafdf4c1210f06d6676b740e6ff34bda4

[kosmirror <kos...@us...>]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "A pseudo Operating System for the Dreamcast.".

The branch, master has been updated
       via  77d9e22dafdf4c1210f06d6676b740e6ff34bda4 (commit)
      from  9525f1ed451487c3a11fb530269886d265a77840 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 77d9e22dafdf4c1210f06d6676b740e6ff34bda4
Author: QuzarDC <qu...@co...>
Date:   Wed Jun 25 05:13:04 2025 -0400

    Fixes for doxygen warnings
    
    pthread.h - endcond was inside the header ifdef guards and cond was
     on the outside, so doxygen couldn't see them both.
    
    vmu.h - wrong ref name was being used for bfont icons.
    
    keyboard.h - There may be a better fix for this, but it seems that
     doxygen is choking on the depr inside a union.

-----------------------------------------------------------------------

Summary of changes:
 include/pthread.h                                 |  4 ++--
 kernel/arch/dreamcast/include/dc/maple/keyboard.h | 10 ++++++----
 kernel/arch/dreamcast/include/dc/maple/vmu.h      |  8 ++++----
 3 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/include/pthread.h b/include/pthread.h
index e5b0da88..44c9359b 100644
--- a/include/pthread.h
+++ b/include/pthread.h
@@ -27,11 +27,11 @@
     \author Lawrence Sebald
 */
 
-/** \cond **/
-
 #ifndef __PTHREAD_H
 #define __PTHREAD_H
 
+/** \cond **/
+
 #include <sys/cdefs.h>
 #include <sys/features.h>
 #include <sys/_pthreadtypes.h>
diff --git a/kernel/arch/dreamcast/include/dc/maple/keyboard.h b/kernel/arch/dreamcast/include/dc/maple/keyboard.h
index aa0dbdfa..35e76676 100644
--- a/kernel/arch/dreamcast/include/dc/maple/keyboard.h
+++ b/kernel/arch/dreamcast/include/dc/maple/keyboard.h
@@ -451,16 +451,18 @@ typedef struct kbd_state {
     /** \brief  The latest raw condition of the keyboard. */
     kbd_cond_t cond;
 
-    /** \brief Current (and previous) state of all keys in kbd_keys_t */
     union {
+        /* \cond */
         uint8_t matrix[KBD_MAX_KEYS] __depr("Please see key_state_t and use key_states to access this.");
-        key_state_t key_states[KBD_MAX_KEYS];
+        /* \endcond */
+        key_state_t key_states[KBD_MAX_KEYS];   /** \brief Current (and previous) state of all keys in kbd_keys_t */
     };
 
-    /** \brief  Modifier key status. Stored to track changes. */
     union {
+        /* \cond */
         int shift_keys __depr("Please see kbd_mods_t and use last_modifiers.raw to access this.");
-        kbd_mods_t last_modifiers;
+        /* \endcond */
+        kbd_mods_t last_modifiers;  /** \brief  Modifier key status. Stored to track changes. */
     };
 
     /** \brief  Keyboard type/region. */
diff --git a/kernel/arch/dreamcast/include/dc/maple/vmu.h b/kernel/arch/dreamcast/include/dc/maple/vmu.h
index 13e412c5..30e5f510 100644
--- a/kernel/arch/dreamcast/include/dc/maple/vmu.h
+++ b/kernel/arch/dreamcast/include/dc/maple/vmu.h
@@ -189,12 +189,12 @@ int vmu_get_custom_color(maple_device_t *dev, uint8_t *red, uint8_t *green, uint
     icon by providing custom icons for both the DC BIOS menu and the VMU's LCD screen.
 
     \param  dev             The device to change the icon shape of.
-    \param  icon_shape      One of the values found in \ref vmu_icons.
+    \param  icon_shape      One of the values found in \ref bfont_vmu_icon_t.
 
     \retval 0               On success
     \retval -1              On failure
 
-    \sa vmu_icons, vmu_get_icon_shape
+    \sa bfont_vmu_icon_t, vmu_get_icon_shape
 */
 int vmu_set_icon_shape(maple_device_t *dev, uint8_t icon_shape);
 
@@ -211,12 +211,12 @@ int vmu_set_icon_shape(maple_device_t *dev, uint8_t icon_shape);
     icon by providing custom icons for both the DC BIOS menu and the VMU's LCD screen.
 
     \param  dev             The device to change the icon shape of.
-    \param  icon_shape      One of the values found in \ref vmu_icons.
+    \param  icon_shape      One of the values found in \ref bfont_vmu_icon_t.
 
     \retval 0               On success
     \retval -1              On failure
 
-    \sa vmu_icons, vmu_set_icon_shape
+    \sa bfont_vmu_icon_t, vmu_set_icon_shape
 */
 int vmu_get_icon_shape(maple_device_t *dev, uint8_t *icon_shape);
 


hooks/post-receive
-- 
A pseudo Operating System for the Dreamcast.