From 24b171735d5c28b88dacb8e45d4d4bb8b45f4863 Mon Sep 17 00:00:00 2001
From: Thibault Saunier <tsaunier@igalia.com>
Date: Mon, 15 Aug 2022 21:25:25 -0400
Subject: [PATCH] webrtc: Fix documentaton moving symbols in the right pages

As those symbols are documented in a 'fwd' header smart indexing in
hotdoc wasn't working.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2891>
---
 subprojects/gst-plugins-bad/gst-libs/gst/webrtc/datachannel.c    | 2 ++
 subprojects/gst-plugins-bad/gst-libs/gst/webrtc/dtlstransport.c  | 2 ++
 subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.c            | 7 +++++++
 subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icestream.c      | 7 +++++++
 subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icetransport.c   | 4 +++-
 subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpreceiver.c    | 2 ++
 subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpsender.c      | 2 ++
 subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtptransceiver.c | 2 ++
 8 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/datachannel.c b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/datachannel.c
index 6ba1905..e8a141f 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/datachannel.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/datachannel.c
@@ -22,6 +22,8 @@
  * SECTION:gstwebrtc-datachannel
  * @short_description: RTCDataChannel object
  * @title: GstWebRTCDataChannel
+ * @symbols:
+ * - GstWebRTCDataChannel
  *
  * <https://www.w3.org/TR/webrtc/#rtcdatachannel>
  *
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/dtlstransport.c b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/dtlstransport.c
index e3d54a0..bd1a553 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/dtlstransport.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/dtlstransport.c
@@ -22,6 +22,8 @@
  * @short_description: RTCDtlsTransport object
  * @title: GstWebRTCDTLSTransport
  * @see_also: #GstWebRTCRTPSender, #GstWebRTCRTPReceiver, #GstWebRTCICETransport
+ * @symbols:
+ * - GstWebRTCDTLSTransport
  *
  * <https://www.w3.org/TR/webrtc/#rtcdtlstransport>
  */
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.c b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.c
index 596ef0f..829f2e3 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.c
@@ -16,6 +16,13 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
+/**
+ * SECTION:gstwebrtcice
+ * @title: GstWebRTCICE
+ * @short_description: Base class WebRTC ICE handling
+ * @symbols:
+ * - GstWebRTCICE
+ */
 
 #ifdef HAVE_CONFIG_H
 # include "config.h"
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icestream.c b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icestream.c
index 8acd637..4d0055f 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icestream.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icestream.c
@@ -16,6 +16,13 @@
  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
+/**
+ * SECTION: icestream
+ * @short_description: IceStream object
+ * @title: GstIceStream
+ * @symbols:
+ * - GstWebRTCICEStream
+ */
 
 #ifdef HAVE_CONFIG_H
 # include "config.h"
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icetransport.c b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icetransport.c
index da5a643..0ad9914 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icetransport.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/icetransport.c
@@ -22,8 +22,10 @@
  * @short_description: RTCIceTransport object
  * @title: GstWebRTCICETransport
  * @see_also: #GstWebRTCRTPSender, #GstWebRTCRTPReceiver, #GstWebRTCDTLSTransport
+ * @symbols:
+ * - GstWebRTCICETransport
  *
- * <https://www.w3.org/TR/webrtc/#rtcicetransport>
+ * See the [specification](https://www.w3.org/TR/webrtc/#rtcicetransport)
  */
 
 #ifdef HAVE_CONFIG_H
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpreceiver.c b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpreceiver.c
index 8330105..4a397ff 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpreceiver.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpreceiver.c
@@ -22,6 +22,8 @@
  * @short_description: RTCRtpReceiver object
  * @title: GstWebRTCRTPReceiver
  * @see_also: #GstWebRTCRTPSender, #GstWebRTCRTPTransceiver
+ * @symbols:
+ * - GstWebRTCRTPReceiver
  *
  * <https://www.w3.org/TR/webrtc/#rtcrtpreceiver-interface>
  */
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpsender.c b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpsender.c
index 90f43cc..2a3a969 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpsender.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtpsender.c
@@ -22,6 +22,8 @@
  * @short_description: RTCRtpSender object
  * @title: GstWebRTCRTPSender
  * @see_also: #GstWebRTCRTPReceiver, #GstWebRTCRTPTransceiver
+ * @symbols:
+ * - GstWebRTCRTPSender
  *
  * <https://www.w3.org/TR/webrtc/#rtcrtpsender-interface>
  */
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtptransceiver.c b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtptransceiver.c
index 8990206..2db2abd 100644
--- a/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtptransceiver.c
+++ b/subprojects/gst-plugins-bad/gst-libs/gst/webrtc/rtptransceiver.c
@@ -22,6 +22,8 @@
  * @short_description: RTCRtpTransceiver object
  * @title: GstWebRTCRTPTransceiver
  * @see_also: #GstWebRTCRTPSender, #GstWebRTCRTPReceiver
+ * @symbols:
+ * - GstWebRTCRTPTransceiver
  *
  * <https://www.w3.org/TR/webrtc/#rtcrtptransceiver-interface>
  */
-- 
2.7.4