d/*: Add a bit of documentation organization

src/xrt/drivers/hdk/hdk_device.cpp

@@ -11,6 +11,7 @@
  *
  * @author Ryan Pavlik <ryan.pavlik@collabora.com>
  * @author Kevin M. Godby <kevin@godby.org>
+ * @ingroup drv_hdk
  */
 
 

src/xrt/drivers/hdk/hdk_device.h

@@ -5,6 +5,7 @@
  * @brief  Interface to direct OSVR HDK driver code.
  * @author Jakob Bornecrantz <jakob@collabora.com>
  * @author Ryan Pavlik <ryan.pavlik@collabora.com>
+ * @ingroup drv_hdk
  */
 
 #pragma once

src/xrt/drivers/hdk/hdk_interface.h

@@ -5,6 +5,7 @@
  * @brief  Interface to direct OSVR HDK driver code.
  * @author Jakob Bornecrantz <jakob@collabora.com>
  * @author Ryan Pavlik <ryan.pavlik@collabora.com>
+ * @ingroup drv_hdk
  */
 
 #pragma once
@@ -14,9 +15,27 @@ extern "C" {
 #endif
 
 
+/*!
+ * @defgroup drv_hdk HDK Driver
+ * @ingroup drv
+ *
+ * @brief Driver for the HDK HMD.
+ */
+
+/*!
+ * Probe for HDKs.
+ *
+ * @ingroup drv_hdk
+ */
 struct xrt_prober*
 hdk_create_prober();
 
+/*!
+ * @dir drivers/hdk
+ *
+ * @brief @ref drv_hdk files.
+ */
+
 
 #ifdef __cplusplus
 }

src/xrt/drivers/hdk/hdk_prober.c

@@ -5,6 +5,7 @@
  * @brief  OSVR HDK prober code.
  * @author Jakob Bornecrantz <jakob@collabora.com>
  * @author Ryan Pavlik <ryan.pavlik@collabora.com>
+ * @ingroup drv_hdk
  */
 
 #include <stdio.h>

src/xrt/drivers/ohmd/oh_device.c

@@ -4,6 +4,7 @@
  * @file
  * @brief  Adaptor to a OpenHMD device.
  * @author Jakob Bornecrantz <jakob@collabora.com>
+ * @ingroup drv_ohmd
  */
 
 

src/xrt/drivers/ohmd/oh_device.h

@@ -4,6 +4,7 @@
  * @file
  * @brief  Interface to OpenHMD driver code.
  * @author Jakob Bornecrantz <jakob@collabora.com>
+ * @ingroup drv_ohmd
  */
 
 #pragma once

src/xrt/drivers/ohmd/oh_interface.h

@@ -4,6 +4,7 @@
  * @file
  * @brief  Interface to OpenHMD driver code.
  * @author Jakob Bornecrantz <jakob@collabora.com>
+ * @ingroup drv_ohmd
  */
 
 #pragma once
@@ -12,10 +13,27 @@
 extern "C" {
 #endif
 
+/*!
+ * @defgroup drv_ohmd OpenHMD wrapper
+ * @ingroup drv
+ *
+ * @brief Wrapper driver around OpenHMD.
+ */
 
+/*!
+ * Create a proble for OpenHMD supported devices.
+ *
+ * @ingroup drv_ohmd
+ */
 struct xrt_prober*
 oh_create_prober();
 
+/*!
+ * @dir drivers/ohmd
+ *
+ * @brief @ref drv_ohmd files.
+ */
+
 
 #ifdef __cplusplus
 }

src/xrt/drivers/ohmd/oh_prober.c

@@ -4,6 +4,7 @@
  * @file
  * @brief  OpenHMD prober code.
  * @author Jakob Bornecrantz <jakob@collabora.com>
+ * @ingroup drv_ohmd
  */
 
 #include <stdio.h>

src/xrt/include/xrt/xrt_documentation.h

@@ -29,6 +29,13 @@
  * @brief The main interface shared between the different components of Monado.
  */
 
+/*!
+ * @defgroup drv Drivers
+ * @ingroup xrt
+ *
+ * @brief Native and wrapper drivers in Monado.
+ */
+
 /*!
  * @dir include
  * @ingroup xrt
@@ -56,3 +63,10 @@
  *
  * @brief @ref oxr files.
  */
+
+/*!
+ * @dir drivers
+ * @ingroup xrt
+ *
+ * @brief @ref drv files.
+ */