doc: reorganize some \pages, and fix some group names

Move \pages having to do with the API usage to the API section.
Better group names for some groups.

src/pipewire/extensions/session-manager/impl-interfaces.h

@@ -36,12 +36,8 @@
 extern "C" {
 #endif
 
-/** \defgroup pw_session_manager_impl Implementation
- *
- */
-
 /**
- * \addtogroup pw_session_manager_impl
+ * \addtogroup pw_session_manager
  * \{
  */
 

src/pipewire/filter.h

@@ -29,7 +29,7 @@
 extern "C" {
 #endif
 
-/** \defgroup pw_filter Filter API
+/** \defgroup pw_filter Filter
  *
  * \brief PipeWire filter object class
  *

src/pipewire/impl-client.h

@@ -31,9 +31,9 @@ extern "C" {
 
 #include <spa/utils/hook.h>
 
-/** \page page_client Client Implementation
+/** \page page_client_impl Client Implementation
  *
- * \section sec_page_client_overview Overview
+ * \section sec_page_client_impl_overview Overview
  *
  * The \ref pw_impl_client object is created by a protocol implementation when
  * a new client connects.
@@ -41,19 +41,19 @@ extern "C" {
  * The client is used to keep track of all resources belonging to one
  * connection with the PipeWire server.
  *
- * \section sec_page_client_credentials Credentials
+ * \section sec_page_client_impl_credentials Credentials
  *
  * The client object will have its credentials filled in by the protocol.
  * This information is used to check if a resource or action is available
  * for this client.
  *
- * \section sec_page_client_types Types
+ * \section sec_page_client_impl_types Types
  *
  * The client and server maintain a mapping between the client and server
  * types. All type ids that are in messages exchanged between the client
  * and server will automatically be remapped.
  *
- * \section sec_page_client_resources Resources
+ * \section sec_page_client_impl_resources Resources
  *
  * When a client binds to context global object, a resource is made for this
  * binding and a unique id is assigned to the resources. The client and
@@ -70,6 +70,8 @@ extern "C" {
  *
  * Each client has its own list of resources it is bound to along with
  * a mapping between the client types and server types.
+ *
+ * See: \ref page_client_impl
  */
 
 /**

src/pipewire/pipewire.h

@@ -60,7 +60,7 @@ extern "C" {
 #include <pipewire/utils.h>
 #include <pipewire/version.h>
 
-/** \defgroup pw_pipewire Initialization etc.
+/** \defgroup pw_pipewire Initialization
  */
 
 /**

src/pipewire/stream.h

@@ -29,13 +29,13 @@
 extern "C" {
 #endif
 
-/** \page page_streams Media Streams
+/** \page page_streams Streams
  *
  * \section sec_overview Overview
  *
- * Media streams are used to exchange data with the PipeWire server. A
- * stream is a wrapper around a proxy for a pw_client_node with
- * an adapter. This means the stream will automatically do conversion
+ * \ref pw_stream "Streams" are used to exchange data with the
+ * PipeWire server. A stream is a wrapper around a proxy for a pw_client_node
+ * with an adapter. This means the stream will automatically do conversion
  * to the type required by the server.
  *
  * Streams can be used to:
@@ -144,7 +144,7 @@ extern "C" {
  *
  * Use \ref pw_stream_disconnect() to disconnect a stream after use.
  */
-/** \defgroup pw_stream Stream API
+/** \defgroup pw_stream Stream
  *
  * \brief PipeWire stream objects
  *