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)

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@374956 65c4cc65-6c06-0410-ace0-fbb531ad65f3

diff --git a/apps/app_dial.c b/apps/app_dial.c
index 88a4ac3a356114097feb243037c1b6ebbff68b11..6c56e39ed17a265dfbc3e47fbd0d19964058c4d3 100644 (file)
--- a/apps/app_dial.c
+++ b/apps/app_dial.c
@@ -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@digium.com>
  *
@@ -1804,22 +1804,23 @@ static int do_privacy(struct ast_channel *chan, struct ast_channel *peer,
                        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 */

diff --git a/main/app.c b/main/app.c
index 875bed1d5e9c268c30b486ec7d595bf0dd048313..bd94b40eaf48ffb1e41797da73b5c6df56299614 100644 (file)
--- a/main/app.c
+++ b/main/app.c
@@ -23,6 +23,10 @@
  * \author Mark Spencer <markster@digium.com>
  */
 
+/** \example app_skel.c
+ * This is an example of how to develop an app
+ */
+
 /*** MODULEINFO
        <support_level>core</support_level>
  ***/