docs: Move some driver entities into @addtogroup and other NFC

doc/example_configs/config_v0.schema.json

@@ -77,7 +77,7 @@
                 },
                 "calibration_path": {
                     "type": "string"
-                },
+                }
             }
         },
         "tracking_overrides": {

src/xrt/auxiliary/tracking/t_calibration.cpp

@@ -635,7 +635,6 @@ process_stereo_samples(class Calibration &c, int cols, int rows)
 	c.state.view[1].map2 = maps.view[1].rectify.remap_y;
 	c.state.view[1].maps_valid = true;
 
-	// clang-format off
 	std::cout << "#####\n";
 	std::cout << "calibration rp_error: " << rp_error << "\n";
 	to_stdout("camera_rotation", wrapped.camera_rotation_mat);
@@ -663,7 +662,6 @@ process_stereo_samples(class Calibration &c, int cols, int rows)
 	to_stdout("view[1].intrinsics", wrapped.view[1].intrinsics_mat);
 	to_stdout("view[1].projection", maps.view[1].projection_mat);
 	to_stdout("view[1].rotation", maps.view[1].rotation_mat);
-	// clang-format on
 
 	// Validate that nothing has been re-allocated.
 	assert(wrapped.isDataStorageValid());

src/xrt/drivers/euroc/euroc_driver.h

@@ -12,6 +12,11 @@
 #include "euroc_interface.h"
 #include <assert.h>
 
+/*!
+ * @addtogroup drv_euroc
+ * @{
+ */
+
 #define EUROC_TRACE(e, ...) U_LOG_IFL_T(e->ll, __VA_ARGS__)
 #define EUROC_DEBUG(e, ...) U_LOG_IFL_D(e->ll, __VA_ARGS__)
 #define EUROC_INFO(e, ...) U_LOG_IFL_I(e->ll, __VA_ARGS__)
@@ -32,11 +37,6 @@
 extern "C" {
 #endif
 
-/*!
- * @addtogroup drv_euroc
- * @{
- */
-
 DEBUG_GET_ONCE_LOG_OPTION(euroc_log, "EUROC_LOG", U_LOGGING_WARN)
 DEBUG_GET_ONCE_OPTION(euroc_path, "EUROC_PATH", NULL)
 

src/xrt/drivers/qwerty/qwerty_device.h

@@ -11,6 +11,11 @@
 #include "util/u_logging.h"
 #include "xrt/xrt_device.h"
 
+/*!
+ * @addtogroup drv_qwerty
+ * @{
+ */
+
 #define QWERTY_HMD_STR "Qwerty HMD"
 #define QWERTY_HMD_TRACKER_STR QWERTY_HMD_STR " Tracker"
 #define QWERTY_LEFT_STR "Qwerty Left Controller"
@@ -22,11 +27,6 @@
 extern "C" {
 #endif
 
-/*!
- * @addtogroup drv_qwerty
- * @{
- */
-
 /*!
  * @brief Container of qwerty devices and driver properties.
  * @see qwerty_hmd, qwerty_controller

src/xrt/drivers/realsense/rs_driver.h

@@ -15,15 +15,15 @@
 #include <librealsense2/rs.h>
 #include <librealsense2/h/rs_pipeline.h>
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
 /*!
  * @addtogroup drv_rs
  * @{
  */
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 //! Container to store and manage useful objects from the RealSense API
 struct rs_container
 {