Doxygen updates
authorOlle Johansson <oej@edvina.net>
Thu, 30 Nov 2006 18:22:10 +0000 (18:22 +0000)
committerOlle Johansson <oej@edvina.net>
Thu, 30 Nov 2006 18:22:10 +0000 (18:22 +0000)
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@48149 65c4cc65-6c06-0410-ace0-fbb531ad65f3

agi/Makefile
agi/eagi-sphinx-test.c
agi/eagi-test.c
contrib/asterisk-ng-doxygen
main/devicestate.c

index 3a34951..b91eb5e 100644 (file)
@@ -21,7 +21,7 @@ endif
 
 include $(ASTTOPDIR)/Makefile.rules
 
 
 include $(ASTTOPDIR)/Makefile.rules
 
-all: $(AGIS)
+all: #$(AGIS)
 
 strcompat.c: ../main/strcompat.c
        @cp $< $@
 
 strcompat.c: ../main/strcompat.c
        @cp $< $@
index 0ad12c7..d289876 100644 (file)
@@ -6,6 +6,15 @@
  *
  */
 
  *
  */
 
+/*! \file
+ * Extended AGI test application
+ *
+ * This code is released into public domain
+ * without any warranty of any kind.
+ *
+ *     \ingroup agi
+ */
+
 #include <stdio.h>
 #include <unistd.h>
 #include <stdlib.h>
 #include <stdio.h>
 #include <unistd.h>
 #include <stdlib.h>
index 7745d18..ed725fc 100644 (file)
 
 #define AUDIO_FILENO (STDERR_FILENO + 1)
 
 
 #define AUDIO_FILENO (STDERR_FILENO + 1)
 
+/*! \file
+ * Extended AGI test application
+ *
+ * This code is released into the public domain
+ * with no warranty of any kind
+ *
+ * \ingroup agi
+ */
+
 static int read_environment(void)
 {
        char buf[256];
 static int read_environment(void)
 {
        char buf[256];
index 8fcf93c..868258b 100644 (file)
@@ -458,6 +458,7 @@ INPUT                  = ./ \
                         codecs \
                         formats \
                         pbx \
                         codecs \
                         formats \
                         pbx \
+                        agi \
                         res
 
 # If the value of the INPUT tag contains directories, you can use the 
                         res
 
 # If the value of the INPUT tag contains directories, you can use the 
index 0711a10..9fe50e6 100644 (file)
@@ -22,6 +22,8 @@
  *
  *
  * \author Mark Spencer <markster@digium.com> 
  *
  *
  * \author Mark Spencer <markster@digium.com> 
+ *
+ *     \arg \ref AstExtState
  */
 /*! \page AstExtState Extension and device states in Asterisk
  *
  */
 /*! \page AstExtState Extension and device states in Asterisk
  *
  *     - SIP subscriptions, a.k.a. "blinking lamps" or 
  *       "buddy lists"
  *
  *     - SIP subscriptions, a.k.a. "blinking lamps" or 
  *       "buddy lists"
  *
- *     None of these handle user states, like an IM presense
+ *     The CLI command "show hints" show last known state
+ *
+ *     \note None of these handle user states, like an IM presense
  *     system. res_jabber.c can subscribe and watch such states
  *     in jabber/xmpp based systems.
  *
  *     system. res_jabber.c can subscribe and watch such states
  *     in jabber/xmpp based systems.
  *
+ *     \section AstExtStateARch Architecture
+ *
+ *     When a channel driver or asterisk app changes state for 
+ *     a watched object, it alerts the core. The core queues
+ *     a change. When the change is processed, there's a query
+ *     sent to the channel driver/provider if there's a function
+ *     to handle that, otherwise a channel walk is issued to find
+ *     a channel that involves the object.
+ *     
+ *     The changes are queued and processed by a separate thread.
+ *     This thread calls the watchers subscribing to status 
+ *     changes for the object. For manager, this results 
+ *     in events. For SIP, NOTIFY requests.
+ *
  *     
  */
 
  *     
  */