Belabor OPUS_SET_BITRATE instead of max_packet, as this is a common trap.
diff --git a/include/opus_multistream.h b/include/opus_multistream.h
index 2bf1dff..bd816b4 100644
--- a/include/opus_multistream.h
+++ b/include/opus_multistream.h
@@ -335,12 +335,14 @@
* @param[out] data <tt>unsigned char*</tt>: Output payload.
* This must contain storage for at
* least \a max_data_bytes.
- * @param max_data_bytes <tt>opus_int32</tt>: Size of the allocated memory for
- * the output payload. This may be
- * used to impose an upper limit on
- * the variable bitrate, but should
- * not be used as the only bitrate
- * control.
+ * @param [in] max_data_bytes <tt>opus_int32</tt>: Size of the allocated
+ * memory for the output
+ * payload. This may be
+ * used to impose an upper limit on
+ * the instant bitrate, but should
+ * not be used as the only bitrate
+ * control. Use #OPUS_SET_BITRATE to
+ * control the bitrate.
* @returns The length of the encoded packet (in bytes) on success or a
* negative error code (see @ref opus_errorcodes) on failure.
*/
@@ -378,12 +380,14 @@
* @param[out] data <tt>unsigned char*</tt>: Output payload.
* This must contain storage for at
* least \a max_data_bytes.
- * @param max_data_bytes <tt>opus_int32</tt>: Size of the allocated memory for
- * the output payload. This may be
- * used to impose an upper limit on
- * the variable bitrate, but should
- * not be used as the only bitrate
- * control.
+ * @param [in] max_data_bytes <tt>opus_int32</tt>: Size of the allocated
+ * memory for the output
+ * payload. This may be
+ * used to impose an upper limit on
+ * the instant bitrate, but should
+ * not be used as the only bitrate
+ * control. Use #OPUS_SET_BITRATE to
+ * control the bitrate.
* @returns The length of the encoded packet (in bytes) on success or a
* negative error code (see @ref opus_errorcodes) on failure.
*/