[xiph-commits] r17639 - trunk/theora/include/theora

[giles at svn.xiph.org]

Author: giles
Date: 2010-11-22 12:55:49 -0800 (Mon, 22 Nov 2010)
New Revision: 17639

Modified:
   trunk/theora/include/theora/theoradec.h
   trunk/theora/include/theora/theoraenc.h
Log:
Document that the th_*_ctl() return values are specific
to the control codes passed.


Modified: trunk/theora/include/theora/theoradec.h
===================================================================
--- trunk/theora/include/theora/theoradec.h	2010-11-20 18:15:25 UTC (rev 17638)
+++ trunk/theora/include/theora/theoradec.h	2010-11-22 20:55:49 UTC (rev 17639)
@@ -267,7 +267,10 @@
  *                See \ref decctlcodes "the list of available control codes"
  *                 for details.
  * \param _buf    The parameters for this control code.
- * \param _buf_sz The size of the parameter buffer.*/
+ * \param _buf_sz The size of the parameter buffer.
+ * \return Possible return values depend on the control code used.
+ *          See \ref decctlcodes "the list of control codes" for
+ *          specific values. Generally 0 indicates success.*/
 extern int th_decode_ctl(th_dec_ctx *_dec,int _req,void *_buf,
  size_t _buf_sz);
 /**Submits a packet containing encoded video data to the decoder.

Modified: trunk/theora/include/theora/theoraenc.h
===================================================================
--- trunk/theora/include/theora/theoraenc.h	2010-11-20 18:15:25 UTC (rev 17638)
+++ trunk/theora/include/theora/theoraenc.h	2010-11-22 20:55:49 UTC (rev 17639)
@@ -441,8 +441,8 @@
  *    packets.
  * - For each uncompressed frame:
  *   - Submit the uncompressed frame via th_encode_ycbcr_in()
- *   - Repeatedly call th_encode_packetout() to retrieve any video data packets
- *      that are ready.
+ *   - Repeatedly call th_encode_packetout() to retrieve any video
+ *      data packets that are ready.
  * - Call th_encode_free() to release all encoder memory.*/
 /*@{*/
 /**Allocates an encoder instance.
@@ -457,7 +457,10 @@
  *                See \ref encctlcodes "the list of available control codes"
  *                 for details.
  * \param _buf    The parameters for this control code.
- * \param _buf_sz The size of the parameter buffer.*/
+ * \param _buf_sz The size of the parameter buffer.
+ * \return Possible return values depend on the control code used.
+ *          See \ref encctlcodes "the list of control codes" for
+ *          specific values. Generally 0 indicates success.*/
 extern int th_encode_ctl(th_enc_ctx *_enc,int _req,void *_buf,size_t _buf_sz);
 /**Outputs the next header packet.
  * This should be called repeatedly after encoder initialization until it