changeset 12062:372f7fed2806 libavcodec

Avoid square brackets in Doxygen comments; Doxygen chokes on them.
author diego
date Fri, 02 Jul 2010 11:44:58 +0000
parents 75f4dfbd0462
children a50a82d98cc2
files aac_parser.h ac3_parser.h lsp.h motion_est_template.c vp8.c
diffstat 5 files changed, 9 insertions(+), 10 deletions(-) [+]
line wrap: on
line diff
--- a/aac_parser.h	Fri Jul 02 11:37:53 2010 +0000
+++ b/aac_parser.h	Fri Jul 02 11:44:58 2010 +0000
@@ -44,8 +44,8 @@
  * Parse AAC frame header.
  * Parse the ADTS frame header to the end of the variable header, which is
  * the first 54 bits.
- * @param gbc[in] BitContext containing the first 54 bits of the frame.
- * @param hdr[out] Pointer to struct where header info is written.
+ * @param gbc BitContext containing the first 54 bits of the frame.
+ * @param hdr Pointer to struct where header info is written.
  * @return Returns 0 on success, -1 if there is a sync word mismatch,
  * -2 if the version element is invalid, -3 if the sample rate
  * element is invalid, or -4 if the bit rate element is invalid.
--- a/ac3_parser.h	Fri Jul 02 11:37:53 2010 +0000
+++ b/ac3_parser.h	Fri Jul 02 11:44:58 2010 +0000
@@ -30,8 +30,8 @@
  * Parse AC-3 frame header.
  * Parse the header up to the lfeon element, which is the first 52 or 54 bits
  * depending on the audio coding mode.
- * @param gbc[in] BitContext containing the first 54 bits of the frame.
- * @param hdr[out] Pointer to struct where header info is written.
+ * @param gbc BitContext containing the first 54 bits of the frame.
+ * @param hdr Pointer to struct where header info is written.
  * @return Returns 0 on success, -1 if there is a sync word mismatch,
  * -2 if the bsid (version) element is invalid, -3 if the fscod (sample rate)
  * element is invalid, or -4 if the frmsizecod (bit rate) element is invalid.
@@ -43,8 +43,8 @@
  * Parse the header up to the lfeon (channel_map in E-AC-3)
  * element, which is the first 52, 54 or 104 bits depending
  * on the audio coding mode.
- * @param gbc[in] BitContext containing the first 54 bits of the frame.
- * @param hdr[out] Pointer to struct where header info is written.
+ * @param gbc BitContext containing the first 54 bits of the frame.
+ * @param hdr Pointer to struct where header info is written.
  * @return value returned by ff_ac3_parse_header
  */
 int ff_ac3_parse_header_full(GetBitContext *gbc, AC3HeaderInfo *hdr);
--- a/lsp.h	Fri Jul 02 11:37:53 2010 +0000
+++ b/lsp.h	Fri Jul 02 11:44:58 2010 +0000
@@ -46,7 +46,7 @@
  * Omitting this step creates audible distortion on the sinusoidal sweep
  * test vectors in 3GPP TS 26.074.
  *
- * @param[in,out] lsf    LSFs in Hertz
+ * @param lsf            [in,out] LSFs in Hertz
  * @param min_spacing    minimum distance between two consecutive lsf values
  */
 void ff_set_min_dist_lsf(float *lsf, double min_spacing, int order);
--- a/motion_est_template.c	Fri Jul 02 11:37:53 2010 +0000
+++ b/motion_est_template.c	Fri Jul 02 11:44:58 2010 +0000
@@ -1028,7 +1028,7 @@
 }
 
 /*!
-   \param P[10][2] a list of candidate mvs to check before starting the
+   \param P a list of candidate mvs to check before starting the
    iterative search. If one of the candidates is close to the optimal mv, then
    it takes fewer iterations. And it increases the chance that we find the
    optimal mv.
--- a/vp8.c	Fri Jul 02 11:37:53 2010 +0000
+++ b/vp8.c	Fri Jul 02 11:44:58 2010 +0000
@@ -747,8 +747,7 @@
  * @param i initial coeff index, 0 unless a separate DC block is coded
  * @param zero_nhood the initial prediction context for number of surrounding
  *                   all-zero blocks (only left/top, so 0-2)
- * @param qmul[0] dc dequant factor
- * @param qmul[1] ac dequant factor
+ * @param qmul array holding the dc/ac dequant factor at position 0/1
  * @return 0 if no coeffs were decoded
  *         otherwise, the index of the last coeff decoded plus one
  */