[asterisk-commits] dlee: branch 11 r387823 - in /branches/11: main/manager.c res/res_config_pgsql.c

[SVN commits to the Asterisk project]

Author: dlee
Date: Tue May  7 13:29:30 2013
New Revision: 387823

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=387823
Log:
Minor fixups to Doxygen comments.

The \example tags marks an entire file as an example, not a code snippet.

Modified:
    branches/11/main/manager.c
    branches/11/res/res_config_pgsql.c

Modified: branches/11/main/manager.c
URL: http://svnview.digium.com/svn/asterisk/branches/11/main/manager.c?view=diff&rev=387823&r1=387822&r2=387823
==============================================================================
--- branches/11/main/manager.c (original)
+++ branches/11/main/manager.c Tue May  7 13:29:30 2013
@@ -4696,7 +4696,7 @@
 	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 @@
 	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 @@
  * 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) {

Modified: branches/11/res/res_config_pgsql.c
URL: http://svnview.digium.com/svn/asterisk/branches/11/res/res_config_pgsql.c?view=diff&rev=387823&r1=387822&r2=387823
==============================================================================
--- branches/11/res/res_config_pgsql.c (original)
+++ branches/11/res/res_config_pgsql.c Tue May  7 13:29:30 2013
@@ -198,7 +198,7 @@
  *  \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 @@
  *		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)
 {