<p>Alexander Traud has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/17588">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">progdocs: Fix for Doxygen, the hidden parts.<br><br>ASTERISK-29779<br><br>Change-Id: If338163488498f65fa7248b60e80299c0a928e4b<br>---<br>M apps/app_confbridge.c<br>M apps/app_queue.c<br>M apps/app_stack.c<br>M apps/app_stasis.c<br>M apps/app_voicemail.c<br>M channels/chan_dahdi.c<br>M channels/iax2/include/firmware.h<br>M channels/misdn/isdn_lib_intern.h<br>M channels/sig_pri.c<br>M channels/sig_pri.h<br>M channels/sig_ss7.c<br>M funcs/func_odbc.c<br>M include/asterisk/calendar.h<br>M include/asterisk/channel.h<br>M include/asterisk/cli.h<br>M include/asterisk/config.h<br>M include/asterisk/datastore.h<br>M include/asterisk/http_websocket.h<br>M include/asterisk/logger.h<br>M include/asterisk/netsock2.h<br>M include/asterisk/pbx.h<br>M include/asterisk/res_pjsip.h<br>M include/asterisk/sorcery.h<br>M include/asterisk/stasis.h<br>M include/asterisk/stasis_app_impl.h<br>M include/asterisk/stasis_app_mailbox.h<br>M include/asterisk/tcptls.h<br>M include/asterisk/test.h<br>M main/astmm.c<br>M main/astobj2_container.c<br>M main/dns_recurring.c<br>M main/dns_test.c<br>M main/optional_api.c<br>M main/pbx.c<br>M main/stasis_message_router.c<br>M main/test.c<br>M menuselect/menuselect.c<br>M menuselect/menuselect_curses.c<br>M menuselect/menuselect_gtk.c<br>M menuselect/menuselect_newt.c<br>M menuselect/menuselect_stub.c<br>M pbx/pbx_dundi.c<br>M pbx/pbx_lua.c<br>M res/res_odbc.c<br>M res/res_pjsip/config_transport.c<br>M res/res_xmpp.c<br>M tests/test_astobj2.c<br>M tests/test_astobj2_thrash.c<br>M tests/test_hashtab_thrash.c<br>49 files changed, 121 insertions(+), 383 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.asterisk.org:29418/asterisk refs/changes/88/17588/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/apps/app_confbridge.c b/apps/app_confbridge.c</span><br><span>index d16fd43..e0a0b4d 100644</span><br><span>--- a/apps/app_confbridge.c</span><br><span>+++ b/apps/app_confbridge.c</span><br><span>@@ -909,7 +909,7 @@</span><br><span>       return 0;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \brief Playback the given filename and monitor for any dtmf interrupts.</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Playback the given filename and monitor for any dtmf interrupts.</span><br><span>  *</span><br><span>  * This function is used to playback sound files on a given channel and optionally</span><br><span>  * allow dtmf interrupts to occur.</span><br><span>@@ -923,7 +923,9 @@</span><br><span>  * \param channel Optional channel to play file on if bridge_channel not given</span><br><span>  * \param filename The file name to playback</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval -1 failure during playback, 0 on file was fully played, 1 on dtmf interrupt.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval -1 failure during playback.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval 0 on file was fully played.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval 1 on dtmf interrupt.</span><br><span>  */</span><br><span> static int play_file(struct ast_bridge_channel *bridge_channel, struct ast_channel *channel,</span><br><span>                  const char *filename)</span><br><span>@@ -1306,7 +1308,7 @@</span><br><span>           ast_channel_name(user->chan));</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \internal</span><br><span>  * \brief Mute/unmute a single user.</span><br><span>  */</span><br><span>@@ -3491,7 +3493,7 @@</span><br><span>     return CLI_SHOWUSAGE;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \internal</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \internal</span><br><span>  * \brief finds a conference by name and locks/unlocks.</span><br><span>  *</span><br><span>  * \retval 0 success</span><br><span>@@ -3515,7 +3517,7 @@</span><br><span>   return res;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \internal</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \internal</span><br><span>  * \brief finds a conference user by channel name and mutes/unmutes them.</span><br><span>  *</span><br><span>  * \retval 0 success</span><br><span>diff --git a/apps/app_queue.c b/apps/app_queue.c</span><br><span>index 4f5913a..274d5e8 100644</span><br><span>--- a/apps/app_queue.c</span><br><span>+++ b/apps/app_queue.c</span><br><span>@@ -7780,9 +7780,10 @@</span><br><span>     return RESULT_FAILURE;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \brief Gets members penalty.</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span style="color: hsl(120, 100%, 40%);">+ * \brief Gets members penalty.</span><br><span>  * \return Return the members penalty or RESULT_FAILURE on error.</span><br><span style="color: hsl(0, 100%, 40%);">-*/</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> static int get_member_penalty(char *queuename, char *interface)</span><br><span> {</span><br><span>     int foundqueue = 0, penalty;</span><br><span>@@ -11532,9 +11533,10 @@</span><br><span>      return 0;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \brief Find a member by looking up queuename and interface.</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span style="color: hsl(120, 100%, 40%);">+ * \brief Find a member by looking up queuename and interface.</span><br><span>  * \return member or NULL if member not found.</span><br><span style="color: hsl(0, 100%, 40%);">-*/</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> static struct member *find_member_by_queuename_and_interface(const char *queuename, const char *interface)</span><br><span> {</span><br><span>    struct member *mem = NULL;</span><br><span>diff --git a/apps/app_stack.c b/apps/app_stack.c</span><br><span>index 3c857a9..557c6f1 100644</span><br><span>--- a/apps/app_stack.c</span><br><span>+++ b/apps/app_stack.c</span><br><span>@@ -924,8 +924,6 @@</span><br><span>  * \param chan Channel to balance stack on.</span><br><span>  *</span><br><span>  * \note The channel is already locked when called.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void balance_stack(struct ast_channel *chan)</span><br><span> {</span><br><span>diff --git a/apps/app_stasis.c b/apps/app_stasis.c</span><br><span>index b98c2b4..bf47bb0 100644</span><br><span>--- a/apps/app_stasis.c</span><br><span>+++ b/apps/app_stasis.c</span><br><span>@@ -79,7 +79,7 @@</span><br><span> /*! \brief Dialplan application name */</span><br><span> static const char *stasis = "Stasis";</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! /brief Stasis dialplan application callback */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Stasis dialplan application callback */</span><br><span> static int app_exec(struct ast_channel *chan, const char *data)</span><br><span> {</span><br><span>        char *parse = NULL;</span><br><span>diff --git a/apps/app_voicemail.c b/apps/app_voicemail.c</span><br><span>index ee7752d..d2fcc92 100644</span><br><span>--- a/apps/app_voicemail.c</span><br><span>+++ b/apps/app_voicemail.c</span><br><span>@@ -2892,6 +2892,7 @@</span><br><span>  * \param recip</span><br><span>  * \param fmt</span><br><span>  * \param dir</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param flag, dest_folder</span><br><span>  *</span><br><span>  * This works with IMAP storage based mailboxes.</span><br><span>  *</span><br><span>@@ -4181,8 +4182,6 @@</span><br><span>  *</span><br><span>  * This method is used when mailboxes are stored in an ODBC back end.</span><br><span>  * The specified message is directly deleted from the database 'voicemessages' table.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return the value greater than zero on success to indicate the number of messages, less than zero on error.</span><br><span>  */</span><br><span> static void delete_file(const char *sdir, int smsg)</span><br><span> {</span><br><span>diff --git a/channels/chan_dahdi.c b/channels/chan_dahdi.c</span><br><span>index 96d540f..ad7a8e5 100644</span><br><span>--- a/channels/chan_dahdi.c</span><br><span>+++ b/channels/chan_dahdi.c</span><br><span>@@ -2884,13 +2884,17 @@</span><br><span>  *</span><br><span>  * \details</span><br><span>  * original dialstring:</span><br><span style="color: hsl(0, 100%, 40%);">- * DAHDI/[i<span>-](g|G|r|R)<group#(0-63)>[c|r<cadence#>|d][/extension[/options]]</span><br><span style="color: hsl(120, 100%, 40%);">+ * \verbatim</span><br><span style="color: hsl(120, 100%, 40%);">+   DAHDI/[i<span>-](g|G|r|R)<group#(0-63)>[c|r<cadence#>|d][/extension[/options]]</span><br><span style="color: hsl(120, 100%, 40%);">+   \endverbatim</span><br><span>  *</span><br><span>  * The modified dialstring will have prefixed the channel-group section</span><br><span>  * with the ISDN channel restriction.</span><br><span>  *</span><br><span>  * buf:</span><br><span style="color: hsl(0, 100%, 40%);">- * DAHDI/i<span>-(g|G|r|R)<group#(0-63)>[c|r<cadence#>|d][/extension[/options]]</span><br><span style="color: hsl(120, 100%, 40%);">+ * \verbatim</span><br><span style="color: hsl(120, 100%, 40%);">+   DAHDI/i<span>-(g|G|r|R)<group#(0-63)>[c|r<cadence#>|d][/extension[/options]]</span><br><span style="color: hsl(120, 100%, 40%);">+   \endverbatim</span><br><span>  *</span><br><span>  * The routine will check to see if the ISDN channel restriction is already</span><br><span>  * in the original dialstring.</span><br><span>@@ -3150,6 +3154,7 @@</span><br><span>  * \param law Companding law to use.</span><br><span>  * \param exten Dialplan extension for incoming call.</span><br><span>  * \param requestor Channel requesting this new channel.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param assignedids</span><br><span>  *</span><br><span>  * \retval ast_channel on success.</span><br><span>  * \retval NULL on error.</span><br><span>diff --git a/channels/iax2/include/firmware.h b/channels/iax2/include/firmware.h</span><br><span>index fba1afb..548682e 100644</span><br><span>--- a/channels/iax2/include/firmware.h</span><br><span>+++ b/channels/iax2/include/firmware.h</span><br><span>@@ -38,8 +38,6 @@</span><br><span> /*!</span><br><span>  * \internal</span><br><span>  * \brief Unload all of the currently loaded firmware.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * return Nothing</span><br><span>  */</span><br><span> void iax_firmware_unload(void);</span><br><span> </span><br><span>diff --git a/channels/misdn/isdn_lib_intern.h b/channels/misdn/isdn_lib_intern.h</span><br><span>index d811f80..d71fe77 100644</span><br><span>--- a/channels/misdn/isdn_lib_intern.h</span><br><span>+++ b/channels/misdn/isdn_lib_intern.h</span><br><span>@@ -73,7 +73,7 @@</span><br><span>        /*! \brief D Channel mISDN driver stack ID (Parent stack ID) */</span><br><span>      int d_stid;</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">- /*! /brief Number of B channels supported by this port */</span><br><span style="color: hsl(120, 100%, 40%);">+     /*! \brief Number of B channels supported by this port */</span><br><span>    int b_num;</span><br><span> </span><br><span>       /*! \brief B Channel mISDN driver stack IDs (Child stack IDs) */</span><br><span>diff --git a/channels/sig_pri.c b/channels/sig_pri.c</span><br><span>index f576660..55bbe47 100644</span><br><span>--- a/channels/sig_pri.c</span><br><span>+++ b/channels/sig_pri.c</span><br><span>@@ -300,8 +300,6 @@</span><br><span>  *</span><br><span>  * \param pri PRI span control structure.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  */</span><br><span> static void sig_pri_span_devstate_changed(struct sig_pri_span *pri)</span><br><span>@@ -317,8 +315,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param p sig_pri channel structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_set_caller_id(struct sig_pri_chan *p)</span><br><span> {</span><br><span>@@ -361,8 +357,6 @@</span><br><span>  *</span><br><span>  * \param p sig_pri channel structure.</span><br><span>  * \param dnid Dialed Number Identifier string.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_set_dnid(struct sig_pri_chan *p, const char *dnid)</span><br><span> {</span><br><span>@@ -378,8 +372,6 @@</span><br><span>  *</span><br><span>  * \param p sig_pri channel structure.</span><br><span>  * \param rdnis Redirecting Directory Number Information Service (RDNIS) string.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_set_rdnis(struct sig_pri_chan *p, const char *rdnis)</span><br><span> {</span><br><span>@@ -715,9 +707,6 @@</span><br><span>  *</span><br><span>  * \param ast_subaddress Asterisk party subaddress structure.</span><br><span>  * \param pri_subaddress PRI party subaddress structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span>  */</span><br><span> static void sig_pri_set_subaddress(struct ast_party_subaddress *ast_subaddress, const struct pri_party_subaddress *pri_subaddress)</span><br><span> {</span><br><span>@@ -838,8 +827,6 @@</span><br><span>  * \param pri_subaddress PRI party subaddress structure.</span><br><span>  * \param ast_subaddress Asterisk party subaddress structure.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span>  * \note Assumes that pri_subaddress has been previously memset to zero.</span><br><span>  */</span><br><span> static void sig_pri_party_subaddress_from_ast(struct pri_party_subaddress *pri_subaddress, const struct ast_party_subaddress *ast_subaddress)</span><br><span>@@ -884,8 +871,6 @@</span><br><span>  * \param pri_name PRI party name structure.</span><br><span>  * \param ast_name Asterisk party name structure.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span>  * \note Assumes that pri_name has been previously memset to zero.</span><br><span>  */</span><br><span> static void sig_pri_party_name_from_ast(struct pri_party_name *pri_name, const struct ast_party_name *ast_name)</span><br><span>@@ -909,8 +894,6 @@</span><br><span>  * \param pri_number PRI party number structure.</span><br><span>  * \param ast_number Asterisk party number structure.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span>  * \note Assumes that pri_number has been previously memset to zero.</span><br><span>  */</span><br><span> static void sig_pri_party_number_from_ast(struct pri_party_number *pri_number, const struct ast_party_number *ast_number)</span><br><span>@@ -934,8 +917,6 @@</span><br><span>  * \param pri_id PRI party id structure.</span><br><span>  * \param ast_id Asterisk party id structure.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span>  * \note Assumes that pri_id has been previously memset to zero.</span><br><span>  */</span><br><span> static void sig_pri_party_id_from_ast(struct pri_party_id *pri_id, const struct ast_party_id *ast_id)</span><br><span>@@ -955,8 +936,6 @@</span><br><span>  * \param pvt sig_pri private channel structure.</span><br><span>  * \param ast Asterisk channel</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span>  * \note Assumes that the PRI lock is already obtained.</span><br><span>  */</span><br><span> static void sig_pri_redirecting_update(struct sig_pri_chan *pvt, struct ast_channel *ast)</span><br><span>@@ -985,8 +964,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param p sig_pri channel structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_dsp_reset_and_flush_digits(struct sig_pri_chan *p)</span><br><span> {</span><br><span>@@ -1060,8 +1037,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param p Channel private control structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_open_media(struct sig_pri_chan *p)</span><br><span> {</span><br><span>@@ -1082,8 +1057,6 @@</span><br><span>  * \param p Channel private control structure.</span><br><span>  *</span><br><span>  * \note Assumes the private and owner are locked.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_ami_channel_event(struct sig_pri_chan *p)</span><br><span> {</span><br><span>@@ -1262,8 +1235,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_lock_owner(struct sig_pri_span *pri, int chanpos)</span><br><span> {</span><br><span>@@ -1295,8 +1266,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void pri_queue_frame(struct sig_pri_span *pri, int chanpos, struct ast_frame *frame)</span><br><span> {</span><br><span>@@ -1317,8 +1286,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_queue_hold(struct sig_pri_span *pri, int chanpos)</span><br><span> {</span><br><span>@@ -1339,8 +1306,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_queue_unhold(struct sig_pri_span *pri, int chanpos)</span><br><span> {</span><br><span>@@ -1362,8 +1327,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void pri_queue_control(struct sig_pri_span *pri, int chanpos, int subclass)</span><br><span> {</span><br><span>@@ -1390,8 +1353,6 @@</span><br><span>  * \note The unlocking/locking sequence now present has been stress tested</span><br><span>  *       without deadlocks.  Please don't change it without consulting</span><br><span>  *       core development team members.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_queue_hangup(struct sig_pri_span *pri, int chanpos)</span><br><span> {</span><br><span>@@ -1427,11 +1388,10 @@</span><br><span>  * \param pri PRI span control structure.</span><br><span>  * \param chanpos Channel position in the span.</span><br><span>  * \param cause String describing the cause to be placed into the frame.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ast_cause</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void pri_queue_pvt_cause_data(struct sig_pri_span *pri, int chanpos, const char *cause, int ast_cause)</span><br><span> {</span><br><span>@@ -1493,8 +1453,6 @@</span><br><span>  * Asks the channel driver to queue the span for destruction at a</span><br><span>  * possibly later time, if (e.g.) locking considerations don't allow</span><br><span>  * destroying it right now.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void pri_destroy_later(struct sig_pri_span *pri)</span><br><span> {</span><br><span>@@ -1514,8 +1472,6 @@</span><br><span>  * \param cause Reason call was killed.</span><br><span>  *</span><br><span>  * \note Assumes the pvt->pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_kill_call(struct sig_pri_span *pri, q931_call *call, int cause)</span><br><span> {</span><br><span>@@ -1850,8 +1806,6 @@</span><br><span>  * \param pri PRI span control structure.</span><br><span>  * \param number Number to apply numbering plan.</span><br><span>  * \param plan Numbering plan to apply.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void apply_plan_to_number(char *buf, size_t size, const struct sig_pri_span *pri, const char *number, int plan)</span><br><span> {</span><br><span>@@ -1886,8 +1840,6 @@</span><br><span>  * \param pri PRI span control structure.</span><br><span>  * \param number Number to apply numbering plan.</span><br><span>  * \param plan Numbering plan to apply.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void apply_plan_to_existing_number(char *buf, size_t size, const struct sig_pri_span *pri, const char *number, int plan)</span><br><span> {</span><br><span>@@ -1908,8 +1860,6 @@</span><br><span>  * \param pri PRI span control structure.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void pri_check_restart(struct sig_pri_span *pri)</span><br><span> {</span><br><span>@@ -1956,8 +1906,6 @@</span><br><span>  * \param pri PRI span control structure.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_init_config(struct sig_pri_chan *pvt, struct sig_pri_span *pri)</span><br><span> {</span><br><span>@@ -2270,8 +2218,6 @@</span><br><span>  *</span><br><span>  * \note The filled in ast_name structure needs to be destroyed by</span><br><span>  * ast_party_name_free() when it is no longer needed.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_party_name_convert(struct ast_party_name *ast_name, const struct pri_party_name *pri_name)</span><br><span> {</span><br><span>@@ -2292,8 +2238,6 @@</span><br><span>  *</span><br><span>  * \note The filled in ast_number structure needs to be destroyed by</span><br><span>  * ast_party_number_free() when it is no longer needed.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_party_number_convert(struct ast_party_number *ast_number, const struct pri_party_number *pri_number, struct sig_pri_span *pri)</span><br><span> {</span><br><span>@@ -2318,8 +2262,6 @@</span><br><span>  *</span><br><span>  * \note The filled in ast_id structure needs to be destroyed by</span><br><span>  * ast_party_id_free() when it is no longer needed.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_party_id_convert(struct ast_party_id *ast_id, const struct pri_party_id *pri_id, struct sig_pri_span *pri)</span><br><span> {</span><br><span>@@ -2348,8 +2290,6 @@</span><br><span>  *</span><br><span>  * \note The filled in ast_redirecting structure needs to be destroyed by</span><br><span>  * ast_party_redirecting_free() when it is no longer needed.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_redirecting_convert(struct ast_party_redirecting *ast_redirecting,</span><br><span>  const struct pri_party_redirecting *pri_redirecting,</span><br><span>@@ -2473,8 +2413,6 @@</span><br><span>  * \param msg Event message string being built.</span><br><span>  * \param prefix Prefix to add to the party id lines.</span><br><span>  * \param party Party information to encode.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void party_json_to_ami(struct ast_str **msg, const char *prefix, struct ast_json *party)</span><br><span> {</span><br><span>@@ -2554,8 +2492,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the owner channel lock is already obtained if still present.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_mcid_event(struct sig_pri_span *pri, const struct pri_subcmd_mcid_req *mcid, struct ast_channel *owner)</span><br><span> {</span><br><span>@@ -2609,8 +2545,6 @@</span><br><span>  * \param is_successful TRUE if the transfer was successful.</span><br><span>  *</span><br><span>  * \note Assumes the rsp->pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_transfer_rsp(struct xfer_rsp_data *rsp, int is_successful)</span><br><span> {</span><br><span>@@ -2879,8 +2813,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param data Monitor instance to destroy.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_cc_monitor_instance_destroy(void *data)</span><br><span> {</span><br><span>@@ -3028,8 +2960,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_cc_generic_check(struct sig_pri_span *pri, int chanpos, enum ast_cc_service_type service)</span><br><span> {</span><br><span>@@ -3125,8 +3055,6 @@</span><br><span>  * \param pri PRI span control structure.</span><br><span>  * \param cc_id CC record ID.</span><br><span>  * \param is_agent TRUE if the cc_id is for an agent.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_cc_link_canceled(struct sig_pri_span *pri, long cc_id, int is_agent)</span><br><span> {</span><br><span>@@ -3359,8 +3287,6 @@</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri private is locked</span><br><span>  * \note Assumes the owner channel lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_aoc_s_from_pri(const struct pri_subcmd_aoc_s *aoc_s, struct ast_channel *owner, int passthrough)</span><br><span> {</span><br><span>@@ -3447,13 +3373,11 @@</span><br><span>  * \brief Generate AOC Request Response</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param aoc_request</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param aoc_request, pvt, call</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri private is locked</span><br><span>  * \note Assumes the owner channel lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_aoc_request_from_pri(const struct pri_subcmd_aoc_request *aoc_request, struct sig_pri_chan *pvt, q931_call *call)</span><br><span> {</span><br><span>@@ -3516,15 +3440,13 @@</span><br><span>  * \brief Generate AOC-D AST_CONTROL_AOC frame</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param aoc_e AOC-D event parameters.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param aoc_d AOC-D event parameters.</span><br><span>  * \param owner Asterisk channel associated with the call.</span><br><span>  * \param passthrough indicating if this message should be queued on the ast channel</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri private is locked</span><br><span>  * \note Assumes the owner channel lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_aoc_d_from_pri(const struct pri_subcmd_aoc_d *aoc_d, struct ast_channel *owner, int passthrough)</span><br><span> {</span><br><span>@@ -3632,8 +3554,6 @@</span><br><span>  * \note Assumes the sig_pri private is locked</span><br><span>  * \note Assumes the owner channel lock is already obtained.</span><br><span>  * \note owner channel may be NULL. In that case, generate event only</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_aoc_e_from_pri(const struct pri_subcmd_aoc_e *aoc_e, struct ast_channel *owner, int passthrough)</span><br><span> {</span><br><span>@@ -3748,9 +3668,7 @@</span><br><span>  * \brief send an AOC-S message on the current call</span><br><span>  *</span><br><span>  * \param pvt sig_pri private channel structure.</span><br><span style="color: hsl(0, 100%, 40%);">- * \param generic decoded ast AOC message</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param decoded decoded ast AOC message</span><br><span>  *</span><br><span>  * \note Assumes that the PRI lock is already obtained.</span><br><span>  */</span><br><span>@@ -3847,9 +3765,7 @@</span><br><span>  * \brief send an AOC-D message on the current call</span><br><span>  *</span><br><span>  * \param pvt sig_pri private channel structure.</span><br><span style="color: hsl(0, 100%, 40%);">- * \param generic decoded ast AOC message</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param decoded decoded ast AOC message</span><br><span>  *</span><br><span>  * \note Assumes that the PRI lock is already obtained.</span><br><span>  */</span><br><span>@@ -3930,9 +3846,7 @@</span><br><span>  * \brief send an AOC-E message on the current call</span><br><span>  *</span><br><span>  * \param pvt sig_pri private channel structure.</span><br><span style="color: hsl(0, 100%, 40%);">- * \param generic decoded ast AOC message</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param decoded decoded ast AOC message</span><br><span>  *</span><br><span>  * \note Assumes that the PRI lock is already obtained.</span><br><span>  */</span><br><span>@@ -4050,8 +3964,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_send_aoce_termination_request(struct sig_pri_span *pri, int chanpos, unsigned int ms)</span><br><span> {</span><br><span>@@ -4127,8 +4039,6 @@</span><br><span>  * need to use the pointer to send a response message back.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_handle_cis_subcmds(struct sig_pri_span *pri, int event_id,</span><br><span>         const struct pri_subcommands *subcmds, q931_call *call_rsp)</span><br><span>@@ -4344,8 +4254,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_handle_subcmds(struct sig_pri_span *pri, int chanpos, int event_id,</span><br><span>   const struct pri_subcommands *subcmds, q931_call *call_rsp)</span><br><span>@@ -5329,8 +5237,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pvt->pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pvt) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_moh_fsm_event(struct ast_channel *chan, struct sig_pri_chan *pvt, enum sig_pri_moh_event event)</span><br><span> {</span><br><span>@@ -5507,8 +5413,6 @@</span><br><span>  * \param ev Hold acknowledge event received.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_handle_hold_ack(struct sig_pri_span *pri, pri_event *ev)</span><br><span> {</span><br><span>@@ -5560,8 +5464,6 @@</span><br><span>  * \param ev Hold reject event received.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_handle_hold_rej(struct sig_pri_span *pri, pri_event *ev)</span><br><span> {</span><br><span>@@ -5609,8 +5511,6 @@</span><br><span>  * \param ev Retrieve event received.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_handle_retrieve(struct sig_pri_span *pri, pri_event *ev)</span><br><span> {</span><br><span>@@ -5683,8 +5583,6 @@</span><br><span>  * \param ev Retrieve acknowledge event received.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_handle_retrieve_ack(struct sig_pri_span *pri, pri_event *ev)</span><br><span> {</span><br><span>@@ -5723,8 +5621,6 @@</span><br><span>  * \param ev Retrieve reject event received.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_handle_retrieve_rej(struct sig_pri_span *pri, pri_event *ev)</span><br><span> {</span><br><span>@@ -5773,8 +5669,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span>  * \note Assumes the sig_pri_lock_private(pri->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void setup_incoming_channel(struct sig_pri_span *pri, int chanpos, pri_event *ev)</span><br><span> {</span><br><span>@@ -5867,8 +5761,6 @@</span><br><span>  * \param e SETUP event received.</span><br><span>  *</span><br><span>  * \note Assumes the pri->lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_handle_setup(struct sig_pri_span *pri, pri_event *e)</span><br><span> {</span><br><span>@@ -7794,12 +7686,10 @@</span><br><span>  *</span><br><span>  * \param p sig_pri channel structure.</span><br><span>  * \param rdest Dial string buffer to extract called number and subaddress.</span><br><span style="color: hsl(0, 100%, 40%);">- * \param called Buffer to fill with extracted <number>[:<subaddress>]</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param called Buffer to fill with extracted \<number\>[:\<subaddress\>]</span><br><span>  * \param called_buff_size Size of buffer to fill.</span><br><span>  *</span><br><span>  * \note Parsing must remain in sync with sig_pri_call().</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_extract_called_num_subaddr(struct sig_pri_chan *p, const char *rdest, char *called, size_t called_buff_size)</span><br><span> {</span><br><span>@@ -8832,8 +8722,6 @@</span><br><span>  * \param ast Asterisk channel</span><br><span>  *</span><br><span>  * \note Channel and private lock are already held.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_dial_complete(struct sig_pri_chan *pvt, struct ast_channel *ast)</span><br><span> {</span><br><span>@@ -8869,8 +8757,6 @@</span><br><span>  * \param vm_box Voicemail mailbox number</span><br><span>  * \param mbox_id Mailbox id</span><br><span>  * \param num_messages Number of messages waiting.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_send_mwi_indication(struct sig_pri_span *pri, const char *vm_number, const char *vm_box, const char *mbox_id, int num_messages)</span><br><span> {</span><br><span>@@ -8913,10 +8799,7 @@</span><br><span>  *</span><br><span>  * \param userdata the data provider in the call to stasis_subscribe()</span><br><span>  * \param sub the subscription to which the message was delivered for this callback</span><br><span style="color: hsl(0, 100%, 40%);">- * \param topic the topic on which the message was published</span><br><span>  * \param msg the message being passed to the subscriber</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_mwi_event_cb(void *userdata, struct stasis_subscription *sub, struct stasis_message *msg)</span><br><span> {</span><br><span>@@ -8953,8 +8836,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param pri PRI span control structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_mwi_cache_update(struct sig_pri_span *pri)</span><br><span> {</span><br><span>@@ -8987,8 +8868,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param pri PRI span control structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_stop_pri(struct sig_pri_span *pri)</span><br><span> {</span><br><span>@@ -9047,8 +8926,6 @@</span><br><span>  * \details</span><br><span>  * Since the chan_dahdi.conf file can declare channels in any order, we need to sort</span><br><span>  * the private channel pointer array.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_pri_sort_pri_chans(struct sig_pri_span *pri)</span><br><span> {</span><br><span>@@ -9282,8 +9159,6 @@</span><br><span>  * \param noalarm Non-zero if not in alarm mode.</span><br><span>  *</span><br><span>  * \note Assumes the sig_pri_lock_private(p) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_chan_alarm_notify(struct sig_pri_chan *p, int noalarm)</span><br><span> {</span><br><span>@@ -9307,7 +9182,7 @@</span><br><span> /*!</span><br><span>  * \brief Determine if layer 1 alarms are ignored.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param p Channel private pointer.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param pri Channel private pointer.</span><br><span>  *</span><br><span>  * \return TRUE if the alarm is ignored.</span><br><span>  */</span><br><span>@@ -9340,8 +9215,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param doomed sig_pri private channel structure to delete.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_chan_delete(struct sig_pri_chan *doomed)</span><br><span> {</span><br><span>@@ -9514,8 +9387,6 @@</span><br><span>  *</span><br><span>  * \param p Channel to send text over</span><br><span>  * \param text Text to send.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_sendtext(struct sig_pri_chan *p, const char *text)</span><br><span> {</span><br><span>@@ -9639,8 +9510,6 @@</span><br><span>  * The duty of this is to issue a propper response to a</span><br><span>  * CC request from the caller by acknowledging receipt</span><br><span>  * of that request or rejecting it.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_cc_agent_req_rsp(struct ast_cc_agent *agent, enum ast_cc_agent_response_reason reason)</span><br><span> {</span><br><span>@@ -9863,8 +9732,6 @@</span><br><span>  * \note</span><br><span>  * The agent private_data pointer may be NULL if the agent</span><br><span>  * constructor failed.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_cc_agent_destructor(struct ast_cc_agent *agent)</span><br><span> {</span><br><span>@@ -10159,8 +10026,6 @@</span><br><span> /*!</span><br><span>  * \brief Unload the sig_pri submodule.</span><br><span>  * \since 1.8</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_pri_unload(void)</span><br><span> {</span><br><span>diff --git a/channels/sig_pri.h b/channels/sig_pri.h</span><br><span>index 2486772..22d3cef 100644</span><br><span>--- a/channels/sig_pri.h</span><br><span>+++ b/channels/sig_pri.h</span><br><span>@@ -222,8 +222,6 @@</span><br><span>      *</span><br><span>    * \param pvt Private structure of the user of this module.</span><br><span>   * \param chan Channel associated with the private pointer</span><br><span style="color: hsl(0, 100%, 40%);">-       *</span><br><span style="color: hsl(0, 100%, 40%);">-       * \return Nothing</span><br><span>    */</span><br><span>  void (* const ami_channel_event)(void *pvt, struct ast_channel *chan);</span><br><span> </span><br><span>@@ -639,7 +637,7 @@</span><br><span>      *    the configured threshold.</span><br><span>       * AST_DEVICE_UNAVAILABLE - Span is in alarm.</span><br><span>         * \note</span><br><span style="color: hsl(0, 100%, 40%);">-         * Device name:  DAHDI/I<span>/threshold</span><br><span style="color: hsl(120, 100%, 40%);">+         * Device name: \verbatim DAHDI/I<span>/threshold \endverbatim</span><br><span>          */</span><br><span>  int threshold_devstate;</span><br><span>      /*!</span><br><span>diff --git a/channels/sig_ss7.c b/channels/sig_ss7.c</span><br><span>index 99a5d94..eeb5073 100644</span><br><span>--- a/channels/sig_ss7.c</span><br><span>+++ b/channels/sig_ss7.c</span><br><span>@@ -171,8 +171,6 @@</span><br><span>  * \since 1.8.12</span><br><span>  *</span><br><span>  * \param p Channel private control structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_ss7_open_media(struct sig_ss7_chan *p)</span><br><span> {</span><br><span>@@ -187,8 +185,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param p sig_ss7 channel structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_ss7_set_caller_id(struct sig_ss7_chan *p)</span><br><span> {</span><br><span>@@ -230,8 +226,6 @@</span><br><span>  *</span><br><span>  * \param p sig_ss7 channel structure.</span><br><span>  * \param dnid Dialed Number Identifier string.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_ss7_set_dnid(struct sig_ss7_chan *p, const char *dnid)</span><br><span> {</span><br><span>@@ -327,7 +321,7 @@</span><br><span>  *</span><br><span>  * \param pvt Channel to determine if available.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return TRUE if the channel is available.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval TRUE if the channel is available.</span><br><span>  */</span><br><span> static int sig_ss7_is_chan_available(struct sig_ss7_chan *pvt)</span><br><span> {</span><br><span>@@ -349,8 +343,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the ss7->lock is already obtained.</span><br><span>  * \note Assumes the sig_ss7_lock_private(ss7->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_ss7_lock_owner(struct sig_ss7_linkset *ss7, int chanpos)</span><br><span> {</span><br><span>@@ -382,8 +374,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the ss7->lock is already obtained.</span><br><span>  * \note Assumes the sig_ss7_lock_private(ss7->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_ss7_queue_frame(struct sig_ss7_linkset *ss7, int chanpos, struct ast_frame *frame)</span><br><span> {</span><br><span>@@ -405,8 +395,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the ss7->lock is already obtained.</span><br><span>  * \note Assumes the sig_ss7_lock_private(ss7->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void sig_ss7_queue_control(struct sig_ss7_linkset *ss7, int chanpos, int subclass)</span><br><span> {</span><br><span>@@ -428,12 +416,11 @@</span><br><span>  *</span><br><span>  * \param owner Owner channel of the pvt.</span><br><span>  * \param cause String describing the cause to be placed into the frame.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ast_cause</span><br><span>  *</span><br><span>  * \note Assumes the linkset->lock is already obtained.</span><br><span>  * \note Assumes the sig_ss7_lock_private(linkset->pvts[chanpos]) is already obtained.</span><br><span>  * \note Assumes linkset->pvts[chanpos]->owner is non-NULL and its lock is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void ss7_queue_pvt_cause_data(struct ast_channel *owner, const char *cause, int ast_cause)</span><br><span> {</span><br><span>@@ -457,7 +444,7 @@</span><br><span>  * \param cic Circuit Identification Code</span><br><span>  * \param dpc Destination Point Code</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval chanpos on success.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return chanpos on success.</span><br><span>  * \retval -1 on error.</span><br><span>  */</span><br><span> int sig_ss7_find_cic(struct sig_ss7_linkset *linkset, int cic, unsigned int dpc)</span><br><span>@@ -482,7 +469,7 @@</span><br><span>  * \param dpc Destination Point Code</span><br><span>  * \param msg_name Message type name that failed.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval chanpos on success.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return chanpos on success.</span><br><span>  * \retval -1 on error.</span><br><span>  */</span><br><span> static int ss7_find_cic_gripe(struct sig_ss7_linkset *linkset, int cic, unsigned int dpc, const char *msg_name)</span><br><span>@@ -583,8 +570,6 @@</span><br><span>  * \param endcic Circuit Identification Code to search up-to</span><br><span>  * \param dpc Destination Point Code</span><br><span>  * \param state Array containing the status of the search</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval Nothing.</span><br><span>  */</span><br><span> static void ss7_check_range(struct sig_ss7_linkset *linkset, int startcic, int endcic, unsigned int dpc, unsigned char *state)</span><br><span> {</span><br><span>@@ -618,7 +603,7 @@</span><br><span>  *</span><br><span>  * \note Assumes the linkset->lock is already obtained.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return TRUE if all CICs in the range are present</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval TRUE if all CICs in the range are present</span><br><span>  */</span><br><span> int sig_ss7_find_cic_range(struct sig_ss7_linkset *linkset, int startcic, int endcic, unsigned int dpc)</span><br><span> {</span><br><span>@@ -720,8 +705,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the linkset->lock is already obtained.</span><br><span>  * \note Must be called without sig_ss7_lock_private() obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing.</span><br><span>  */</span><br><span> static inline void ss7_block_cics(struct sig_ss7_linkset *linkset, int startcic, int endcic, unsigned int dpc, unsigned char state[], int block, int remotely, int type)</span><br><span> {</span><br><span>@@ -767,8 +750,6 @@</span><br><span>  * \param dpc Destination Point Code.</span><br><span>  *</span><br><span>  * \note Must be called without sig_ss7_lock_private() obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing.</span><br><span>  */</span><br><span> static void ss7_inservice(struct sig_ss7_linkset *linkset, int startcic, int endcic, unsigned int dpc)</span><br><span> {</span><br><span>@@ -859,8 +840,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the ss7->lock is already obtained.</span><br><span>  * \note Assumes sig_ss7_lock_private(p) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing.</span><br><span>  */</span><br><span> static void ss7_do_rsc(struct sig_ss7_chan *p)</span><br><span> {</span><br><span>@@ -882,13 +861,13 @@</span><br><span>  * \brief Start RSC procedure on a specific link</span><br><span>  * \since 11.0</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param ss7 SS7 linkset control structure.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param linkset SS7 linkset control structure.</span><br><span>  * \param which Channel position in the span.</span><br><span>  *</span><br><span>  * \note Assumes the ss7->lock is already obtained.</span><br><span>  * \note Assumes the sig_ss7_lock_private(ss7->pvts[chanpos]) is already obtained.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return TRUE on success</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval TRUE on success</span><br><span>  */</span><br><span> static int ss7_start_rsc(struct sig_ss7_linkset *linkset, int which)</span><br><span> {</span><br><span>@@ -930,8 +909,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the linkset->lock is already obtained.</span><br><span>  * \note Must be called without sig_ss7_lock_private() obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing.</span><br><span>  */</span><br><span> static void ss7_clear_channels(struct sig_ss7_linkset *linkset, int startcic, int endcic, int dpc, int do_hangup)</span><br><span> {</span><br><span>@@ -966,8 +943,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the linkset->lock is already obtained.</span><br><span>  * \note Assumes the sig_ss7_lock_private(ss7->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing.</span><br><span>  */</span><br><span> static void ss7_start_call(struct sig_ss7_chan *p, struct sig_ss7_linkset *linkset)</span><br><span> {</span><br><span>@@ -1346,8 +1321,6 @@</span><br><span>  *</span><br><span>  * \note Assumes the linkset->lock is already obtained.</span><br><span>  * \note Assumes the sig_ss7_lock_private(ss7->pvts[chanpos]) is already obtained.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing.</span><br><span>  */</span><br><span> static void ss7_match_extension(struct sig_ss7_linkset *linkset, struct sig_ss7_chan *p, ss7_event *e)</span><br><span> {</span><br><span>@@ -2378,7 +2351,7 @@</span><br><span>  * \param cic Circuit Identification Code</span><br><span>  * \param dpc Destination Point Code</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return TRUE on success</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval TRUE on success</span><br><span>  */</span><br><span> int sig_ss7_reset_cic(struct sig_ss7_linkset *linkset, int cic, unsigned int dpc)</span><br><span> {</span><br><span>@@ -2410,7 +2383,7 @@</span><br><span>  * \param do_block Action to perform. Block if TRUE.</span><br><span>  * \param which On which CIC to perform the operation.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return 0 on success</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval 0 on success</span><br><span>  */</span><br><span> int sig_ss7_cic_blocking(struct sig_ss7_linkset *linkset, int do_block, int which)</span><br><span> {</span><br><span>@@ -2447,7 +2420,7 @@</span><br><span>  *</span><br><span>  * \note Assumes the linkset->lock is already obtained.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return 0 on success</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval 0 on success</span><br><span>  */</span><br><span> int sig_ss7_group_blocking(struct sig_ss7_linkset *linkset, int do_block, int chanpos, int endcic, unsigned char state[], int type)</span><br><span> {</span><br><span>@@ -2478,7 +2451,7 @@</span><br><span>  *</span><br><span>  * \note Assumes the linkset->lock is already obtained.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return 0 on success</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval 0 on success</span><br><span>  */</span><br><span> int sig_ss7_reset_group(struct sig_ss7_linkset *linkset, int cic, unsigned int dpc, int range)</span><br><span> {</span><br><span>@@ -2547,8 +2520,6 @@</span><br><span>  *</span><br><span>  * \param linkset Controlling linkset for the channel.</span><br><span>  * \param which Link index of the signaling channel.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_ss7_link_alarm(struct sig_ss7_linkset *linkset, int which)</span><br><span> {</span><br><span>@@ -2563,8 +2534,6 @@</span><br><span>  *</span><br><span>  * \param linkset Controlling linkset for the channel.</span><br><span>  * \param which Link index of the signaling channel.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_ss7_link_noalarm(struct sig_ss7_linkset *linkset, int which)</span><br><span> {</span><br><span>@@ -2585,6 +2554,7 @@</span><br><span>  * \param networkindicator User configuration parameter.</span><br><span>  * \param pointcode User configuration parameter.</span><br><span>  * \param adjpointcode User configuration parameter.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param cur_slc</span><br><span>  *</span><br><span>  * \retval 0 on success.</span><br><span>  * \retval -1 on error.</span><br><span>@@ -3121,8 +3091,6 @@</span><br><span>  * \param oldchan Old channel pointer to replace.</span><br><span>  * \param newchan New channel pointer to set.</span><br><span>  * \param pchan Signaling private structure pointer.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_ss7_fixup(struct ast_channel *oldchan, struct ast_channel *newchan, struct sig_ss7_chan *pchan)</span><br><span> {</span><br><span>@@ -3268,7 +3236,7 @@</span><br><span>  * \param p Signaling private structure pointer.</span><br><span>  * \param law Companding law preferred</span><br><span>  * \param requestor Asterisk channel requesting a channel to dial (Can be NULL)</span><br><span style="color: hsl(0, 100%, 40%);">- * \param transfercapability</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param assignedids, transfercapability</span><br><span>  *</span><br><span>  * \retval ast_channel on success.</span><br><span>  * \retval NULL on error.</span><br><span>@@ -3306,8 +3274,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param doomed sig_ss7 private channel structure to delete.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_ss7_chan_delete(struct sig_ss7_chan *doomed)</span><br><span> {</span><br><span>@@ -3389,8 +3355,6 @@</span><br><span>  * \since 1.8</span><br><span>  *</span><br><span>  * \param ss7 SS7 linkset control structure.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void sig_ss7_init_linkset(struct sig_ss7_linkset *ss7)</span><br><span> {</span><br><span>diff --git a/funcs/func_odbc.c b/funcs/func_odbc.c</span><br><span>index 22bc45b..48619b1 100644</span><br><span>--- a/funcs/func_odbc.c</span><br><span>+++ b/funcs/func_odbc.c</span><br><span>@@ -143,7 +143,7 @@</span><br><span>      char names[0];</span><br><span> };</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \brief Data source name</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Data source name</span><br><span>  *</span><br><span>  * This holds data that pertains to a DSN</span><br><span>  */</span><br><span>diff --git a/include/asterisk/calendar.h b/include/asterisk/calendar.h</span><br><span>index c21399e..9f89f33 100644</span><br><span>--- a/include/asterisk/calendar.h</span><br><span>+++ b/include/asterisk/calendar.h</span><br><span>@@ -91,7 +91,7 @@</span><br><span>       AST_LIST_ENTRY(ast_calendar_attendee) next;</span><br><span> };</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \brief Calendar events */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Calendar events */</span><br><span> struct ast_calendar_event {</span><br><span>      AST_DECLARE_STRING_FIELDS(</span><br><span>           AST_STRING_FIELD(summary);</span><br><span>diff --git a/include/asterisk/channel.h b/include/asterisk/channel.h</span><br><span>index 4c4974a..bc12de8 100644</span><br><span>--- a/include/asterisk/channel.h</span><br><span>+++ b/include/asterisk/channel.h</span><br><span>@@ -1427,7 +1427,7 @@</span><br><span>  * This function will unlink the channel from the global channels container</span><br><span>  * if it is still there and also release the current reference to the channel.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval NULL, convenient for clearing invalid pointers</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL convenient for clearing invalid pointers</span><br><span>  * \note Absolutely _NO_ channel locks should be held before calling this function.</span><br><span>  *</span><br><span>  * \since 1.8</span><br><span>@@ -1738,7 +1738,9 @@</span><br><span>  * \brief Compare a offset with the settings of when to hang a channel up</span><br><span>  * \param chan channel on which to check for hangup</span><br><span>  * \param offset offset in seconds and microseconds from current time</span><br><span style="color: hsl(0, 100%, 40%);">- * \return 1, 0, or -1</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval 1</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval 0</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval -1</span><br><span>  * This function compares a offset from current time with the absolute time</span><br><span>  * out on a channel (when to hang up). If the absolute time out on a channel</span><br><span>  * is earlier than current time plus the offset, it returns 1, if the two</span><br><span>@@ -2952,7 +2954,7 @@</span><br><span>  * This function is used to destroy a channel iterator that was retrieved by</span><br><span>  * using one of the channel_iterator_xxx_new() functions.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return NULL, for convenience to clear out the pointer to the iterator that</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL for convenience to clear out the pointer to the iterator that</span><br><span>  * was just destroyed.</span><br><span>  *</span><br><span>  * \since 1.8</span><br><span>@@ -3029,7 +3031,7 @@</span><br><span>  *</span><br><span>  * \retval the next channel that matches the parameters used when the iterator</span><br><span>  *         was created.</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval NULL, if no more channels match the iterator parameters.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL if no more channels match the iterator parameters.</span><br><span>  *</span><br><span>  * \since 1.8</span><br><span>  */</span><br><span>diff --git a/include/asterisk/cli.h b/include/asterisk/cli.h</span><br><span>index 71468e5..76e58fa 100644</span><br><span>--- a/include/asterisk/cli.h</span><br><span>+++ b/include/asterisk/cli.h</span><br><span>@@ -371,7 +371,7 @@</span><br><span>  */</span><br><span> void ast_cli_print_timestr_fromseconds(int fd, int seconds, const char *prefix);</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \brief Allow a CLI command to be executed while Asterisk is shutting down.</span><br><span>  *</span><br><span>  * CLI commands by defeault are disabled when Asterisk is shutting down. This is</span><br><span>diff --git a/include/asterisk/config.h b/include/asterisk/config.h</span><br><span>index f53116d..06ee1f4 100644</span><br><span>--- a/include/asterisk/config.h</span><br><span>+++ b/include/asterisk/config.h</span><br><span>@@ -1026,7 +1026,7 @@</span><br><span>      butt,</span><br><span> };</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \brief Callback when configuration is updated</span><br><span>  *</span><br><span>  * \param cfg A copy of the configuration that is being changed.</span><br><span>diff --git a/include/asterisk/datastore.h b/include/asterisk/datastore.h</span><br><span>index 7a7d99b..cacbf69 100644</span><br><span>--- a/include/asterisk/datastore.h</span><br><span>+++ b/include/asterisk/datastore.h</span><br><span>@@ -44,8 +44,6 @@</span><br><span>         * It allows a datastore to fix any pointers it saved to the owning channel</span><br><span>   * in case that the owning channel has changed.  Generally, this would happen</span><br><span>         * when the datastore is set to be inherited, and a masquerade occurs.</span><br><span style="color: hsl(0, 100%, 40%);">-   *</span><br><span style="color: hsl(0, 100%, 40%);">-       * \return nothing.</span><br><span>   */</span><br><span>  void (*chan_fixup)(void *data, struct ast_channel *old_chan, struct ast_channel *new_chan);</span><br><span> </span><br><span>@@ -58,8 +56,6 @@</span><br><span>   *</span><br><span>    * This is the same as the above callback, except it is called for the channel</span><br><span>        * being masqueraded into instead of the channel that is masquerading.</span><br><span style="color: hsl(0, 100%, 40%);">-   *</span><br><span style="color: hsl(0, 100%, 40%);">-       * \return nothing.</span><br><span>   */</span><br><span>  void (*chan_breakdown)(void *data, struct ast_channel *old_chan, struct ast_channel *new_chan);</span><br><span> };</span><br><span>diff --git a/include/asterisk/http_websocket.h b/include/asterisk/http_websocket.h</span><br><span>index 323bb9c..d5489fa 100644</span><br><span>--- a/include/asterisk/http_websocket.h</span><br><span>+++ b/include/asterisk/http_websocket.h</span><br><span>@@ -122,7 +122,7 @@</span><br><span>         unsigned int version;</span><br><span>        /*! \brief Callback called when a new session is attempted. Optional. */</span><br><span>     ast_websocket_pre_callback session_attempted;</span><br><span style="color: hsl(0, 100%, 40%);">-   /* \brief Callback called when a new session is established. Mandatory. */</span><br><span style="color: hsl(120, 100%, 40%);">+    /*! \brief Callback called when a new session is established. Mandatory. */</span><br><span>  ast_websocket_callback session_established;</span><br><span> };</span><br><span> </span><br><span>diff --git a/include/asterisk/logger.h b/include/asterisk/logger.h</span><br><span>index 08e90bb..b29f158 100644</span><br><span>--- a/include/asterisk/logger.h</span><br><span>+++ b/include/asterisk/logger.h</span><br><span>@@ -671,8 +671,7 @@</span><br><span>  *</span><br><span>  * \param level The trace level</span><br><span>  * \param indent_type One of the \ref ast_trace_indent_type values</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) A printf style format string</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) Arguments</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ... A printf style format string, optionally with arguments</span><br><span>  *</span><br><span>  */</span><br><span> #define ast_trace_raw(level, indent_type, ...) \</span><br><span>@@ -685,8 +684,7 @@</span><br><span>  * \brief Print a basic trace message</span><br><span>  *</span><br><span>  * \param level The trace level</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) A printf style format string</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) Arguments</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ... A printf style format string, optionally with arguments</span><br><span>  *</span><br><span>  *  This will print the file, line and function at the current indent level</span><br><span>  */</span><br><span>@@ -732,8 +730,7 @@</span><br><span>  * \brief Print a trace message with details when a scope is entered or existed.</span><br><span>  *</span><br><span>  * \param level The trace level</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) A printf style format string</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) Arguments</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ... A printf style format string, optionally with arguments</span><br><span>  *</span><br><span>  *  This will print the file, line and function plus details at the current indent level.</span><br><span>  * \note Like RAII_VAR, this macro must be called before any code in the scope.</span><br><span>@@ -775,8 +772,7 @@</span><br><span>  * \brief Scope Enter</span><br><span>  *</span><br><span>  * \param level The trace level</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) A printf style format string</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) Arguments</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ... A printf style format string, optionally with arguments</span><br><span>  */</span><br><span> #define SCOPE_ENTER(level, ...) \</span><br><span>        int __scope_level = level; \</span><br><span>@@ -797,8 +793,7 @@</span><br><span> /*!</span><br><span>  * \brief Scope Exit</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) A printf style format string</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) Arguments</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ... A printf style format string, optionally with arguments</span><br><span>  *</span><br><span>  * \details</span><br><span>  * This macro can be used at the exit points of a statement block since it just prints the message.</span><br><span>@@ -816,8 +811,7 @@</span><br><span>  * \brief Scope Exit with expression</span><br><span>  *</span><br><span>  * \param __expr An expression to execute after printing the message</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) A printf style format string</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) Arguments</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ... A printf style format string, optionally with arguments</span><br><span>  *</span><br><span>  * \details</span><br><span>  * Handy for getting out of or continuing loops.</span><br><span>@@ -846,8 +840,7 @@</span><br><span> /*!</span><br><span>  * \brief Scope Exit with return</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) A printf style format string</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) Arguments</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ... A printf style format string, optionally with arguments</span><br><span>  *</span><br><span>  * \details</span><br><span>  * This macro can be used at the exit points of a function when no value</span><br><span>@@ -867,8 +860,7 @@</span><br><span>  * \brief Scope Exit with return value</span><br><span>  *</span><br><span>  * \param __return_value The return value</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) A printf style format string</span><br><span style="color: hsl(0, 100%, 40%);">- * \param (optional) Arguments</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ... A printf style format string, optionally with arguments</span><br><span>  *</span><br><span>  * \details</span><br><span>  * This macro can be used at the exit points of a function when a value</span><br><span>diff --git a/include/asterisk/netsock2.h b/include/asterisk/netsock2.h</span><br><span>index 937139f..d863e05 100644</span><br><span>--- a/include/asterisk/netsock2.h</span><br><span>+++ b/include/asterisk/netsock2.h</span><br><span>@@ -819,7 +819,6 @@</span><br><span>  *</span><br><span>  * \param[out] addr The address of the ast_sockaddr to store into</span><br><span>  * \param sa The sockaddr structure (sockaddr_in or sockaddr_in6) to convert</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> #define ast_sockaddr_from_sockaddr(addr,sa)   ast_sockaddr_copy_sockaddr(addr, sa, ast_addressfamily_to_sockaddrsize(((const struct sockaddr*)(sa))->sa_family))</span><br><span> </span><br><span>diff --git a/include/asterisk/pbx.h b/include/asterisk/pbx.h</span><br><span>index bc34b66..c3a6522 100644</span><br><span>--- a/include/asterisk/pbx.h</span><br><span>+++ b/include/asterisk/pbx.h</span><br><span>@@ -1026,7 +1026,7 @@</span><br><span> </span><br><span> int ast_context_add_ignorepat2(struct ast_context *con, const char *ignorepat, const char *registrar);</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \brief Remove an ignorepat</span><br><span>  *</span><br><span>  * \param context context from which to remove the pattern</span><br><span>diff --git a/include/asterisk/res_pjsip.h b/include/asterisk/res_pjsip.h</span><br><span>index 049b5d9..24b452a 100644</span><br><span>--- a/include/asterisk/res_pjsip.h</span><br><span>+++ b/include/asterisk/res_pjsip.h</span><br><span>@@ -3481,8 +3481,6 @@</span><br><span>  * \param data User data to know what to do when transport shuts down.</span><br><span>  *</span><br><span>  * \note The callback does not need to care that data is an ao2 object.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> typedef void (*ast_transport_monitor_shutdown_cb)(void *data);</span><br><span> </span><br><span>diff --git a/include/asterisk/sorcery.h b/include/asterisk/sorcery.h</span><br><span>index b6a9aed..fa19002 100644</span><br><span>--- a/include/asterisk/sorcery.h</span><br><span>+++ b/include/asterisk/sorcery.h</span><br><span>@@ -321,7 +321,7 @@</span><br><span>     /*! \brief Callback for closing a wizard */</span><br><span>  void (*close)(void *data);</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-  /* \brief Callback for whether or not the wizard believes the object is stale */</span><br><span style="color: hsl(120, 100%, 40%);">+      /*! \brief Callback for whether or not the wizard believes the object is stale */</span><br><span>    int (*is_stale)(const struct ast_sorcery *sorcery, void *data, void *object);</span><br><span> </span><br><span>    /*! \brief Optional callback for forcing a reload to occur, even if wizard has determined no changes */</span><br><span>diff --git a/include/asterisk/stasis.h b/include/asterisk/stasis.h</span><br><span>index af9a67c..5cc71f2 100644</span><br><span>--- a/include/asterisk/stasis.h</span><br><span>+++ b/include/asterisk/stasis.h</span><br><span>@@ -1051,8 +1051,6 @@</span><br><span>  * any remote entities publishing state for a device.  e.g., An aggregate</span><br><span>  * MWI message is the old/new MWI counts accumulated from the local and</span><br><span>  * any remote entities publishing to a mailbox.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> typedef void (*cache_aggregate_publish_fn)(struct stasis_topic *topic, struct stasis_message *aggregate);</span><br><span> </span><br><span>diff --git a/include/asterisk/stasis_app_impl.h b/include/asterisk/stasis_app_impl.h</span><br><span>index ce60804..6550030 100644</span><br><span>--- a/include/asterisk/stasis_app_impl.h</span><br><span>+++ b/include/asterisk/stasis_app_impl.h</span><br><span>@@ -51,13 +51,10 @@</span><br><span> /*!</span><br><span>  * \brief Typedef for data destructor for stasis app commands</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param data Data to destroy.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \details</span><br><span>  * This is called during destruction of the command or if we fail to schedule</span><br><span>  * a command. It is passed a pointer to the user-defined data of the command.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param data Data to destroy.</span><br><span>  */</span><br><span> typedef void (*command_data_destructor_fn)(void *data);</span><br><span> </span><br><span>diff --git a/include/asterisk/stasis_app_mailbox.h b/include/asterisk/stasis_app_mailbox.h</span><br><span>index f2a0a56..7db79a8 100644</span><br><span>--- a/include/asterisk/stasis_app_mailbox.h</span><br><span>+++ b/include/asterisk/stasis_app_mailbox.h</span><br><span>@@ -51,15 +51,15 @@</span><br><span>  *        be set to the JSON representation of the mailbox</span><br><span>  *</span><br><span>  * \return stasis mailbox result code indicating success or failure and cause</span><br><span style="color: hsl(0, 100%, 40%);">- * \return \c NULL on error.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL on error.</span><br><span>  */</span><br><span> enum stasis_mailbox_result stasis_app_mailbox_to_json(const char *name, struct ast_json **json);</span><br><span> </span><br><span> /*!</span><br><span style="color: hsl(0, 100%, 40%);">- * brief Convert mailboxes to json array</span><br><span style="color: hsl(120, 100%, 40%);">+ * \brief Convert mailboxes to json array</span><br><span>  *</span><br><span>  * \return JSON representation of the mailboxes</span><br><span style="color: hsl(0, 100%, 40%);">- * \return \c NULL on error.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL on error.</span><br><span>  */</span><br><span> struct ast_json *stasis_app_mailboxes_to_json(void);</span><br><span> </span><br><span>@@ -72,8 +72,8 @@</span><br><span>  * \param old_messages count of old (read) messages in the mailbox</span><br><span>  * \param new_messages count of new (unread) messages in the mailbox</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return 0 if successful</span><br><span style="color: hsl(0, 100%, 40%);">- * \return -1 on internal error.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval 0 if successful</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval -1 on internal error.</span><br><span>  */</span><br><span> int stasis_app_mailbox_update(</span><br><span>        const char *name, int old_messages, int new_messages);</span><br><span>diff --git a/include/asterisk/tcptls.h b/include/asterisk/tcptls.h</span><br><span>index 66918c8..1e66201 100644</span><br><span>--- a/include/asterisk/tcptls.h</span><br><span>+++ b/include/asterisk/tcptls.h</span><br><span>@@ -169,7 +169,7 @@</span><br><span>   */</span><br><span> struct ast_tcptls_session_instance *ast_tcptls_client_start(struct ast_tcptls_session_instance *tcptls_session);</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \brief Creates a client connection's ast_tcptls_session_instance. */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Creates a client connection's ast_tcptls_session_instance. */</span><br><span> struct ast_tcptls_session_instance *ast_tcptls_client_create(struct ast_tcptls_session_args *desc);</span><br><span> </span><br><span> void *ast_tcptls_server_root(void *);</span><br><span>diff --git a/include/asterisk/test.h b/include/asterisk/test.h</span><br><span>index 90e772c..e23aca8 100644</span><br><span>--- a/include/asterisk/test.h</span><br><span>+++ b/include/asterisk/test.h</span><br><span>@@ -172,24 +172,17 @@</span><br><span> /*!</span><br><span>  * \brief Notifies the test suite of a change in application state</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \details</span><br><span>  * Raises a TestEvent manager event with a subtype of StateChange.  Additional parameters</span><br><span>  * The fmt parameter allows additional parameters to be added to the manager event using</span><br><span>  * printf style statement formatting.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param state                The state the application has changed to</span><br><span style="color: hsl(0, 100%, 40%);">- * \param fmt           The message with format parameters to add to the manager event</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span style="color: hsl(0, 100%, 40%);">- */</span><br><span style="color: hsl(0, 100%, 40%);">-void __ast_test_suite_event_notify(const char *file, const char *func, int line, const char *state, const char *fmt, ...)</span><br><span style="color: hsl(0, 100%, 40%);">-  __attribute__((format(printf, 5, 6)));</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-/*!</span><br><span style="color: hsl(0, 100%, 40%);">- * \ref __ast_test_suite_event_notify()</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param s The state the application has changed to</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param f The message with format parameters to add to the manager event</span><br><span>  */</span><br><span> #define ast_test_suite_event_notify(s, f, ...) \</span><br><span>        __ast_test_suite_event_notify(__FILE__, __PRETTY_FUNCTION__, __LINE__, (s), (f), ## __VA_ARGS__)</span><br><span style="color: hsl(120, 100%, 40%);">+void __ast_test_suite_event_notify(const char *file, const char *func, int line, const char *state, const char *fmt, ...)</span><br><span style="color: hsl(120, 100%, 40%);">+   __attribute__((format(printf, 5, 6)));</span><br><span> </span><br><span> #else</span><br><span> </span><br><span>@@ -292,7 +285,7 @@</span><br><span> /*!</span><br><span>  * \brief unregisters a test with the test framework</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param test callback function (required)</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param cb callback function (required)</span><br><span>  *</span><br><span>  * \retval 0 success</span><br><span>  * \retval -1 failure</span><br><span>@@ -302,7 +295,7 @@</span><br><span> /*!</span><br><span>  * \brief registers a test with the test framework</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param test callback function (required)</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param cb callback function (required)</span><br><span>  *</span><br><span>  * \retval 0 success</span><br><span>  * \retval -1 failure</span><br><span>@@ -349,8 +342,6 @@</span><br><span>  *</span><br><span>  * \param test Unit test control structure.</span><br><span>  * \param fmt printf type format string.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> void ast_test_debug(struct ast_test *test, const char *fmt, ...) __attribute__((format(printf, 2, 3)));</span><br><span> </span><br><span>@@ -368,20 +359,17 @@</span><br><span> /*!</span><br><span>  * \brief update test's status during testing.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param test currently executing test</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param t currently executing test</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param f printf type format string</span><br><span>  *</span><br><span>  * \retval 0 success</span><br><span>  * \retval -1 failure</span><br><span>  */</span><br><span style="color: hsl(120, 100%, 40%);">+#define ast_test_status_update(t, f, ...) __ast_test_status_update(__FILE__, __PRETTY_FUNCTION__, __LINE__, (t), (f), ## __VA_ARGS__)</span><br><span> int __ast_test_status_update(const char *file, const char *func, int line, struct ast_test *test, const char *fmt, ...)</span><br><span>        __attribute__((format(printf, 5, 6)));</span><br><span> </span><br><span> /*!</span><br><span style="color: hsl(0, 100%, 40%);">- * \ref __ast_test_status_update()</span><br><span style="color: hsl(0, 100%, 40%);">- */</span><br><span style="color: hsl(0, 100%, 40%);">-#define ast_test_status_update(t, f, ...) __ast_test_status_update(__FILE__, __PRETTY_FUNCTION__, __LINE__, (t), (f), ## __VA_ARGS__)</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(0, 100%, 40%);">-/*!</span><br><span>  * \brief Check a test condition, failing the test if it's not true.</span><br><span>  *</span><br><span>  * \since 12.0.0</span><br><span>diff --git a/main/astmm.c b/main/astmm.c</span><br><span>index 7cb50e3..1b3b95c 100644</span><br><span>--- a/main/astmm.c</span><br><span>+++ b/main/astmm.c</span><br><span>@@ -218,8 +218,6 @@</span><br><span>  * \internal</span><br><span>  *</span><br><span>  * \note If DO_CRASH is not defined then the function returns.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void my_do_crash(void)</span><br><span> {</span><br><span>@@ -282,8 +280,6 @@</span><br><span>  * \brief Wipe the region payload data with a known value.</span><br><span>  *</span><br><span>  * \param reg Region block to be wiped.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void region_data_wipe(struct ast_region *reg)</span><br><span> {</span><br><span>@@ -305,8 +301,6 @@</span><br><span>  * \brief Check the region payload data for memory corruption.</span><br><span>  *</span><br><span>  * \param reg Region block to be checked.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void region_data_check(struct ast_region *reg)</span><br><span> {</span><br><span>@@ -334,8 +328,6 @@</span><br><span>  * \brief Flush the circular array of freed regions.</span><br><span>  *</span><br><span>  * \param freed Already freed region blocks storage.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void freed_regions_flush(struct ast_freed_regions *freed)</span><br><span> {</span><br><span>@@ -361,8 +353,6 @@</span><br><span>  *</span><br><span>  * \param freed Already freed region blocks storage.</span><br><span>  * \param reg Region block to be freed.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void region_free(struct ast_freed_regions *freed, struct ast_region *reg)</span><br><span> {</span><br><span>@@ -393,7 +383,7 @@</span><br><span>  *</span><br><span>  * \param ptr Region payload data pointer.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval region on success.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return region on success.</span><br><span>  * \retval NULL if not found.</span><br><span>  */</span><br><span> static struct ast_region *region_remove(void *ptr)</span><br><span>@@ -426,8 +416,6 @@</span><br><span>  * \brief Check the fences of a region.</span><br><span>  *</span><br><span>  * \param reg Region block to check.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void region_check_fences(struct ast_region *reg)</span><br><span> {</span><br><span>@@ -457,8 +445,6 @@</span><br><span> /*!</span><br><span>  * \internal</span><br><span>  * \brief Check the fences of all regions currently allocated.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void regions_check_all_fences(void)</span><br><span> {</span><br><span>@@ -808,8 +794,6 @@</span><br><span>  * \param selected_len Accumulated size of the selected allocations.</span><br><span>  * \param cache_len Accumulated size of the allocations that are part of a cache.</span><br><span>  * \param count Number of selected allocations.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void print_memory_show_common_stats(int fd,</span><br><span>         unsigned int whales_len,</span><br><span>@@ -1133,8 +1117,6 @@</span><br><span>  * \param list List to put into the allocated regions hash table.</span><br><span>  *</span><br><span>  * \note reglock must be locked before calling.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_hash_restore(struct region_list *list)</span><br><span> {</span><br><span>@@ -1205,8 +1187,6 @@</span><br><span>  * \param list Merge sublists onto this list.</span><br><span>  * \param sub1 First sublist to merge.</span><br><span>  * \param sub2 Second sublist to merge.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_list_merge(struct region_list *list, struct region_list *sub1, struct region_list *sub2)</span><br><span> {</span><br><span>@@ -1242,8 +1222,6 @@</span><br><span>  * \param num_lists Number of lists to remove from the source list.</span><br><span>  * \param size Size of the sublists to remove.</span><br><span>  * \param remaining Remaining number of elements on the source list.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_list_split(struct region_list *list, struct region_list sub[], size_t num_lists, size_t size, size_t *remaining)</span><br><span> {</span><br><span>@@ -1276,8 +1254,6 @@</span><br><span>  *</span><br><span>  * \param list Allocated regions list to sort.</span><br><span>  * \param length Length of the list.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_list_sort(struct region_list *list, size_t length)</span><br><span> {</span><br><span>@@ -1320,8 +1296,6 @@</span><br><span>  * \brief List all regions currently allocated.</span><br><span>  *</span><br><span>  * \param alloced regions list.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_regions_list(struct region_list *alloced)</span><br><span> {</span><br><span>@@ -1339,8 +1313,6 @@</span><br><span>  * \brief Summarize all regions currently allocated.</span><br><span>  *</span><br><span>  * \param alloced Sorted regions list.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_regions_summary(struct region_list *alloced)</span><br><span> {</span><br><span>@@ -1448,8 +1420,6 @@</span><br><span>  * \brief Dump the memory allocations atexit.</span><br><span>  *</span><br><span>  * \note reglock must be locked before calling.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_dump(void)</span><br><span> {</span><br><span>@@ -1484,7 +1454,6 @@</span><br><span> </span><br><span> /*!</span><br><span>  * \internal</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_final(void)</span><br><span> {</span><br><span>@@ -1524,7 +1493,6 @@</span><br><span> </span><br><span> /*!</span><br><span>  * \internal</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void mm_atexit_ast(void)</span><br><span> {</span><br><span>diff --git a/main/astobj2_container.c b/main/astobj2_container.c</span><br><span>index 6437844..2984c23 100644</span><br><span>--- a/main/astobj2_container.c</span><br><span>+++ b/main/astobj2_container.c</span><br><span>@@ -1030,8 +1030,6 @@</span><br><span>  *</span><br><span>  * \param where User data pointer needed to determine where to put output.</span><br><span>  * \param fmt printf type format string.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void cli_output(void *where, const char *fmt, ...) __attribute__((format(printf, 2, 3)));</span><br><span> static void cli_output(void *where, const char *fmt, ...)</span><br><span>diff --git a/main/dns_recurring.c b/main/dns_recurring.c</span><br><span>index 6a953fa..0d97a0b 100644</span><br><span>--- a/main/dns_recurring.c</span><br><span>+++ b/main/dns_recurring.c</span><br><span>@@ -39,7 +39,7 @@</span><br><span> </span><br><span> #include <arpa/nameser.h></span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \brief Delay between TTL expiration and the next DNS query, to make sure the</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Delay between TTL expiration and the next DNS query, to make sure the</span><br><span> resolver cache really expired. */</span><br><span> #define EXTRA_TTL 2</span><br><span> #define MAX_TTL ((INT_MAX - EXTRA_TTL) / 1000)</span><br><span>diff --git a/main/dns_test.c b/main/dns_test.c</span><br><span>index 5ec994a..e6bcc81 100644</span><br><span>--- a/main/dns_test.c</span><br><span>+++ b/main/dns_test.c</span><br><span>@@ -59,7 +59,7 @@</span><br><span>  *</span><br><span>  * \param num_records The number of DNS records in this DNS response</span><br><span>  * \param buf The buffer to write the header into</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval The number of bytes written to the buffer</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return The number of bytes written to the buffer</span><br><span>  */</span><br><span> static int generate_dns_header(unsigned short num_records, char *buf)</span><br><span> {</span><br><span>@@ -97,7 +97,7 @@</span><br><span>  * than necessary for the tests.</span><br><span>  *</span><br><span>  * \param buf The buffer to write the question into</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval The number of bytes written to the buffer</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return The number of bytes written to the buffer</span><br><span>  */</span><br><span> static int generate_dns_question(char *buf)</span><br><span> {</span><br><span>@@ -129,8 +129,9 @@</span><br><span>  * the data ourselves and have sized the buffer to be way larger</span><br><span>  * than necessary for the tests.</span><br><span>  *</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param ttl Time to live</span><br><span>  * \param buf The buffer to write the answer into</span><br><span style="color: hsl(0, 100%, 40%);">- * \retval The number of bytes written to the buffer</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return The number of bytes written to the buffer</span><br><span>  */</span><br><span> static int generate_dns_answer(int ttl, char *buf)</span><br><span> {</span><br><span>@@ -145,20 +146,6 @@</span><br><span>      return ARRAY_LEN(NAPTR_ANSWER);</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*!</span><br><span style="color: hsl(0, 100%, 40%);">- * \brief Write a DNS string to a buffer</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * This writes the DNS string to the buffer and returns the total</span><br><span style="color: hsl(0, 100%, 40%);">- * number of bytes written to the buffer.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * There is no buffer size passed to this function since we provide</span><br><span style="color: hsl(0, 100%, 40%);">- * the data ourselves and have sized the buffer to be way larger</span><br><span style="color: hsl(0, 100%, 40%);">- * than necessary for the tests.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param string The string to write</span><br><span style="color: hsl(0, 100%, 40%);">- * \param buf The buffer to write the string into</span><br><span style="color: hsl(0, 100%, 40%);">- * \return The number of bytes written to the buffer</span><br><span style="color: hsl(0, 100%, 40%);">- */</span><br><span> int ast_dns_test_write_string(const struct ast_dns_test_string *string, char *buf)</span><br><span> {</span><br><span>        uint8_t len = string->len;</span><br><span>@@ -176,23 +163,6 @@</span><br><span>         return actual_len + 1;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*!</span><br><span style="color: hsl(0, 100%, 40%);">- * \brief Write a DNS domain to a buffer</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * A DNS domain consists of a series of labels separated</span><br><span style="color: hsl(0, 100%, 40%);">- * by dots. Each of these labels gets written as a DNS</span><br><span style="color: hsl(0, 100%, 40%);">- * string. A DNS domain ends with a NULL label, which is</span><br><span style="color: hsl(0, 100%, 40%);">- * essentially a zero-length DNS string.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * There is no buffer size passed to this function since we provide</span><br><span style="color: hsl(0, 100%, 40%);">- * the data ourselves and have sized the buffer to be way larger</span><br><span style="color: hsl(0, 100%, 40%);">- * than necessary for the tests.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param string The DNS domain to write</span><br><span style="color: hsl(0, 100%, 40%);">- * \param buf The buffer to write the domain into</span><br><span style="color: hsl(0, 100%, 40%);">- * \return The number of bytes written to the buffer</span><br><span style="color: hsl(0, 100%, 40%);">- */</span><br><span> int ast_dns_test_write_domain(const char *string, char *buf)</span><br><span> {</span><br><span>     char *copy = ast_strdupa(string);</span><br><span>diff --git a/main/optional_api.c b/main/optional_api.c</span><br><span>index afa9661..8f778f3 100644</span><br><span>--- a/main/optional_api.c</span><br><span>+++ b/main/optional_api.c</span><br><span>@@ -88,7 +88,7 @@</span><br><span>  * \param module Name of the module requesting the API.</span><br><span>  *</span><br><span>  * \return New \ref optional_api_user.</span><br><span style="color: hsl(0, 100%, 40%);">- * \return \c NULL on error.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL on error.</span><br><span>  */</span><br><span> static struct optional_api_user *optional_api_user_create(</span><br><span>        ast_optional_fn *optional_ref, ast_optional_fn stub, const char *module)</span><br><span>@@ -129,7 +129,7 @@</span><br><span>  *</span><br><span>  * \param symname Name of the optional function.</span><br><span>  * \return New \ref optional_api.</span><br><span style="color: hsl(0, 100%, 40%);">- * \return \c NULL on error.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL on error.</span><br><span>  */</span><br><span> static struct optional_api *optional_api_create(const char *symname)</span><br><span> {</span><br><span>@@ -151,9 +151,9 @@</span><br><span> /*!</span><br><span>  * \brief Gets (or creates) the \ref optional_api for the given function.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param sysname Name of the function to look up.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param symname Name of the function to look up.</span><br><span>  * \return Corresponding \ref optional_api.</span><br><span style="color: hsl(0, 100%, 40%);">- * \return \c NULL on error.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL on error.</span><br><span>  */</span><br><span> static struct optional_api *get_api(const char *symname)</span><br><span> {</span><br><span>diff --git a/main/pbx.c b/main/pbx.c</span><br><span>index 224f847..986e3ce 100644</span><br><span>--- a/main/pbx.c</span><br><span>+++ b/main/pbx.c</span><br><span>@@ -7061,7 +7061,7 @@</span><br><span>  * \param dst Destination buffer to copy src string.</span><br><span>  * \param src Null terminated string to copy.</span><br><span>  * \param dst_size Number of bytes in the dst buffer.</span><br><span style="color: hsl(0, 100%, 40%);">- * \param nofluf Nonzero if '-' chars are not copied.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param nofluff Nonzero if '-' chars are not copied.</span><br><span>  *</span><br><span>  * \return Number of bytes written to dst including null terminator.</span><br><span>  */</span><br><span>diff --git a/main/stasis_message_router.c b/main/stasis_message_router.c</span><br><span>index 7f2358f..ff7472e 100644</span><br><span>--- a/main/stasis_message_router.c</span><br><span>+++ b/main/stasis_message_router.c</span><br><span>@@ -82,8 +82,6 @@</span><br><span>  * \brief route_table vector element cleanup.</span><br><span>  *</span><br><span>  * \param elem Element to cleanup</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> #define ROUTE_TABLE_ELEM_CLEANUP(elem)  ao2_cleanup((elem).message_type)</span><br><span> </span><br><span>diff --git a/main/test.c b/main/test.c</span><br><span>index 32df829..5135803 100644</span><br><span>--- a/main/test.c</span><br><span>+++ b/main/test.c</span><br><span>@@ -369,7 +369,7 @@</span><br><span>  * \brief Executes registered unit tests</span><br><span>  *</span><br><span>  * \param name of test to run (optional)</span><br><span style="color: hsl(0, 100%, 40%);">- * \param test category to run (optional)</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param category category to run (optional)</span><br><span>  * \param cli args for cli test updates (optional)</span><br><span>  *</span><br><span>  * \return number of tests executed.</span><br><span>@@ -475,9 +475,9 @@</span><br><span>  * \brief Generate test results.</span><br><span>  *</span><br><span>  * \param name of test result to generate (optional)</span><br><span style="color: hsl(0, 100%, 40%);">- * \param test category to generate (optional)</span><br><span style="color: hsl(0, 100%, 40%);">- * \param path to xml file to generate. (optional)</span><br><span style="color: hsl(0, 100%, 40%);">- * \param path to txt file to generate, (optional)</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param category category to generate (optional)</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param xml_path path to xml file to generate (optional)</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param txt_path path to txt file to generate (optional)</span><br><span>  *</span><br><span>  * \retval 0 success</span><br><span>  * \retval -1 failure</span><br><span>@@ -612,7 +612,8 @@</span><br><span>  * \internal</span><br><span>  * \brief removes test from container</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return ast_test removed from list on success, or NULL on failure</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return ast_test removed from list on success</span><br><span style="color: hsl(120, 100%, 40%);">+ * \retval NULL on failure</span><br><span>  */</span><br><span> static struct ast_test *test_remove(ast_test_cb_t *cb)</span><br><span> {</span><br><span>diff --git a/menuselect/menuselect.c b/menuselect/menuselect.c</span><br><span>index 615e29f..3153ce0 100644</span><br><span>--- a/menuselect/menuselect.c</span><br><span>+++ b/menuselect/menuselect.c</span><br><span>@@ -1901,7 +1901,7 @@</span><br><span>    return insane ? -1 : 0;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \brief Set the forced default values if they exist */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Set the forced default values if they exist */</span><br><span> static void process_defaults(void)</span><br><span> {</span><br><span>       struct category *cat;</span><br><span>diff --git a/menuselect/menuselect_curses.c b/menuselect/menuselect_curses.c</span><br><span>index 7698061..b72cb34 100644</span><br><span>--- a/menuselect/menuselect_curses.c</span><br><span>+++ b/menuselect/menuselect_curses.c</span><br><span>@@ -16,7 +16,7 @@</span><br><span>  * at the top of the source tree.</span><br><span>  */</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \file</span><br><span>  *</span><br><span>  * \author Russell Bryant <russell@digium.com></span><br><span>diff --git a/menuselect/menuselect_gtk.c b/menuselect/menuselect_gtk.c</span><br><span>index 624b8db..2e8b5b1 100644</span><br><span>--- a/menuselect/menuselect_gtk.c</span><br><span>+++ b/menuselect/menuselect_gtk.c</span><br><span>@@ -16,7 +16,7 @@</span><br><span>  * at the top of the source tree.</span><br><span>  */</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \file</span><br><span>  *</span><br><span>  * \author Russell Bryant <russell@digium.com></span><br><span>diff --git a/menuselect/menuselect_newt.c b/menuselect/menuselect_newt.c</span><br><span>index b0f7574..abbfb33 100644</span><br><span>--- a/menuselect/menuselect_newt.c</span><br><span>+++ b/menuselect/menuselect_newt.c</span><br><span>@@ -16,7 +16,7 @@</span><br><span>  * at the top of the source tree.</span><br><span>  */</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \file</span><br><span>  *</span><br><span>  * \author Sean Bright <sean.bright@gmail.com></span><br><span>diff --git a/menuselect/menuselect_stub.c b/menuselect/menuselect_stub.c</span><br><span>index 29f731e..b0543f6 100644</span><br><span>--- a/menuselect/menuselect_stub.c</span><br><span>+++ b/menuselect/menuselect_stub.c</span><br><span>@@ -16,7 +16,7 @@</span><br><span>  * at the top of the source tree.</span><br><span>  */</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \file</span><br><span>  *</span><br><span>  * \author Russell Bryant <russell@digium.com></span><br><span>diff --git a/pbx/pbx_dundi.c b/pbx/pbx_dundi.c</span><br><span>index df1f303..9c0f2fa 100644</span><br><span>--- a/pbx/pbx_dundi.c</span><br><span>+++ b/pbx/pbx_dundi.c</span><br><span>@@ -4527,7 +4527,7 @@</span><br><span>           ast_log(LOG_WARNING, "Expected at least %d arguments in map, but got only %d\n", 4, x);</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* \note Called with the peers list already locked */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \note Called with the peers list already locked */</span><br><span> static int do_register(const void *data)</span><br><span> {</span><br><span>     struct dundi_ie_data ied;</span><br><span>diff --git a/pbx/pbx_lua.c b/pbx/pbx_lua.c</span><br><span>index aad4110..f6c0656 100644</span><br><span>--- a/pbx/pbx_lua.c</span><br><span>+++ b/pbx/pbx_lua.c</span><br><span>@@ -174,11 +174,12 @@</span><br><span>  * lua, don't call directly)</span><br><span>  *</span><br><span>  * \param L the lua_State to use</span><br><span style="color: hsl(0, 100%, 40%);">- * \return nothing</span><br><span>  *</span><br><span>  * This funciton is executed as the '()' operator for apps accessed through the</span><br><span>  * 'app' table.</span><br><span>  *</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return LUA error</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span>  * \code</span><br><span>  * app.playback('demo-congrats')</span><br><span>  * \endcode</span><br><span>@@ -293,6 +294,8 @@</span><br><span>  * 'get()' function in the following example as would be seen in</span><br><span>  * extensions.lua.</span><br><span>  *</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return LUA error</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span>  * \code</span><br><span>  * channel.variable:get()</span><br><span>  * \endcode</span><br><span>@@ -353,6 +356,8 @@</span><br><span>  * This function is the 'set()' function in the following example as would be</span><br><span>  * seen in extensions.lua.</span><br><span>  *</span><br><span style="color: hsl(120, 100%, 40%);">+ * \return LUA error</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span>  * \code</span><br><span>  * channel.variable:set("value")</span><br><span>  * \endcode</span><br><span>diff --git a/res/res_odbc.c b/res/res_odbc.c</span><br><span>index 7cc0874..63fdf37 100644</span><br><span>--- a/res/res_odbc.c</span><br><span>+++ b/res/res_odbc.c</span><br><span>@@ -861,7 +861,7 @@</span><br><span>       return max_connections;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span>  * \brief Determine if the connection has died.</span><br><span>  *</span><br><span>  * \param connection The connection to check</span><br><span>diff --git a/res/res_pjsip/config_transport.c b/res/res_pjsip/config_transport.c</span><br><span>index db62076..d0a28cd 100644</span><br><span>--- a/res/res_pjsip/config_transport.c</span><br><span>+++ b/res/res_pjsip/config_transport.c</span><br><span>@@ -1174,8 +1174,8 @@</span><br><span>        return 0;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! \brief Helper function which turns a cipher name into an identifier */</span><br><span> #if defined(PJ_HAS_SSL_SOCK) && PJ_HAS_SSL_SOCK != 0</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Helper function which turns a cipher name into an identifier */</span><br><span> static pj_ssl_cipher cipher_name_to_id(const char *name)</span><br><span> {</span><br><span>    pj_ssl_cipher ciphers[PJ_SSL_SOCK_MAX_CIPHERS];</span><br><span>@@ -1202,7 +1202,7 @@</span><br><span>  * \internal</span><br><span>  * \brief Add a new cipher to the transport's cipher list array.</span><br><span>  *</span><br><span style="color: hsl(0, 100%, 40%);">- * \param transport Which transport to add the cipher to.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \param state Which transport to add the cipher to.</span><br><span>  * \param name Cipher identifier name.</span><br><span>  *</span><br><span>  * \retval 0 on success.</span><br><span>@@ -1240,8 +1240,8 @@</span><br><span> }</span><br><span> #endif</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! \brief Custom handler for TLS cipher setting */</span><br><span> #if defined(PJ_HAS_SSL_SOCK) && PJ_HAS_SSL_SOCK != 0</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Custom handler for TLS cipher setting */</span><br><span> static int transport_tls_cipher_handler(const struct aco_option *opt, struct ast_variable *var, void *obj)</span><br><span> {</span><br><span>      struct ast_sip_transport *transport = obj;</span><br><span>diff --git a/res/res_xmpp.c b/res/res_xmpp.c</span><br><span>index 8db0da8..e9286f4 100644</span><br><span>--- a/res/res_xmpp.c</span><br><span>+++ b/res/res_xmpp.c</span><br><span>@@ -1212,7 +1212,6 @@</span><br><span>  * \brief Delete a PubSub node</span><br><span>  * \param client the configured XMPP client we use to connect to a XMPP server</span><br><span>  * \param node_name the name of the node to delete</span><br><span style="color: hsl(0, 100%, 40%);">- * return void</span><br><span>  */</span><br><span> static void xmpp_pubsub_delete_node(struct ast_xmpp_client *client, const char *node_name)</span><br><span> {</span><br><span>diff --git a/tests/test_astobj2.c b/tests/test_astobj2.c</span><br><span>index ce519ac..ee73cac 100644</span><br><span>--- a/tests/test_astobj2.c</span><br><span>+++ b/tests/test_astobj2.c</span><br><span>@@ -188,8 +188,6 @@</span><br><span>  * \param v_obj A pointer to the object we want the key printed.</span><br><span>  * \param where User data needed by prnt to determine where to put output.</span><br><span>  * \param prnt Print output callback function to use.</span><br><span style="color: hsl(0, 100%, 40%);">- *</span><br><span style="color: hsl(0, 100%, 40%);">- * \return Nothing</span><br><span>  */</span><br><span> static void test_prnt_obj(void *v_obj, void *where, ao2_prnt_fn *prnt)</span><br><span> {</span><br><span>diff --git a/tests/test_astobj2_thrash.c b/tests/test_astobj2_thrash.c</span><br><span>index 1c1c30f..08a7116 100644</span><br><span>--- a/tests/test_astobj2_thrash.c</span><br><span>+++ b/tests/test_astobj2_thrash.c</span><br><span>@@ -73,13 +73,13 @@</span><br><span>     return ast_tvdiff_us(data->deadline, ast_tvnow()) < 0;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! /brief Free test element */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Free test element */</span><br><span> static void ht_delete(void *obj)</span><br><span> {</span><br><span>       ast_atomic_fetchadd_int(&alloc_count, -1);</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! /brief Create test element */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Create test element */</span><br><span> static char *ht_new(int i)</span><br><span> {</span><br><span>       const int buflen = 12;</span><br><span>@@ -94,7 +94,7 @@</span><br><span>   return keybuf;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! /brief Grow the hash data as specified */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Grow the hash data as specified */</span><br><span> static void *hash_test_grow(void *d)</span><br><span> {</span><br><span>     struct hash_test *data = d;</span><br><span>diff --git a/tests/test_hashtab_thrash.c b/tests/test_hashtab_thrash.c</span><br><span>index 854c00c..50e2b75 100644</span><br><span>--- a/tests/test_hashtab_thrash.c</span><br><span>+++ b/tests/test_hashtab_thrash.c</span><br><span>@@ -73,7 +73,7 @@</span><br><span>     return val;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! /brief Create test element */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Create test element */</span><br><span> static char *ht_new(int i)</span><br><span> {</span><br><span>  const int buflen = 12;</span><br><span>@@ -87,13 +87,13 @@</span><br><span>         return keybuf;</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! /brief Free test element */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Free test element */</span><br><span> static void ht_delete(void *obj)</span><br><span> {</span><br><span>     ast_free(obj);</span><br><span> }</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! /brief Grow the hash data as specified */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \brief Grow the hash data as specified */</span><br><span> static void *hash_test_grow(void *d)</span><br><span> {</span><br><span>     struct hash_test *data = d;</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/17588">change 17588</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.asterisk.org/c/asterisk/+/17588"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 18 </div>
<div style="display:none"> Gerrit-Change-Id: If338163488498f65fa7248b60e80299c0a928e4b </div>
<div style="display:none"> Gerrit-Change-Number: 17588 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Alexander Traud <pabstraud@compuserve.com> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>