<p>Kevin Harwell <strong>submitted</strong> this change.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/17334">View Change</a></p><div style="white-space:pre-wrap">Approvals:
  Kevin Harwell: Looks good to me, approved; Approved for Submit
  Benjamin Keith Ford: Looks good to me, but someone else must approve

</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">progdocs: Fix grouping for latest Doxygen.<br><br>Since Doxygen 1.8.16, a special comment block is required. Otherwise<br>(pure C comment), the group command is ignored. Additionally, several<br>unbalanced group commands were fixed.<br><br>ASTERISK-29732<br><br>Change-Id: I4687857b9d56e6f44fd440b73af156691660202e<br>---<br>M channels/chan_sip.c<br>M channels/sip/include/sip.h<br>M include/asterisk/adsi.h<br>M include/asterisk/app.h<br>M include/asterisk/astmm.h<br>M include/asterisk/astobj2.h<br>M include/asterisk/causes.h<br>M include/asterisk/manager.h<br>M include/asterisk/mwi.h<br>M include/asterisk/netsock2.h<br>M include/asterisk/pbx.h<br>M include/asterisk/rtp_engine.h<br>M include/asterisk/smoother.h<br>M include/asterisk/stasis_app_mailbox.h<br>M include/asterisk/term.h<br>M include/asterisk/transcap.h<br>M include/jitterbuf.h<br>M main/app.c<br>M main/mwi.c<br>19 files changed, 92 insertions(+), 64 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/channels/chan_sip.c b/channels/chan_sip.c</span><br><span>index 3e310e1..e19e19d 100644</span><br><span>--- a/channels/chan_sip.c</span><br><span>+++ b/channels/chan_sip.c</span><br><span>@@ -867,7 +867,6 @@</span><br><span> </span><br><span> static int global_dynamic_exclude_static = 0; /*!< Exclude static peers from contact registrations */</span><br><span> static unsigned char global_refer_addheaders; /*!< Add extra headers to outgoing REFER */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@}*/</span><br><span> </span><br><span> /*!</span><br><span>  * We use libxml2 in order to parse XML that may appear in the body of a SIP message. Currently,</span><br><span>@@ -877,10 +876,12 @@</span><br><span>  */</span><br><span> static int can_parse_xml;</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! \name Object counters @{</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \name Object counters</span><br><span>  *</span><br><span>  * \bug These counters are not handled in a thread-safe way ast_atomic_fetchadd_int()</span><br><span>  * should be used to modify these values.</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span> static int speerobjs = 0;     /*!< Static peers */</span><br><span> static int rpeerobjs = 0;     /*!< Realtime peers */</span><br><span>diff --git a/channels/sip/include/sip.h b/channels/sip/include/sip.h</span><br><span>index bcc1cf8..1396d81 100644</span><br><span>--- a/channels/sip/include/sip.h</span><br><span>+++ b/channels/sip/include/sip.h</span><br><span>@@ -185,8 +185,9 @@</span><br><span>    These are default values in the source. There are other recommended values in the</span><br><span>    sip.conf.sample for new installations. These may differ to keep backwards compatibility,</span><br><span>    yet encouraging new behaviour on new installations</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+   @{</span><br><span>  */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{*/</span><br><span> #define DEFAULT_CONTEXT        "default"  /*!< The default context for [general] section as well as devices */</span><br><span> #define DEFAULT_RECORD_FEATURE   "automon"  /*!< The default feature specified for use with INFO */</span><br><span> #define DEFAULT_MOHINTERPRET   "default"  /*!< The default music class */</span><br><span>@@ -235,7 +236,8 @@</span><br><span> #define DEFAULT_ENGINE     "asterisk"      /*!< Default RTP engine to use for sessions */</span><br><span> #define DEFAULT_STORE_SIP_CAUSE FALSE      /*!< Don't store HASH(SIP_CAUSE,<channel name>) for channels by default */</span><br><span> #endif</span><br><span style="color: hsl(0, 100%, 40%);">-/*@}*/</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> /*! \name SIPflags</span><br><span>        Various flags for the flags field in the pvt structure</span><br><span>@@ -245,8 +247,8 @@</span><br><span>         G: Global flag</span><br><span>       When flags are used by multiple structures, it is important that</span><br><span>     they have a common layout so it is easy to copy them.</span><br><span style="color: hsl(0, 100%, 40%);">-*/</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{*/</span><br><span style="color: hsl(120, 100%, 40%);">+   @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> #define SIP_OUTGOING        (1 << 0) /*!< D: Direction of the last transaction in this dialog */</span><br><span> #define SIP_OFFER_CC        (1 << 1) /*!< D: Offer CC on subsequent responses */</span><br><span> #define SIP_RINGING         (1 << 2) /*!< D: Have sent 180 ringing */</span><br><span>@@ -307,11 +309,13 @@</span><br><span>        (SIP_PROMISCREDIR | SIP_TRUSTRPID | SIP_SENDRPID | SIP_DTMF | SIP_REINVITE | \</span><br><span>        SIP_PROG_INBAND | SIP_USECLIENTCODE | SIP_NAT_FORCE_RPORT | SIP_G726_NONSTANDARD | \</span><br><span>         SIP_USEREQPHONE | SIP_INSECURE | SIP_USEPATH)</span><br><span style="color: hsl(0, 100%, 40%);">-/*@}*/</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> /*! \name SIPflags2</span><br><span style="color: hsl(0, 100%, 40%);">-    a second page of flags (for flags[1] */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{*/</span><br><span style="color: hsl(120, 100%, 40%);">+ a second page of flags (for flags[1]</span><br><span style="color: hsl(120, 100%, 40%);">+   @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> /* realtime flags */</span><br><span> #define SIP_PAGE2_RTCACHEFRIENDS            (1 <<  0)   /*!< GP: Should we keep RT objects in memory for extended time? */</span><br><span> #define SIP_PAGE2_RTAUTOCLEAR               (1 <<  1)   /*!< GP: Should we clean memory from peers after expiry? */</span><br><span>@@ -393,7 +397,7 @@</span><br><span> </span><br><span> #define CHECK_AUTH_BUF_INITLEN   256</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*@}*/</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> /*----------------------------------------------------------*/</span><br><span> /*----                    ENUMS                         ----*/</span><br><span>@@ -731,8 +735,8 @@</span><br><span> /*! \name GlobalSettings</span><br><span>     Global settings apply to the channel (often settings you can change in the general section</span><br><span>   of sip.conf</span><br><span style="color: hsl(0, 100%, 40%);">-*/</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{*/</span><br><span style="color: hsl(120, 100%, 40%);">+   @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> /*! \brief a place to store all global settings for the sip channel driver</span><br><span> </span><br><span>    These are settings that will be possibly to apply on a group level later on.</span><br><span>@@ -784,6 +788,8 @@</span><br><span>   int websocket_enabled;       /*!< Are websockets enabled? */</span><br><span> };</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> struct ast_websocket;</span><br><span> </span><br><span> /*! \brief The SIP socket definition */</span><br><span>diff --git a/include/asterisk/adsi.h b/include/asterisk/adsi.h</span><br><span>index 9834b91..9c383e9 100644</span><br><span>--- a/include/asterisk/adsi.h</span><br><span>+++ b/include/asterisk/adsi.h</span><br><span>@@ -26,7 +26,7 @@</span><br><span> #include "asterisk/callerid.h"</span><br><span> </span><br><span> /*! \name ADSI parameters */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @{ */</span><br><span> </span><br><span> /* ADSI Message types */</span><br><span> #define ADSI_MSG_DISPLAY       132</span><br><span>@@ -122,7 +122,7 @@</span><br><span> </span><br><span> #define AST_ADSI_VERSION 1</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> int ast_adsi_begin_download(struct ast_channel *chan, char *service, unsigned char *fdn, unsigned char *sec, int version);</span><br><span> </span><br><span>diff --git a/include/asterisk/app.h b/include/asterisk/app.h</span><br><span>index 3fed048..fab080c3 100644</span><br><span>--- a/include/asterisk/app.h</span><br><span>+++ b/include/asterisk/app.h</span><br><span>@@ -1510,7 +1510,6 @@</span><br><span>  * \since 12</span><br><span>  */</span><br><span> struct stasis_topic *ast_queue_topic(const char *queuename);</span><br><span style="color: hsl(0, 100%, 40%);">-/*! @} */</span><br><span> </span><br><span> /*!</span><br><span>  * \brief Initialize the application core</span><br><span>diff --git a/include/asterisk/astmm.h b/include/asterisk/astmm.h</span><br><span>index ba444bb..1f4ec95 100644</span><br><span>--- a/include/asterisk/astmm.h</span><br><span>+++ b/include/asterisk/astmm.h</span><br><span>@@ -108,9 +108,7 @@</span><br><span>  */</span><br><span> #define ASTMM_IGNORE   2</span><br><span> </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%);">- */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> #if !defined(ASTMM_LIBC)</span><br><span> /* BLOCK libc allocators by default. */</span><br><span>diff --git a/include/asterisk/astobj2.h b/include/asterisk/astobj2.h</span><br><span>index c32b743..45ae509 100644</span><br><span>--- a/include/asterisk/astobj2.h</span><br><span>+++ b/include/asterisk/astobj2.h</span><br><span>@@ -1281,8 +1281,9 @@</span><br><span> </span><br><span> /*! \name Object Containers</span><br><span>  * Here start declarations of containers.</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span> struct ao2_container;</span><br><span> </span><br><span> /*!</span><br><span>@@ -1517,15 +1518,16 @@</span><br><span>  */</span><br><span> void ao2_container_unregister(const char *name);</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> /*! \name Object Management</span><br><span>  * Here we have functions to manage objects.</span><br><span>  *</span><br><span>  * We can use the functions below on any kind of</span><br><span>  * object defined by the user.</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span> </span><br><span> /*!</span><br><span>  * \brief Add an object to a container.</span><br><span>@@ -1625,7 +1627,7 @@</span><br><span> void *__ao2_unlink(struct ao2_container *c, void *obj, int flags,</span><br><span>     const char *tag, const char *file, int line, const char *func);</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> </span><br><span> /*! \brief</span><br><span>diff --git a/include/asterisk/causes.h b/include/asterisk/causes.h</span><br><span>index 490ae9e..af5e8d5 100644</span><br><span>--- a/include/asterisk/causes.h</span><br><span>+++ b/include/asterisk/causes.h</span><br><span>@@ -92,8 +92,9 @@</span><br><span> /*! \name Causes for disconnection (from Q.850/Q.931)</span><br><span>  *  These are the internal cause codes used in Asterisk.</span><br><span>  *  \ref AstCauses</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span> #define AST_CAUSE_UNALLOCATED                    1</span><br><span> #define AST_CAUSE_NO_ROUTE_TRANSIT_NET           2</span><br><span> #define AST_CAUSE_NO_ROUTE_DESTINATION           3</span><br><span>@@ -153,6 +154,7 @@</span><br><span> #define AST_CAUSE_UNREGISTERED  AST_CAUSE_SUBSCRIBER_ABSENT</span><br><span> #define AST_CAUSE_NOTDEFINED    0</span><br><span> #define AST_CAUSE_NOSUCHDRIVER  AST_CAUSE_CHAN_NOT_IMPLEMENTED</span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> #endif /* _ASTERISK_CAUSES_H */</span><br><span>diff --git a/include/asterisk/manager.h b/include/asterisk/manager.h</span><br><span>index 4fbb3d8..b9291da 100644</span><br><span>--- a/include/asterisk/manager.h</span><br><span>+++ b/include/asterisk/manager.h</span><br><span>@@ -59,15 +59,19 @@</span><br><span> #define DEFAULT_MANAGER_TLS_PORT 5039       /* Default port for Asterisk management via TCP */</span><br><span> </span><br><span> /*! \name Constant return values</span><br><span style="color: hsl(0, 100%, 40%);">- *\note Currently, returning anything other than zero causes the session to terminate.</span><br><span style="color: hsl(120, 100%, 40%);">+ * \note Currently, returning anything other than zero causes the session to terminate.</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span> #define   AMI_SUCCESS     (0)</span><br><span> #define  AMI_DESTROY     (-1)</span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! \name Manager event classes */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \name Manager event classes</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> #define EVENT_FLAG_SYSTEM           (1 << 0) /* System events such as module load/unload */</span><br><span> #define EVENT_FLAG_CALL             (1 << 1) /* Call event, such as state change, etc */</span><br><span> #define EVENT_FLAG_LOG              (1 << 2) /* Log events */</span><br><span>@@ -89,7 +93,8 @@</span><br><span> #define EVENT_FLAG_SECURITY         (1 << 18) /* Security Message as AMI Event */</span><br><span> /*XXX Why shifted by 30? XXX */</span><br><span> #define EVENT_FLAG_MESSAGE          (1 << 30) /* MESSAGE events. */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> /*! \brief Export manager structures */</span><br><span> #define AST_MAX_MANHEADERS 128</span><br><span>diff --git a/include/asterisk/mwi.h b/include/asterisk/mwi.h</span><br><span>index 3ce2b06..cb14963 100644</span><br><span>--- a/include/asterisk/mwi.h</span><br><span>+++ b/include/asterisk/mwi.h</span><br><span>@@ -446,8 +446,8 @@</span><br><span>  */</span><br><span> int ast_delete_mwi_state_full(const char *mailbox, const char *context, struct ast_eid *eid);</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! \addtogroup StasisTopicsAndMessages</span><br><span style="color: hsl(0, 100%, 40%);">- * @{</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span style="color: hsl(120, 100%, 40%);">+ * \addtogroup StasisTopicsAndMessages</span><br><span>  */</span><br><span> </span><br><span> /*!</span><br><span>diff --git a/include/asterisk/netsock2.h b/include/asterisk/netsock2.h</span><br><span>index 937139f..c1eaec1 100644</span><br><span>--- a/include/asterisk/netsock2.h</span><br><span>+++ b/include/asterisk/netsock2.h</span><br><span>@@ -752,8 +752,9 @@</span><br><span>  * These are backward compatibility functions that may be used by subsystems</span><br><span>  * that have not yet been converted to IPv6. They will be removed when all</span><br><span>  * subsystems are IPv6-ready.</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{*/</span><br><span> </span><br><span> /*!</span><br><span>  * \since 1.8</span><br><span>@@ -823,7 +824,7 @@</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 style="color: hsl(0, 100%, 40%);">-/*@}*/</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> #if defined(__cplusplus) || defined(c_plusplus)</span><br><span> }</span><br><span>diff --git a/include/asterisk/pbx.h b/include/asterisk/pbx.h</span><br><span>index bc34b66..fab8795 100644</span><br><span>--- a/include/asterisk/pbx.h</span><br><span>+++ b/include/asterisk/pbx.h</span><br><span>@@ -1401,9 +1401,9 @@</span><br><span> void pbx_substitute_variables_varshead(struct varshead *headp, const char *cp1, char *cp2, int count);</span><br><span> void pbx_substitute_variables_helper_full(struct ast_channel *c, struct varshead *headp, const char *cp1, char *cp2, int cp2_size, size_t *used);</span><br><span> /*! @} */</span><br><span style="color: hsl(0, 100%, 40%);">-/*! @} */</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! @name Substitution routines, using dynamic string buffers */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @name Substitution routines, using dynamic string buffers</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{ */</span><br><span> </span><br><span> /*!</span><br><span>  * \param buf Result will be placed in this buffer.</span><br><span>diff --git a/include/asterisk/rtp_engine.h b/include/asterisk/rtp_engine.h</span><br><span>index bd945cf..ac2370d 100644</span><br><span>--- a/include/asterisk/rtp_engine.h</span><br><span>+++ b/include/asterisk/rtp_engine.h</span><br><span>@@ -2723,6 +2723,8 @@</span><br><span>  */</span><br><span> struct stasis_message_type *ast_rtp_rtcp_received_type(void);</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span> #ifdef TEST_FRAMEWORK</span><br><span> /*!</span><br><span>  * \brief Get the maximum size of the receive buffer</span><br><span>@@ -2898,8 +2900,6 @@</span><br><span> #define ast_debug_ice(sublevel, ...) \</span><br><span>  ast_debug_category(sublevel, AST_DEBUG_CATEGORY_ICE, __VA_ARGS__)</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/* @} */</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span> #if defined(__cplusplus) || defined(c_plusplus)</span><br><span> }</span><br><span> #endif</span><br><span>diff --git a/include/asterisk/smoother.h b/include/asterisk/smoother.h</span><br><span>index 65ac889..be3c52a 100644</span><br><span>--- a/include/asterisk/smoother.h</span><br><span>+++ b/include/asterisk/smoother.h</span><br><span>@@ -36,8 +36,9 @@</span><br><span> #define AST_SMOOTHER_FLAG_FORCED        (1 << 2)</span><br><span> </span><br><span> /*! \name AST_Smoother</span><br><span style="color: hsl(0, 100%, 40%);">-*/</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> /*! \page ast_smooth The AST Frame Smoother</span><br><span> The ast_smoother interface was designed specifically</span><br><span> to take frames of variant sizes and produce frames of a single expected</span><br><span>@@ -81,7 +82,8 @@</span><br><span> #define ast_smoother_feed_be(s,f) __ast_smoother_feed(s, f, 0)</span><br><span> #define ast_smoother_feed_le(s,f) __ast_smoother_feed(s, f, 1)</span><br><span> #endif</span><br><span style="color: hsl(0, 100%, 40%);">-/*@} Doxygen marker */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> #if defined(__cplusplus) || defined(c_plusplus)</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..becfe46 100644</span><br><span>--- a/include/asterisk/stasis_app_mailbox.h</span><br><span>+++ b/include/asterisk/stasis_app_mailbox.h</span><br><span>@@ -31,8 +31,6 @@</span><br><span> #include "asterisk/app.h"</span><br><span> #include "asterisk/stasis_app.h"</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! @{ */</span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span> /*! Stasis mailbox operation result codes */</span><br><span> enum stasis_mailbox_result {</span><br><span>      /*! Mailbox operation completed successfully */</span><br><span>diff --git a/include/asterisk/term.h b/include/asterisk/term.h</span><br><span>index f91b047..f13ba55 100644</span><br><span>--- a/include/asterisk/term.h</span><br><span>+++ b/include/asterisk/term.h</span><br><span>@@ -30,8 +30,9 @@</span><br><span> #define ESC 0x1b</span><br><span> </span><br><span> /*! \name Terminal Attributes</span><br><span style="color: hsl(0, 100%, 40%);">-*/</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> #define ATTR_RESET    0</span><br><span> #define ATTR_BRIGHT        1</span><br><span> #define ATTR_DIM   2</span><br><span>@@ -39,11 +40,13 @@</span><br><span> #define ATTR_BLINK   5</span><br><span> #define ATTR_REVER 7</span><br><span> #define ATTR_HIDDEN        8</span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> /*! \name Terminal Colors</span><br><span style="color: hsl(0, 100%, 40%);">-*/</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> #define COLOR_BLACK     30</span><br><span> #define COLOR_GRAY      (30 | 128)</span><br><span> #define COLOR_RED       31</span><br><span>@@ -60,7 +63,8 @@</span><br><span> #define COLOR_BRCYAN    (36 | 128)</span><br><span> #define COLOR_WHITE     37</span><br><span> #define COLOR_BRWHITE   (37 | 128)</span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> /*! \brief Shortcut macros for coloring a set of text</span><br><span>  */</span><br><span>diff --git a/include/asterisk/transcap.h b/include/asterisk/transcap.h</span><br><span>index 1eca28d..0f3b22e 100644</span><br><span>--- a/include/asterisk/transcap.h</span><br><span>+++ b/include/asterisk/transcap.h</span><br><span>@@ -29,8 +29,9 @@</span><br><span>  */</span><br><span> </span><br><span> /*! \name AstTranscode General Asterisk channel transcoding definitions.</span><br><span style="color: hsl(0, 100%, 40%);">-*/</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span style="color: hsl(120, 100%, 40%);">+ *</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> #define AST_TRANS_CAP_SPEECH                            0x0</span><br><span> #define AST_TRANS_CAP_DIGITAL                            0x08</span><br><span> #define AST_TRANS_CAP_RESTRICTED_DIGITAL                0x09</span><br><span>@@ -38,7 +39,8 @@</span><br><span> #define AST_TRANS_CAP_7K_AUDIO                              0x11    /* Depriciated ITU Q.931 (05/1998)*/</span><br><span> #define AST_TRANS_CAP_DIGITAL_W_TONES                   0x11</span><br><span> #define AST_TRANS_CAP_VIDEO                             0x18</span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> #define IS_DIGITAL(cap)\</span><br><span>     (cap) & AST_TRANS_CAP_DIGITAL ? 1 : 0</span><br><span>diff --git a/include/jitterbuf.h b/include/jitterbuf.h</span><br><span>index 9e453a9..704e1f7 100644</span><br><span>--- a/include/jitterbuf.h</span><br><span>+++ b/include/jitterbuf.h</span><br><span>@@ -27,8 +27,9 @@</span><br><span> extern "C" {</span><br><span> #endif</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*! \name configuration constants */</span><br><span style="color: hsl(0, 100%, 40%);">-/*@{ */</span><br><span style="color: hsl(120, 100%, 40%);">+/*! \name configuration constants</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span>     /*! Number of historical timestamps to use in calculating jitter and drift */</span><br><span> #define JB_HISTORY_SZ          500</span><br><span>  /*! what percentage of timestamps should we drop from the history when we examine it;</span><br><span>@@ -42,7 +43,8 @@</span><br><span> #define JB_TARGET_EXTRA 40</span><br><span>      /*! ms between growing and shrinking; may not be honored if jitterbuffer runs out of space */</span><br><span> #define JB_ADJUST_DELAY 40</span><br><span style="color: hsl(0, 100%, 40%);">-/*@} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> enum jb_return_code {</span><br><span>         /* return codes */</span><br><span>diff --git a/main/app.c b/main/app.c</span><br><span>index aff690e..3263579 100644</span><br><span>--- a/main/app.c</span><br><span>+++ b/main/app.c</span><br><span>@@ -83,12 +83,14 @@</span><br><span> #ifdef HAVE_CAP</span><br><span> static cap_t child_cap;</span><br><span> #endif</span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(0, 100%, 40%);">- * @{ \brief Define \ref stasis topic objects</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span style="color: hsl(120, 100%, 40%);">+ * \brief Define \ref stasis topic objects</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span> static struct stasis_topic *queue_topic_all;</span><br><span> static struct stasis_topic_pool *queue_topic_pool;</span><br><span style="color: hsl(0, 100%, 40%);">-/* @} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> static void *shaun_of_the_dead(void *data)</span><br><span> {</span><br><span>diff --git a/main/mwi.c b/main/mwi.c</span><br><span>index e81766c..2d7ede3 100644</span><br><span>--- a/main/mwi.c</span><br><span>+++ b/main/mwi.c</span><br><span>@@ -26,13 +26,15 @@</span><br><span> #include "asterisk/mwi.h"</span><br><span> #include "asterisk/stasis_channels.h"</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-/*</span><br><span style="color: hsl(0, 100%, 40%);">- * @{ \brief Define \ref stasis topic objects</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span style="color: hsl(120, 100%, 40%);">+ * \brief Define \ref stasis topic objects</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span> static struct stasis_state_manager *mwi_state_manager;</span><br><span> static struct stasis_cache *mwi_state_cache;</span><br><span> static struct stasis_caching_topic *mwi_topic_cached;</span><br><span style="color: hsl(0, 100%, 40%);">-/* @} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> /*! \brief Convert a MWI \ref stasis_message to a \ref ast_event */</span><br><span> static struct ast_event *mwi_to_event(struct stasis_message *message)</span><br><span>@@ -66,13 +68,15 @@</span><br><span>       return event;</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 Define \ref stasis message types for MWI</span><br><span style="color: hsl(120, 100%, 40%);">+/*!</span><br><span style="color: hsl(120, 100%, 40%);">+ * \brief Define \ref stasis message types for MWI</span><br><span style="color: hsl(120, 100%, 40%);">+ * @{</span><br><span>  */</span><br><span> STASIS_MESSAGE_TYPE_DEFN(ast_mwi_state_type,</span><br><span>         .to_event = mwi_to_event, );</span><br><span> STASIS_MESSAGE_TYPE_DEFN(ast_mwi_vm_app_type);</span><br><span style="color: hsl(0, 100%, 40%);">-/* @} */</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+/*! @} */</span><br><span> </span><br><span> static void mwi_state_dtor(void *obj)</span><br><span> {</span><br><span></span><br></pre><div style="white-space:pre-wrap"></div><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/17334">change 17334</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/+/17334"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I4687857b9d56e6f44fd440b73af156691660202e </div>
<div style="display:none"> Gerrit-Change-Number: 17334 </div>
<div style="display:none"> Gerrit-PatchSet: 4 </div>
<div style="display:none"> Gerrit-Owner: Alexander Traud <pabstraud@compuserve.com> </div>
<div style="display:none"> Gerrit-Reviewer: Benjamin Keith Ford <bford@digium.com> </div>
<div style="display:none"> Gerrit-Reviewer: Friendly Automation </div>
<div style="display:none"> Gerrit-Reviewer: Kevin Harwell <kharwell@digium.com> </div>
<div style="display:none"> Gerrit-CC: Joshua Colp <jcolp@sangoma.com> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>