Creating new doxygen macro "\extref" to create page that lists

external libraries and URLs to these. Please help me add these
references.

We might want to create a similar macro "\linuxpackage" to list
the needed Linux packages in popular distributions.



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

apps/app_festival.c

@@ -21,6 +21,8 @@
  * \brief Connect to festival
  *
  * \author Christos Ricudis <ricudis@itc.auth.gr>
+ *
+ * \extref  The Festival Speech Synthesis System - http://www.cstr.ed.ac.uk/projects/festival/
  * 
  * \ingroup applications
  */

apps/app_osplookup.c

@@ -22,6 +22,9 @@
  *
  * \author Mark Spencer <markster@digium.com>
  *
+ * \extref The OSP Toolkit: http://www.transnexus.com
+ * \extref OpenSSL http://www.openssl.org
+ *
  * \ingroup applications
  */
 

apps/app_voicemail.c

@@ -21,6 +21,10 @@
  * \brief Comedian Mail - Voicemail System
  *
  * \author Mark Spencer <markster@digium.com>
+ *
+ * \extref Unixodbc - http://www.unixodbc.org
+ * \extref A source distribution of University of Washington's IMAP
+c-client (http://www.washington.edu/imap/
  * 
  * \par See also
  * \arg \ref Config_vm

cdr/cdr_pgsql.c

@@ -25,6 +25,7 @@
  * \brief PostgreSQL CDR logger 
  * 
  * \author Matthew D. Hardeman <mhardemn@papersoft.com> 
+ * \extref PostgreSQL http://www.postgresql.org/
  *
  * See also
  * \arg \ref Config_cdr

cdr/cdr_radius.c

@@ -20,6 +20,7 @@
  *
  * \brief RADIUS CDR Support
  * \author Philippe Sultan
+ * \extref FreeRadius http://www.freeradius.org/
  * 
  * \arg See also \ref AstCDR
  * \ingroup cdr_drivers

cdr/cdr_sqlite.c

@@ -22,6 +22,7 @@
  * \brief Store CDR records in a SQLite database.
  * 
  * \author Holger Schurig <hs4233@mail.mn-solutions.de>
+ * \extref SQLite http://www.sqlite.org/
  *
  * See also
  * \arg \ref Config_cdr

channels/chan_h323.c

@@ -29,6 +29,7 @@
  *
  * \par See also
  * \arg Config_h323
+ * \extref OpenH323 http://www.openh323.org/
  *
  * \ingroup channel_drivers
  */

codecs/codec_speex.c

@@ -21,10 +21,13 @@
  *
  * \brief Translate between signed linear and Speex (Open Codec)
  *
- * http://www.speex.org
  * \note This work was motivated by Jeremy McNamara 
  * hacked to be configurable by anthm and bkw 9/28/2004
+ *
  * \ingroup codecs
+ *
+ * \extref The Speex library - http://www.speex.org
+ *
  */
 
 /*** MODULEINFO

contrib/asterisk-ng-doxygen

@@ -181,7 +181,7 @@ TAB_SIZE               = 3
 # will result in a user-defined paragraph with heading "Side Effects:". 
 # You can put \n's in the value part of an alias to insert newlines.
 
-ALIASES                = 
+ALIASES += "extref=\xrefitem extref \"ExtRef\" \"External references\""
 
 # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C 
 # sources only. Doxygen will then generate output that is more tailored for C. 

funcs/func_curl.c

@@ -24,6 +24,8 @@
  * \author Tilghman Lesher <curl-20050919@the-tilghman.com>
  *
  * \note Brian Wilkins <bwilkins@cfl.rr.com> (Added POST option) 
+ *
+ * \extref Depends on the CURL library  - http://curl.haxx.se/
  * 
  * \ingroup functions
  */

include/asterisk/jabber.h

@@ -21,6 +21,7 @@
  * \ref AJI_intro
  * \ref res_jabber.c
  * \author Matt O'Gorman <mogorman@digium.com>
+ * \extref IKSEMEL http://iksemel.jabberstudio.org
  *
  * \page AJI_intro AJI - The Asterisk Jabber Interface
  * 

res/res_crypto.c

@@ -21,6 +21,9 @@
  * \brief Provide Cryptographic Signature capability
  *
  * \author Mark Spencer <markster@digium.com> 
+ *
+ * \extref Uses the OpenSSL library, available at
+ *	http://www.openssl.org/
  */
 
 /*** MODULEINFO

res/res_snmp.c

@@ -12,6 +12,9 @@
  * \brief SNMP Agent / SubAgent support for Asterisk
  *
  * \author Thorsten Lockert <tholo@voop.as>
+ *
+ * \extref Uses the Net-SNMP libraries available at
+ *	 http://net-snmp.sourceforge.net/
  */
 
 /*** MODULEINFO