[svn-commits] russell: branch group/newcdr r201989 - in /team/group/newcdr: include/asteris...

[SVN commits to the Digium repositories]

Author: russell
Date: Fri Jun 19 14:20:23 2009
New Revision: 201989

URL: http://svn.asterisk.org/svn-view/asterisk?view=rev&rev=201989
Log:
complete docs for ast_cel_flags2str(), use enum for arg type, formatting tweaks

Modified:
    team/group/newcdr/include/asterisk/cel.h
    team/group/newcdr/main/cel.c

Modified: team/group/newcdr/include/asterisk/cel.h
URL: http://svn.asterisk.org/svn-view/asterisk/team/group/newcdr/include/asterisk/cel.h?view=diff&rev=201989&r1=201988&r2=201989
==============================================================================
--- team/group/newcdr/include/asterisk/cel.h (original)
+++ team/group/newcdr/include/asterisk/cel.h Fri Jun 19 14:20:23 2009
@@ -31,7 +31,7 @@
 #include "asterisk/event.h"
 
 /*! AMA Flags */
-enum ast_cel_ama_flags {
+enum ast_cel_ama_flag {
 	AST_CEL_OMIT,
 	AST_CEL_BILLING,
 	AST_CEL_DOCUMENTATION,
@@ -105,11 +105,17 @@
 struct ast_cel *ast_cel_alloc(void);
 
 const char *ast_cel_eventtype2str(enum ast_cel_eventtype eventtype);
+
 enum ast_cel_eventtype ast_cel_str2eventtype(const char *eventname);
 
-
-/*! Converts AMA flag to printable string */
-const char *ast_cel_flags2str(int flag);
+/*!
+ * \brief Convert AMA flag to printable string
+ * 
+ * \param[in] flag the flag to convert to a string
+ *
+ * \return the string representation of the flag
+ */
+const char *ast_cel_flags2str(enum ast_cel_ama_flag flag);
 
 /*! If at least one CEL backend is looking for CEL_LINKEDID_END
  * events, this function will check if the given channel is the last
@@ -123,12 +129,14 @@
 
 /*! Create a fake channel containing the serialized channel date in
  the given cel event.  Must be released with ast_channel_release */
-struct ast_channel* ast_cel_fabricate_channel_from_event(const struct ast_event *event);
+struct ast_channel *ast_cel_fabricate_channel_from_event(const struct ast_event *event);
 
 /*! Frees the cel struct */
 void ast_cel_destroy(struct ast_cel *cel);
 
-void ast_cel_report_event(const struct ast_channel *chan, enum ast_cel_eventtype, char *userdefevname, const char *extra, const struct ast_channel *peer2);
+void ast_cel_report_event(const struct ast_channel *chan, enum ast_cel_eventtype,
+		char *userdefevname, const char *extra,
+		const struct ast_channel *peer2);
 
 #if defined(__cplusplus) || defined(c_plusplus)
 }

Modified: team/group/newcdr/main/cel.c
URL: http://svn.asterisk.org/svn-view/asterisk/team/group/newcdr/main/cel.c?view=diff&rev=201989&r1=201988&r2=201989
==============================================================================
--- team/group/newcdr/main/cel.c (original)
+++ team/group/newcdr/main/cel.c Fri Jun 19 14:20:23 2009
@@ -392,8 +392,7 @@
 	return "";
 }
 
-/*! Converts AMA flag to printable string */
-const char *ast_cel_flags2str(int flag)
+const char *ast_cel_flags2str(enum ast_cel_ama_flag flag)
 {
 	switch (flag) {
 	case AST_CEL_OMIT: