issue #5605

git-svn-id: http://svn.digium.com/svn/asterisk/trunk@6979 f38db490-d61c-443f-a65b-d21fe96a405b

15 files changed, 48 insertions, 12 deletions

diff --git a/formats/format_au.c b/formats/format_au.c
index bfa4cdade..669fa1921 100755
--- a/formats/format_au.c
+++ b/formats/format_au.c
@@ -15,10 +15,14 @@
  * at the top of the source tree.
  */
 
-/*! \file
+/*! 
+ * \file
  *
  * \brief Work with Sun Microsystems AU format.
- * 
+ *
+ * signed linear
+ * \arg File extension: au
+ * \ingroup formats
  */
  
 #include <stdlib.h>
diff --git a/formats/format_g723.c b/formats/format_g723.c
index e046b6b3c..2d17d96eb 100755
--- a/formats/format_g723.c
+++ b/formats/format_g723.c
@@ -16,10 +16,13 @@
  * at the top of the source tree.
  */
 
-/*! \file
+/*! 
+ * \file
  *
- * \brief Old-style G.723 frame/timestamp format.
+ * \brief Old-style G.723.1 frame/timestamp format.
  * 
+ * \arg Extensions: g723, g723sf
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_g726.c b/formats/format_g726.c
index cb1a3746e..717fdaf5b 100755
--- a/formats/format_g726.c
+++ b/formats/format_g726.c
@@ -20,6 +20,12 @@
  *
  * \brief Headerless G.726 (16/24/32/40kbps) data format for Asterisk.
  * 
+ * File name extensions:
+ * \arg 40 kbps: g726-40
+ * \arg 32 kbps: g726-32
+ * \arg 24 kbps: g726-24
+ * \arg 16 kbps: g726-16
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_g729.c b/formats/format_g729.c
index 39a6bc87c..6afe539da 100755
--- a/formats/format_g729.c
+++ b/formats/format_g729.c
@@ -19,7 +19,11 @@
 /*! \file
  *
  * \brief Save to raw, headerless G729 data.
- * 
+ * \note This is not an encoder/decoder. The codec fo g729 is only
+ * available with a commercial license from Digium, due to patent
+ * restrictions. Check http://www.digium.com for information.
+ * \arg Extensions: g729 
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_gsm.c b/formats/format_gsm.c
index a3a6aaecb..176c73a97 100755
--- a/formats/format_gsm.c
+++ b/formats/format_gsm.c
@@ -19,7 +19,8 @@
 /*! \file
  *
  * \brief Save to raw, headerless GSM data.
- * 
+ * \arg File name extension: gsm
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_h263.c b/formats/format_h263.c
index 40d8c2eb1..ccba23d6d 100755
--- a/formats/format_h263.c
+++ b/formats/format_h263.c
@@ -19,7 +19,8 @@
 /*! \file
  *
  * \brief Save to raw, headerless h263 data.
- * 
+ * \arg File name extension: h263
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_ilbc.c b/formats/format_ilbc.c
index 4aee8c94e..cbe017f66 100755
--- a/formats/format_ilbc.c
+++ b/formats/format_ilbc.c
@@ -21,7 +21,8 @@
 /*! \file
  *
  * \brief Save to raw, headerless iLBC data.
- *
+ * \arg File name extension: ilbc
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_jpeg.c b/formats/format_jpeg.c
index 2a5dfc15f..d71aeec80 100755
--- a/formats/format_jpeg.c
+++ b/formats/format_jpeg.c
@@ -20,6 +20,8 @@
  *
  * \brief JPEG File format support.
  * 
+ * \arg File name extension: jpeg, jpg
+ * \ingroup formats
  */
  
 #include <sys/types.h>
diff --git a/formats/format_ogg_vorbis.c b/formats/format_ogg_vorbis.c
index b1bbfa7fd..eecc89f2c 100755
--- a/formats/format_ogg_vorbis.c
+++ b/formats/format_ogg_vorbis.c
@@ -17,7 +17,8 @@
 /*! \file
  *
  * \brief OGG/Vorbis streams.
- * 
+ * \arg File name extension: ogg
+ * \ingroup formats
  */
  
 #include <netinet/in.h>
diff --git a/formats/format_pcm.c b/formats/format_pcm.c
index 13fef5ff7..4adb076cf 100755
--- a/formats/format_pcm.c
+++ b/formats/format_pcm.c
@@ -19,7 +19,9 @@
 /*! \file
  *
  * \brief Flat, binary, ulaw PCM file format.
+ * \arg File name extension: pcm, ulaw, ul, mu
  * 
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_pcm_alaw.c b/formats/format_pcm_alaw.c
index 2cd874ecc..0fd7de407 100755
--- a/formats/format_pcm_alaw.c
+++ b/formats/format_pcm_alaw.c
@@ -19,7 +19,8 @@
 /*! \file
  *
  * \brief Flat, binary, alaw PCM file format.
- * 
+ * \arg File name extensions: alaw, al
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_sln.c b/formats/format_sln.c
index 6c36f1730..008a715bc 100755
--- a/formats/format_sln.c
+++ b/formats/format_sln.c
@@ -18,7 +18,8 @@
 /*! \file
  *
  * \brief RAW SLINEAR Format
- *
+ * \arg File name extensions: sln, raw
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_vox.c b/formats/format_vox.c
index 0ef901079..60d2630be 100755
--- a/formats/format_vox.c
+++ b/formats/format_vox.c
@@ -19,7 +19,9 @@
 /*! \file
  *
  * \brief Flat, binary, ADPCM vox file format.
+ * \arg File name extensions: vox
  * 
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_wav.c b/formats/format_wav.c
index f721ff6fe..83e6dd564 100755
--- a/formats/format_wav.c
+++ b/formats/format_wav.c
@@ -19,7 +19,9 @@
 /*! \file
  *
  * \brief Work with WAV in the proprietary Microsoft format.
- * 
+ * Microsoft WAV format (8000hz Signed Linear)
+ * \arg File name extension: wav (lower case)
+ * \ingroup formats
  */
  
 #include <unistd.h>
diff --git a/formats/format_wav_gsm.c b/formats/format_wav_gsm.c
index 3403a8d9e..c7bc50425 100755
--- a/formats/format_wav_gsm.c
+++ b/formats/format_wav_gsm.c
@@ -20,6 +20,11 @@
  *
  * \brief Save GSM in the proprietary Microsoft format.
  * 
+ * Microsoft WAV format (Proprietary GSM)
+ * \arg File name extension: WAV,wav49  (Upper case WAV, lower case is another format)
+ * This format can be played on Windows systems, used for
+ * e-mail attachments mainly.
+ * \ingroup formats
  */
  
 #include <unistd.h>