progdocs: Fix for Doxygen, the hidden parts.

ASTERISK-29779

Change-Id: If338163488498f65fa7248b60e80299c0a928e4b

apps/app_confbridge.c

@@ -909,7 +909,7 @@ static int conf_start_record(struct confbridge_conference *conference)
 	return 0;
 }
 
-/* \brief Playback the given filename and monitor for any dtmf interrupts.
+/*! \brief Playback the given filename and monitor for any dtmf interrupts.
  *
  * This function is used to playback sound files on a given channel and optionally
  * allow dtmf interrupts to occur.
@@ -923,7 +923,9 @@ static int conf_start_record(struct confbridge_conference *conference)
  * \param channel Optional channel to play file on if bridge_channel not given
  * \param filename The file name to playback
  *
- * \retval -1 failure during playback, 0 on file was fully played, 1 on dtmf interrupt.
+ * \retval -1 failure during playback.
+ * \retval 0 on file was fully played.
+ * \retval 1 on dtmf interrupt.
  */
 static int play_file(struct ast_bridge_channel *bridge_channel, struct ast_channel *channel,
 		     const char *filename)
@@ -1306,7 +1308,7 @@ void conf_update_user_mute(struct confbridge_user *user)
 		ast_channel_name(user->chan));
 }
 
-/*
+/*!
  * \internal
  * \brief Mute/unmute a single user.
  */
@@ -3491,7 +3493,7 @@ static char *handle_cli_confbridge_list(struct ast_cli_entry *e, int cmd, struct
 	return CLI_SHOWUSAGE;
 }
 
-/* \internal
+/*! \internal
  * \brief finds a conference by name and locks/unlocks.
  *
  * \retval 0 success
@@ -3515,7 +3517,7 @@ static int generic_lock_unlock_helper(int lock, const char *conference_name)
 	return res;
 }
 
-/* \internal
+/*! \internal
  * \brief finds a conference user by channel name and mutes/unmutes them.
  *
  * \retval 0 success

apps/app_queue.c

@@ -7790,9 +7790,10 @@ static int set_member_value(const char *queuename, const char *interface, int pr
 	return RESULT_FAILURE;
 }
 
-/* \brief Gets members penalty.
+/*!
+ * \brief Gets members penalty.
  * \return Return the members penalty or RESULT_FAILURE on error.
-*/
+ */
 static int get_member_penalty(char *queuename, char *interface)
 {
 	int foundqueue = 0, penalty;
@@ -11542,9 +11543,10 @@ static int reload(void)
 	return 0;
 }
 
-/* \brief Find a member by looking up queuename and interface.
+/*!
+ * \brief Find a member by looking up queuename and interface.
  * \return member or NULL if member not found.
-*/
+ */
 static struct member *find_member_by_queuename_and_interface(const char *queuename, const char *interface)
 {
 	struct member *mem = NULL;

apps/app_stack.c

@@ -924,8 +924,6 @@ static struct ast_custom_function stackpeek_function = {
  * \param chan Channel to balance stack on.
  *
  * \note The channel is already locked when called.
- *
- * \return Nothing
  */
 static void balance_stack(struct ast_channel *chan)
 {

apps/app_stasis.c

@@ -79,7 +79,7 @@
 /*! \brief Dialplan application name */
 static const char *stasis = "Stasis";
 
-/*! /brief Stasis dialplan application callback */
+/*! \brief Stasis dialplan application callback */
 static int app_exec(struct ast_channel *chan, const char *data)
 {
 	char *parse = NULL;

apps/app_voicemail.c

@@ -2865,6 +2865,7 @@ static int has_voicemail(const char *mailbox, const char *folder)
  * \param recip
  * \param fmt
  * \param dir
+ * \param flag, dest_folder
  *
  * This works with IMAP storage based mailboxes.
  *
@@ -4154,8 +4155,6 @@ bail:
  *
  * This method is used when mailboxes are stored in an ODBC back end.
  * The specified message is directly deleted from the database 'voicemessages' table.
- *
- * \return the value greater than zero on success to indicate the number of messages, less than zero on error.
  */
 static void delete_file(const char *sdir, int smsg)
 {