From 1a3c5aaa6cdf700a2ff79ae47f8341e91734fdce Mon Sep 17 00:00:00 2001
From: "David M. Lee" <dlee@digium.com>
Date: Tue, 7 May 2013 18:29:30 +0000
Subject: [PATCH] Minor fixups to Doxygen comments.
The \example tags marks an entire file as an example, not a code snippet.
git-svn-id: https://origsvn.digium.com/svn/asterisk/branches/11@387823 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
main/manager.c | 14 ++++++++------
res/res_config_pgsql.c | 4 ++--
2 files changed, 10 insertions(+), 8 deletions(-)
diff --git a/main/manager.c b/main/manager.c
index 4515f13d50..f97c5b7de0 100644
--- a/main/manager.c
+++ b/main/manager.c
@@ -4696,7 +4696,7 @@ static int blackfilter_cmp_fn(void *obj, void *arg, void *data, int flags)
return 0;
}
-/*
+/*!
* \brief Manager command to add an event filter to a manager session
* \see For more details look at manager_add_filter
*/
@@ -4730,10 +4730,9 @@ static int action_filter(struct mansession *s, const struct message *m)
return 0;
}
-/*
+/*!
* \brief Add an event filter to a manager session
*
- * \param s manager session to modify filters on
* \param filter_pattern Filter syntax to add, see below for syntax
*
* \return FILTER_ALLOC_FAILED Memory allocation failure
@@ -4744,9 +4743,12 @@ static int action_filter(struct mansession *s, const struct message *m)
* Filter can be any valid regular expression
* Filter can be a valid regular expression prefixed with !, which will add the filter as a black filter
*
- * \example filter_pattern = "Event: Newchannel"
- * \example filter_pattern = "Event: New.*"
- * \example filter_pattern = "!Channel: DAHDI.*"
+ * Examples:
+ * \code
+ * filter_pattern = "Event: Newchannel"
+ * filter_pattern = "Event: New.*"
+ * filter_pattern = "!Channel: DAHDI.*"
+ * \endcode
*
*/
static enum add_filter_result manager_add_filter(const char *filter_pattern, struct ao2_container *whitefilters, struct ao2_container *blackfilters) {
diff --git a/res/res_config_pgsql.c b/res/res_config_pgsql.c
index bafa271978..252e599d04 100644
--- a/res/res_config_pgsql.c
+++ b/res/res_config_pgsql.c
@@ -198,7 +198,7 @@ static int _pgsql_exec(const char *database, const char *tablename, const char *
* \return -1 on query failure
* \return 0 on success
*
- * \example
+ * \code
* int i, rows;
* PGresult *result;
* char *field_name, *field_type, *field_len, *field_notnull, *field_default;
@@ -213,7 +213,7 @@ static int _pgsql_exec(const char *database, const char *tablename, const char *
* field_notnull = PQgetvalue(result, i, 3);
* field_default = PQgetvalue(result, i, 4);
* }
- *
+ * \endcode
*/
static int pgsql_exec(const char *database, const char *tablename, const char *sql, PGresult **result)
{
--
GitLab