cosmetic: fix doxygen comment markers
There has obviously been a misunderstanding on how the doxygen comments work.
A comment marked '<' is for placing a comment *after* a member, to point back
to the item before it, typically
enum foo {
thing, /*!< this is a thing */
a_bobby,
}
It does not make sense to place these above the item they are describing.
We actually don't use doxygen in the osmo-mgw build, but if we have doxygen
syntax, we might as well have the correct one.
Change-Id: I9e8ea0e3bd5ae5fcc0a6fae8e26e11baa8f35e27
diff --git a/include/osmocom/mgcp/mgcp_endp.h b/include/osmocom/mgcp/mgcp_endp.h
index 9283373..3876794 100644
--- a/include/osmocom/mgcp/mgcp_endp.h
+++ b/include/osmocom/mgcp/mgcp_endp.h
@@ -42,13 +42,13 @@
/*! MGCP endpoint properties */
struct mgcp_endpoint_type {
- /*!< maximum number of connections */
+ /*! maximum number of connections */
int max_conns;
- /*!< callback that defines how to dispatch incoming RTP data */
+ /*! callback that defines how to dispatch incoming RTP data */
mgcp_dispatch_rtp_cb dispatch_rtp_cb;
- /*!< callback that implements endpoint specific cleanup actions */
+ /*! callback that implements endpoint specific cleanup actions */
mgcp_cleanup_cp cleanup_cb;
};
@@ -63,31 +63,31 @@
/*! MGCP endpoint model */
struct mgcp_endpoint {
- /*!< Call identifier string (as supplied by the call agant) */
+ /*! Call identifier string (as supplied by the call agant) */
char *callid;
- /*!< Local connection options (see mgcp_internal.h) */
+ /*! Local connection options (see mgcp_internal.h) */
struct mgcp_lco local_options;
- /*!< List with connections active on this endpoint */
+ /*! List with connections active on this endpoint */
struct llist_head conns;
- /*!< Backpointer to the MGW configuration */
+ /*! Backpointer to the MGW configuration */
struct mgcp_config *cfg;
- /*!< Backpointer to the Trunk specific configuration */
+ /*! Backpointer to the Trunk specific configuration */
struct mgcp_trunk_config *tcfg;
- /*!< Endpoint properties (see above) */
+ /*! Endpoint properties (see above) */
const struct mgcp_endpoint_type *type;
- /*!< Last MGCP transmission (in case re-transmission is required) */
+ /*! Last MGCP transmission (in case re-transmission is required) */
char *last_trans;
- /*!< Last MGCP response (in case re-transmission is required) */
+ /*! Last MGCP response (in case re-transmission is required) */
char *last_response;
- /*!< Memorize if this endpoint was choosen by the MGW (wildcarded, true)
+ /*! Memorize if this endpoint was choosen by the MGW (wildcarded, true)
* or if the user has choosen the particular endpoint explicitly. */
bool wildcarded_req;
};