hwdep: fulfill documentation for ALSAHwdep

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

diff --git a/doc/reference/hwdep/alsahwdep-docs.xml b/doc/reference/hwdep/alsahwdep-docs.xml
index ea2d16739c95eeefcc3ef5153b3a1c1224802e40..7de0ce7f57511f0b078ef6ab8ce0c2d5cb3f1e56 100644 (file)
--- a/doc/reference/hwdep/alsahwdep-docs.xml
+++ b/doc/reference/hwdep/alsahwdep-docs.xml
@@ -12,6 +12,16 @@
     </releaseinfo>
     </bookinfo>
 
+    <chapter id="introduction">
+        <title></title>
+        <param>This library is designed for applications to manipulate ALSA
+        hwdep character device and retrieve common information of hardware
+        dependent functionality abstracted as hwdep device. As the design
+        concept means; hardware dependent, this library has no further
+        functionality. Each applications should implement it by their own.
+        </param>
+    </chapter>
+
     <chapter id="alsahwdep-enumerations">
         <title>ALSAHwdep enumerations</title>
         <xi:include href="xml/alsahwdep-enum-types.xml"/>

diff --git a/src/hwdep/device-info.c b/src/hwdep/device-info.c
index 44ff77e8a235bce9eaa5ab0594ba1cde35c181f9..cbe019f603b05eb8980c243be02b7fe772ac6101 100644 (file)
--- a/src/hwdep/device-info.c
+++ b/src/hwdep/device-info.c
@@ -1,6 +1,18 @@
 // SPDX-License-Identifier: LGPL-3.0-or-later
 #include "privates.h"
 
+/**
+ * SECTION: device-info
+ * @Title: ALSAHwdepDeviceInfo
+ * @Short_description: A GObject-derived object to represent information of
+ *                     ALSA hwdep device.
+ *
+ * A #ALSAHwdepDeviceInfo is a GObject-derived object to represent information
+ * of ALSA hwdep device. The call of alsahwdep_get_device_info() returns an
+ * instance of the object.
+ *
+ * The object wraps 'struct snd_hwdep_info' in UAPI of Linux sound subsystem.
+ */
 struct _ALSAHwdepDeviceInfoPrivate {
     struct snd_hwdep_info info;
 };

diff --git a/src/hwdep/query.c b/src/hwdep/query.c
index 5f92f0fa1ad7d6a281ad5ae770a1c85e9a1948ab..5a615b1aa9ad4218a412e6be8b256ef02c140448 100644 (file)
--- a/src/hwdep/query.c
+++ b/src/hwdep/query.c
@@ -12,6 +12,13 @@
 
 #include <libudev.h>
 
+/**
+ * SECTION: query
+ * @Title: Global functions in ALSAHwdep
+ * @Short_description: Global functions available without holding any file
+ *                     descriptor
+ */
+
 // For error handling.
 G_DEFINE_QUARK("alsahwdep-error", alsahwdep_error)