include: drivers: input: add @file tag to analog_axis headers

This helps anchoring the file to the proper section in the online
documentation when browsing by file.

Signed-off-by: Benjamin Cabé <[email protected]>

Author: kartben

include/zephyr/input/input_analog_axis.h

@@ -4,24 +4,29 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @file
+ * @ingroup input_analog_axis
+ * @brief Main header file for interacting with analog axis input devices.
+ */
+
 #ifndef ZEPHYR_INCLUDE_INPUT_ANALOG_AXIS_H_
 #define ZEPHYR_INCLUDE_INPUT_ANALOG_AXIS_H_
 
 #include <stdint.h>
 #include <zephyr/device.h>
 
 /**
- * @brief Analog axis API
- * @defgroup input_analog_axis Analog axis API
- * @ingroup io_interfaces
+ * @defgroup input_analog_axis Analog axis
+ * @ingroup input_interface
  * @{
  */
 
 /**
  * @brief Analog axis calibration data structure.
  *
  * Holds the calibration data for a single analog axis. Initial values are set
- * from the devicetree and can be changed by the applicatoin in runtime using
+ * from the devicetree and can be changed by the application in runtime using
  * @ref analog_axis_calibration_set and @ref analog_axis_calibration_get.
  */
 struct analog_axis_calibration {
@@ -51,13 +56,14 @@ typedef void (*analog_axis_raw_data_t)(const struct device *dev,
  * calibration. Set cb to NULL to disable the callback.
  *
  * @param dev Analog axis device.
- * @param cb An analog_axis_raw_data_t callback to use, NULL disable.
+ * @param cb An analog_axis_raw_data_t callback to use, NULL to disable.
  */
 void analog_axis_set_raw_data_cb(const struct device *dev, analog_axis_raw_data_t cb);
 
 /**
  * @brief Get the number of defined axes.
  *
+ * @param dev Analog axis device.
  * @retval n The number of defined axes for dev.
  */
 int analog_axis_num_axes(const struct device *dev);

include/zephyr/input/input_analog_axis_settings.h

@@ -4,6 +4,12 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @file
+ * @brief Public header file for API allowing to save analog axis calibration data.
+ * @ingroup input_analog_axis
+ */
+
 #ifndef ZEPHYR_INCLUDE_INPUT_ANALOG_AXIS_SETTINGS_H_
 #define ZEPHYR_INCLUDE_INPUT_ANALOG_AXIS_SETTINGS_H_
 
@@ -18,7 +24,7 @@
 /**
  * @brief Save the calibration data.
  *
- * Save the calibration data permanently on the specifided device, requires
+ * Save the calibration data permanently on the specified device, requires
  * the @ref settings subsystem to be configured and initialized.
  *
  * @param dev Analog axis device.