[asterisk-commits] lathama: trunk r374956 - in /trunk: apps/app_dial.c main/app.c

[SVN commits to the Asterisk project]

Author: lathama
Date: Sat Oct 13 11:38:48 2012
New Revision: 374956

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=374956
Log:
Doxygen Clean ups

Add app_skel.c as an example in app.c and fix some formating for the "Dial Privacy scripts" so it actually shows up in the Doxygen output.

(issue ASTERISK-20259)

Modified:
    trunk/apps/app_dial.c
    trunk/main/app.c

Modified: trunk/apps/app_dial.c
URL: http://svnview.digium.com/svn/asterisk/trunk/apps/app_dial.c?view=diff&rev=374956&r1=374955&r2=374956
==============================================================================
--- trunk/apps/app_dial.c (original)
+++ trunk/apps/app_dial.c Sat Oct 13 11:38:48 2012
@@ -1,7 +1,7 @@
 /*
  * Asterisk -- An open source telephony toolkit.
  *
- * Copyright (C) 1999 - 2008, Digium, Inc.
+ * Copyright (C) 1999 - 2012, Digium, Inc.
  *
  * Mark Spencer <markster at digium.com>
  *
@@ -1804,22 +1804,23 @@
 			if (ast_test_flag64(opts, OPT_SCREENING))
 				res2 = ast_play_and_wait(peer, "screen-callee-options");
 		}
+
 		/*! \page DialPrivacy Dial Privacy scripts
-		\par priv-callee-options script:
-			"Dial 1 if you wish this caller to reach you directly in the future,
-				and immediately connect to their incoming call
-			 Dial 2 if you wish to send this caller to voicemail now and
-				forevermore.
-			 Dial 3 to send this caller to the torture menus, now and forevermore.
-			 Dial 4 to send this caller to a simple "go away" menu, now and forevermore.
-			 Dial 5 to allow this caller to come straight thru to you in the future,
-				but right now, just this once, send them to voicemail."
-		\par screen-callee-options script:
-			"Dial 1 if you wish to immediately connect to the incoming call
-			 Dial 2 if you wish to send this caller to voicemail.
-			 Dial 3 to send this caller to the torture menus.
-			 Dial 4 to send this caller to a simple "go away" menu.
-		*/
+		 * \par priv-callee-options script:
+		 * \li Dial 1 if you wish this caller to reach you directly in the future, 
+		 * 	and immediately connect to their incoming call.
+		 * \li Dial 2 if you wish to send this caller to voicemail now and forevermore.
+		 * \li Dial 3 to send this caller to the torture menus, now and forevermore.
+		 * \li Dial 4 to send this caller to a simple "go away" menu, now and forevermore.
+		 * \li Dial 5 to allow this caller to come straight thru to you in the future,
+		 * 	but right now, just this once, send them to voicemail.
+		 *
+		 * \par screen-callee-options script:
+		 * \li Dial 1 if you wish to immediately connect to the incoming call
+		 * \li Dial 2 if you wish to send this caller to voicemail.
+		 * \li Dial 3 to send this caller to the torture menus.
+		 * \li Dial 4 to send this caller to a simple "go away" menu.
+		 */
 		if (valid_priv_reply(opts, res2))
 			break;
 		/* invalid option */

Modified: trunk/main/app.c
URL: http://svnview.digium.com/svn/asterisk/trunk/main/app.c?view=diff&rev=374956&r1=374955&r2=374956
==============================================================================
--- trunk/main/app.c (original)
+++ trunk/main/app.c Sat Oct 13 11:38:48 2012
@@ -21,6 +21,10 @@
  * \brief Convenient Application Routines
  *
  * \author Mark Spencer <markster at digium.com>
+ */
+
+/** \example app_skel.c
+ * This is an example of how to develop an app
  */
 
 /*** MODULEINFO