doc: add brief explanations for all groups

src/pipewire/buffers.h

@@ -35,6 +35,7 @@ extern "C" {
 #endif
 
 /** \defgroup pw_buffers Buffers
+ * Buffer handling
  */
 
 /**

src/pipewire/client.h

@@ -36,7 +36,7 @@ extern "C" {
 #include <pipewire/permission.h>
 
 /** \defgroup pw_client Client
- *
+ * Client interface
  */
 
 /**

src/pipewire/conf.h

@@ -25,7 +25,7 @@
 #include <pipewire/context.h>
 
 /** \defgroup pw_conf Configuration
- *
+ * Loading/saving properties from/to configuration files.
  */
 
 /**

src/pipewire/device.h

@@ -35,7 +35,7 @@ extern "C" {
 #include <pipewire/proxy.h>
 
 /** \defgroup pw_device Device
- *
+ * Device interface
  */
 
 /**

src/pipewire/extensions/client-node.h

@@ -33,7 +33,7 @@ extern "C" {
 #include <spa/param/param.h>
 
 /** \defgroup pw_client_node Client Node
- *
+ * Client node interface
  */
 
 /**

src/pipewire/extensions/metadata.h

@@ -32,7 +32,7 @@ extern "C" {
 #include <spa/utils/defs.h>
 
 /** \defgroup pw_metadata Metadata
- *
+ * Metadata interface
  */
 
 /**

src/pipewire/extensions/profiler.h

@@ -32,7 +32,7 @@ extern "C" {
 #include <spa/utils/defs.h>
 
 /** \defgroup pw_profiler Profiler
- *
+ * Profiler interface
  */
 
 /**

src/pipewire/extensions/protocol-native.h

@@ -35,7 +35,7 @@ extern "C" {
 #include <pipewire/resource.h>
 
 /** \defgroup pw_protocol_native Native Protocol
- *
+ * PipeWire native protocol interface
  */
 
 /**

src/pipewire/extensions/session-manager.h

@@ -27,7 +27,7 @@
 #define PIPEWIRE_EXT_SESSION_MANAGER_H
 
 /** \defgroup pw_session_manager Session Manager
- *
+ * Session manager interface
  */
 
 /**

src/pipewire/factory.h

@@ -38,7 +38,7 @@ extern "C" {
 #include <pipewire/proxy.h>
 
 /** \defgroup pw_factory Factory
- *
+ * Factory interface
  */
 
 /**

src/pipewire/i18n.h

@@ -30,7 +30,7 @@ extern "C" {
 #endif
 
 /** \defgroup pw_gettext Internationalization
- *
+ * Gettext interface
  */
 
 /**

src/pipewire/mem.h

@@ -32,7 +32,7 @@ extern "C" {
 #endif
 
 /** \defgroup pw_memblock Memory Blocks
- *
+ * Memory allocation and pools.
  */
 
 /**

src/pipewire/module.h

@@ -35,7 +35,7 @@ extern "C" {
 #include <pipewire/proxy.h>
 
 /** \defgroup pw_module Module
- *
+ * Module interface
  */
 
 /**

src/pipewire/node.h

@@ -40,7 +40,7 @@ extern "C" {
 #include <pipewire/proxy.h>
 
 /** \defgroup pw_node Node
- *
+ * Node interface
  */
 
 /**

src/pipewire/pipewire.h

@@ -61,6 +61,7 @@ extern "C" {
 #include <pipewire/version.h>
 
 /** \defgroup pw_pipewire Initialization
+ * Initializing PipeWire and loading SPA modules.
  */
 
 /**

src/pipewire/port.h

@@ -39,7 +39,7 @@ extern "C" {
 #include <pipewire/proxy.h>
 
 /** \defgroup pw_port Port
- *
+ * Port interface
  */
 
 /**

src/pipewire/type.h

@@ -31,7 +31,8 @@ extern "C" {
 
 #include <spa/utils/type.h>
 
-/** \defgroup pw_type Type
+/** \defgroup pw_type Type info
+ * Type information
  */
 
 /**

src/pipewire/work-queue.h

@@ -30,6 +30,7 @@ extern "C" {
 #endif
 
 /** \defgroup pw_work_queue Work Queue
+ * Queued processing of work items.
  */
 
 /**