--- include/asterisk/bridge_channel_internal.h	2021-11-09 15:58:35.000000000 +0100
+++ include/asterisk/bridge_channel_internal.h	2021-11-13 10:11:41.829903788 +0100
@@ -32,4 +32,4 @@
  * See Also:
+ * \arg \ref AstBridging
  * \arg \ref AstCREDITS
- * \arg \ref Ast
  */
@@ -93,4 +93,2 @@
  * \note On entry, the orig_bridge is already locked.
- *
- * \return Nothing
  */
@@ -104,4 +102,2 @@
  * \param bridge_channel Channel that the deferred frames should be pulled from and queued to.
- *
- * \return Nothing
  */
@@ -158,4 +154,2 @@
  * \note On entry, bridge_channel->bridge is already locked.
- *
- * \return Nothing
  */
@@ -164,2 +158,3 @@
 /*!
+ * \internal
  * \brief Signal imparting threads to wake up.
@@ -168,4 +163,2 @@
  * \param chan Channel imparted that we need to signal.
- *
- * \return Nothing
  */
--- main/bridge_channel.c	2021-11-09 15:58:35.000000000 +0100
+++ main/bridge_channel.c	2021-11-13 10:20:17.641355058 +0100
@@ -115,3 +115,3 @@
 /*!
- * \brief initialize a synchronous bridge object.
+ * \brief Initialize a synchronous bridge object.
  *
@@ -416,4 +416,2 @@
  * \note Both channels are already locked.
- *
- * \return Nothing
  */
@@ -439,4 +437,2 @@
  * \note Both channels are already locked.
- *
- * \return Nothing
  */
@@ -462,4 +458,2 @@
  * \note Both channels are already locked.
- *
- * \return Nothing
  */
@@ -485,4 +479,2 @@
  * \note Both channels are already locked.
- *
- * \return Nothing
  */
@@ -507,4 +499,2 @@
  * \note Both channels are already locked.
- *
- * \return Nothing
  */
@@ -525,4 +515,2 @@
  * \note The bridge must be locked prior to calling this function.
- *
- * \return Nothing
  */
@@ -572,4 +560,2 @@
  * \note The bridge must be locked prior to calling this function.
- *
- * \return Nothing
  */
@@ -782,4 +768,2 @@
  * \note On entry, the bridge_channel->bridge is already locked.
- *
- * \return Nothing
  */
@@ -850,4 +834,2 @@
  * \note This function assumes bridge_channel->bridge is locked.
- *
- * \return Nothing
  */
@@ -871,4 +853,2 @@
  * \param bridge_channel Channel to suspend.
- *
- * \return Nothing
  */
@@ -888,4 +868,2 @@
  * \note This function assumes bridge_channel->bridge is locked.
- *
- * \return Nothing
  */
@@ -914,4 +892,2 @@
  * \param bridge_channel Channel to unsuspend.
- *
- * \return Nothing
  */
@@ -1270,4 +1246,2 @@
  * \param data Action frame data to run the application.
- *
- * \return Nothing
  */
@@ -1364,4 +1338,2 @@
  * \param payload Action frame payload to play a file.
- *
- * \return Nothing
  */
@@ -1436,4 +1408,2 @@
  * \param data Action frame data to call the callback.
- *
- * \return Nothing
  */
@@ -1566,4 +1536,2 @@
  * \param bridge_channel Channel to run expired intervals on.
- *
- * \return Nothing
  */
@@ -1879,4 +1847,2 @@
  * \param bridge_channel Channel to check expired interdigit timer on.
- *
- * \return Nothing
  */
@@ -1924,3 +1890,6 @@
 
-/*! \brief Internal function that plays back DTMF on a bridge channel */
+/*!
+ * \internal
+ * \brief Play back DTMF on a bridge channel
+ */
 static void bridge_channel_dtmf_stream(struct ast_bridge_channel *bridge_channel, const char *dtmf)
@@ -2063,4 +2032,2 @@
  * \param data data from the action.
- *
- * \return Nothing
  */
@@ -2132,4 +2099,2 @@
  * \note On entry, bridge_channel->bridge is already locked.
- *
- * \return Nothing
  */
@@ -2326,4 +2291,2 @@
  * \param fr Control frame to handle.
- *
- * \return Nothing
  */
@@ -2405,4 +2368,2 @@
  * \param f The frame containing the text data to send
- *
- * \return Nothing
  */
@@ -2440,4 +2401,2 @@
  * \param bridge_channel Channel to write outgoing frame.
- *
- * \return Nothing
  */
@@ -2546,3 +2505,6 @@
 
-/*! \brief Internal function to handle DTMF from a channel */
+/*!
+ * \internal
+ * \brief Handle DTMF from a channel
+ */
 static struct ast_frame *bridge_handle_dtmf(struct ast_bridge_channel *bridge_channel, struct ast_frame *frame)
@@ -2804,4 +2766,2 @@
  * \note Each channel does writing/reading in their own thread.
- *
- * \return Nothing
  */
@@ -2868,4 +2828,2 @@
  * \param type Specified join/leave event.
- *
- * \return Nothing
  */
--- include/asterisk/bridge_channel.h	2021-11-09 15:58:35.000000000 +0100
+++ include/asterisk/bridge_channel.h	2021-11-13 11:25:15.835047433 +0100
@@ -35,5 +35,5 @@
  * correct. The locking order must be:
- *  \arg The \ref \c ast_bridge
- *  \arg The \ref \c ast_bridge_channel
- *  \arg The \ref \c ast_channel
+ *  \arg The \ref ast_bridge "\c ast_bridge"
+ *  \arg The \ref ast_bridge_channel "\c ast_bridge_channel"
+ *  \arg The \ref ast_channel "\c ast_channel"
  *
@@ -227,4 +227,2 @@
  * \param bridge_channel What to lock
- *
- * \return Nothing
  */
@@ -240,4 +238,2 @@
  * \param bridge_channel What to unlock
- *
- * \return Nothing
  */
@@ -263,4 +259,2 @@
  * bridge-merge/channel-move operation between bridges.
- *
- * \return Nothing
  */
@@ -474,4 +468,2 @@
  * \note This is intended to be called by bridge hooks.
- *
- * \return Nothing
  */
@@ -520,4 +512,2 @@
  * \param playfile Sound filename to play.
- *
- * \return Nothing
  */
@@ -537,4 +527,2 @@
  * \note This is intended to be called by bridge hooks.
- *
- * \return Nothing
  */
@@ -608,4 +596,2 @@
  * \note The payload MUST NOT have any resources that need to be freed.
- *
- * \return Nothing
  */
@@ -687,4 +673,2 @@
  * bridge channel thread.
- *
- * \return Nothing
  */
@@ -712,3 +696,2 @@
  * \param digit DTMF digit to add to collected digits or 0 for timeout event.
- * \param clear_digits clear the digits array prior to calling hooks
  *
@@ -723,4 +706,2 @@
  * unbounded recursion.
- *
- * \return Nothing
  */
@@ -749,4 +730,2 @@
  * \note The bridge_channel's bridge must be locked prior to calling this function.
- *
- * \return Nothing
  */