issue #5605

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

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>

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>

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>

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>

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>

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>

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>

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>

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>

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>

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>

formats/format_sln.c

@@ -18,7 +18,8 @@
 /*! \file
  *
  * \brief RAW SLINEAR Format
- *
+ * \arg File name extensions: sln, raw
+ * \ingroup formats
  */
  
 #include <unistd.h>

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>

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>

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>