stasis: Fix for Doxygen.

ASTERISK-29750

Change-Id: Iea50173e785b2e9d49bc24c0af7111cfd96d44a9

res/stasis/app.h

@@ -55,8 +55,9 @@ enum stasis_app_subscription_model {
  * \param name Name of the application.
  * \param handler Callback for messages sent to the application.
  * \param data Data pointer provided to the callback.
+ * \param subscription_model
  * \return New \c res_stasis application.
- * \return \c NULL on error.
+ * \retval NULL on error.
  */
 struct stasis_app *app_create(const char *name, stasis_app_cb handler, void *data, enum stasis_app_subscription_model subscription_model);
 
@@ -83,8 +84,8 @@ void app_deactivate(struct stasis_app *app);
  * \brief Checks whether an app is active.
  *
  * \param app Application to check.
- * \return True (non-zero) if app is active.
- * \return False (zero) if app has been deactivated.
+ * \retval True (non-zero) if app is active.
+ * \retval False (zero) if app has been deactivated.
  */
 int app_is_active(struct stasis_app *app);
 
@@ -92,8 +93,8 @@ int app_is_active(struct stasis_app *app);
  * \brief Checks whether a deactivated app has no channels.
  *
  * \param app Application to check.
- * \param True (non-zero) if app is deactivated, and has no associated channels.
- * \param False (zero) otherwise.
+ * \retval True (non-zero) if app is deactivated, and has no associated channels.
+ * \retval False (zero) otherwise.
  */
 int app_is_finished(struct stasis_app *app);
 
@@ -111,7 +112,7 @@ void app_update(struct stasis_app *app, stasis_app_cb handler, void *data);
 /*!
  * \brief Send a message to an application.
  *
- * \param app Application.
+ * \param app App to send the message to.
  * \param message Message to send.
  */
 void app_send(struct stasis_app *app, struct ast_json *message);
@@ -123,8 +124,8 @@ struct app_forwards;
  *
  * \param app The application
  *
- * \return \c JSON blob on success
- * \return \c NULL on error
+ * \return JSON blob on success
+ * \retval NULL on error
  */
 struct ast_json *app_to_json(const struct stasis_app *app);
 
@@ -133,8 +134,8 @@ struct ast_json *app_to_json(const struct stasis_app *app);
  *
  * \param app Application.
  * \param chan Channel to subscribe to.
- * \return 0 on success.
- * \return Non-zero on error.
+ * \retval 0 on success.
+ * \retval Non-zero on error.
  */
 int app_subscribe_channel(struct stasis_app *app, struct ast_channel *chan);
 
@@ -143,8 +144,8 @@ int app_subscribe_channel(struct stasis_app *app, struct ast_channel *chan);
  *
  * \param app Subscribing application.
  * \param chan Channel to unsubscribe from.
- * \return 0 on success.
- * \return Non-zero on error.
+ * \retval 0 on success.
+ * \retval Non-zero on error.
  */
 int app_unsubscribe_channel(struct stasis_app *app, struct ast_channel *chan);
 
@@ -153,8 +154,8 @@ int app_unsubscribe_channel(struct stasis_app *app, struct ast_channel *chan);
  *
  * \param app Subscribing application.
  * \param channel_id Id of channel to unsubscribe from.
- * \return 0 on success.
- * \return Non-zero on error.
+ * \retval 0 on success.
+ * \retval Non-zero on error.
  */
 int app_unsubscribe_channel_id(struct stasis_app *app, const char *channel_id);
 
@@ -163,8 +164,8 @@ int app_unsubscribe_channel_id(struct stasis_app *app, const char *channel_id);
  *
  * \param app Subscribing application.
  * \param channel_id Id of channel to check.
- * \return True (non-zero) if channel is subscribed to \a app.
- * \return False (zero) if channel is not subscribed.
+ * \retval True (non-zero) if channel is subscribed to \a app.
+ * \retval False (zero) if channel is not subscribed.
  */
 int app_is_subscribed_channel_id(struct stasis_app *app, const char *channel_id);
 
@@ -173,18 +174,18 @@ int app_is_subscribed_channel_id(struct stasis_app *app, const char *channel_id)
  *
  * \param app Application.
  * \param bridge Bridge to subscribe to.
- * \return 0 on success.
- * \return Non-zero on error.
+ * \retval 0 on success.
+ * \retval Non-zero on error.
  */
 int app_subscribe_bridge(struct stasis_app *app, struct ast_bridge *bridge);
 
 /*!
  * \brief Cancel the bridge subscription for an application.
  *
- * \param forwards Return from app_subscribe_channel().
+ * \param app Subscribing application.
  * \param bridge Bridge to subscribe to.
- * \return 0 on success.
- * \return Non-zero on error.
+ * \retval 0 on success.
+ * \retval Non-zero on error.
  */
 int app_unsubscribe_bridge(struct stasis_app *app, struct ast_bridge *bridge);
 
@@ -193,8 +194,8 @@ int app_unsubscribe_bridge(struct stasis_app *app, struct ast_bridge *bridge);
  *
  * \param app Subscribing application.
  * \param bridge_id Id of bridge to unsubscribe from.
- * \return 0 on success.
- * \return Non-zero on error.
+ * \retval 0 on success.
+ * \retval Non-zero on error.
  */
 int app_unsubscribe_bridge_id(struct stasis_app *app, const char *bridge_id);
 
@@ -203,8 +204,8 @@ int app_unsubscribe_bridge_id(struct stasis_app *app, const char *bridge_id);
  *
  * \param app Subscribing application.
  * \param bridge_id Id of bridge to check.
- * \return True (non-zero) if bridge is subscribed to \a app.
- * \return False (zero) if bridge is not subscribed.
+ * \retval True (non-zero) if bridge is subscribed to \a app.
+ * \retval False (zero) if bridge is not subscribed.
  */
 int app_is_subscribed_bridge_id(struct stasis_app *app, const char *bridge_id);
 
@@ -212,9 +213,9 @@ int app_is_subscribed_bridge_id(struct stasis_app *app, const char *bridge_id);
  * \brief Subscribes an application to a endpoint.
  *
  * \param app Application.
- * \param chan Endpoint to subscribe to.
- * \return 0 on success.
- * \return Non-zero on error.
+ * \param endpoint Endpoint to subscribe to.
+ * \retval 0 on success.
+ * \retval Non-zero on error.
  */
 int app_subscribe_endpoint(struct stasis_app *app, struct ast_endpoint *endpoint);
 
@@ -223,8 +224,8 @@ int app_subscribe_endpoint(struct stasis_app *app, struct ast_endpoint *endpoint
  *
  * \param app Subscribing application.
  * \param endpoint_id Id of endpoint to unsubscribe from.
- * \return 0 on success.
- * \return Non-zero on error.
+ * \retval 0 on success.
+ * \retval Non-zero on error.
  */
 int app_unsubscribe_endpoint_id(struct stasis_app *app, const char *endpoint_id);
 
@@ -233,15 +234,15 @@ int app_unsubscribe_endpoint_id(struct stasis_app *app, const char *endpoint_id)
  *
  * \param app Subscribing application.
  * \param endpoint_id Id of endpoint to check.
- * \return True (non-zero) if endpoint is subscribed to \a app.
- * \return False (zero) if endpoint is not subscribed.
+ * \retval True (non-zero) if endpoint is subscribed to \a app.
+ * \retval False (zero) if endpoint is not subscribed.
  */
 int app_is_subscribed_endpoint_id(struct stasis_app *app, const char *endpoint_id);
 
 /*!
  * \brief Set the snapshot of the channel that this channel will replace
  *
- * \param channel The channel on which this will be set
+ * \param chan The channel on which this will be set
  * \param replace_snapshot The snapshot of the channel that is being replaced
  *
  * \retval zero success
@@ -252,7 +253,7 @@ int app_set_replace_channel_snapshot(struct ast_channel *chan, struct ast_channe
 /*!
  * \brief Set the app that the replacement channel will be controlled by
  *
- * \param channel The channel on which this will be set
+ * \param chan The channel on which this will be set
  * \param replace_app The app that will be controlling this channel
  *
  * \retval zero success
@@ -263,7 +264,7 @@ int app_set_replace_channel_app(struct ast_channel *chan, const char *replace_ap
 /*!
  * \brief Get the app that the replacement channel will be controlled by
  *
- * \param channel The channel on which this will be set
+ * \param chan The channel on which this will be set
  *
  * \retval NULL on error
  * \return the name of the controlling app (must be ast_free()d)