[asterisk-commits] rmudgett: trunk r142181 - /trunk/main/callerid.c

[SVN commits to the Asterisk project]

Author: rmudgett
Date: Tue Sep  9 12:30:52 2008
New Revision: 142181

URL: http://svn.digium.com/view/asterisk?view=rev&rev=142181
Log:
Cleaned up comment

Modified:
    trunk/main/callerid.c

Modified: trunk/main/callerid.c
URL: http://svn.digium.com/view/asterisk/trunk/main/callerid.c?view=diff&rev=142181&r1=142180&r2=142181
==============================================================================
--- trunk/main/callerid.c (original)
+++ trunk/main/callerid.c Tue Sep  9 12:30:52 2008
@@ -994,16 +994,16 @@
 	return ast_is_valid_string(exten, "0123456789*#+()-.");
 }
 
-/*! \brief parse string for caller id information 
-	\return always returns 0, as the code always returns something.
-  XXX note that 'name' is not parsed consistently e.g. we have
-
-	input			location	name
-	" foo bar " <123>	123		' foo bar ' (with spaces around)
-	" foo bar "		NULL		'foo bar' (without spaces around)
-	" foo bar  <123>"	123		'" foo bar'
-  The parsing of leading and trailing space/quotes should be more consistent.
-*/
+/*!
+ * \brief Destructively parse instr for caller id information 
+ * \return always returns 0, as the code always returns something.
+ * \note XXX 'name' is not parsed consistently e.g. we have
+ * input                   location        name
+ * " foo bar " <123>       123             ' foo bar ' (with spaces around)
+ * " foo bar "             NULL            'foo bar' (without spaces around)
+ * " foo bar  <123>"       123             '" foo bar'
+ * The parsing of leading and trailing space/quotes should be more consistent.
+ */
 int ast_callerid_parse(char *instr, char **name, char **location)
 {
 	char *ns, *ne, *ls, *le;