Doxygen updates

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

agi/Makefile

@@ -21,7 +21,7 @@ endif
 
 include $(ASTTOPDIR)/Makefile.rules
 
-all: $(AGIS)
+all: #$(AGIS)
 
 strcompat.c: ../main/strcompat.c
 	@cp $< $@

agi/eagi-sphinx-test.c

@@ -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>

agi/eagi-test.c

@@ -18,6 +18,15 @@
 
 #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];

contrib/asterisk-ng-doxygen

@@ -458,6 +458,7 @@ INPUT                  = ./ \
 			 codecs \
 			 formats \
 			 pbx \
+			 agi \
 			 res
 
 # If the value of the INPUT tag contains directories, you can use the 

main/devicestate.c

@@ -22,6 +22,8 @@
  *
  *
  * \author Mark Spencer <markster@digium.com> 
+ *
+ *	\arg \ref AstExtState
  */
 /*! \page AstExtState Extension and device states in Asterisk
  *
@@ -59,10 +61,26 @@
  *	- 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.
  *
+ *	\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.
+ *
  *	
  */