minor comments

diff --git a/include/FLAC/stream_decoder.h b/include/FLAC/stream_decoder.h
index 7c82653e0591344e2863307f96244b5bbbbfbc55..d2fb6bb756d10dc670dbc56facb94e5d81db3b03 100644 (file)
--- a/include/FLAC/stream_decoder.h
+++ b/include/FLAC/stream_decoder.h
@@ -677,7 +677,7 @@ FLAC_API unsigned FLAC__stream_decoder_get_blocksize(const FLAC__StreamDecoder *
  * \assert
  *    \code decoder != NULL \endcode
  * \retval FLAC__StreamDecoderState
- *    \c FLAC__STREAM_DECODER_SEARCH_FOR_MEATADATA if initialization was
+ *    \c FLAC__STREAM_DECODER_SEARCH_FOR_METADATA if initialization was
  *    successful; see FLAC__StreamDecoderState for the meanings of other
  *    return values.
  */

diff --git a/include/OggFLAC/seekable_stream_decoder.h b/include/OggFLAC/seekable_stream_decoder.h
index 6314f0eb17e82d6534b7628e3c48a81c6ff22155..ade8f66b3a975d55bab56e9b792f559d2f4acc22 100644 (file)
--- a/include/OggFLAC/seekable_stream_decoder.h
+++ b/include/OggFLAC/seekable_stream_decoder.h
@@ -123,7 +123,7 @@ typedef struct {
        struct OggFLAC__SeekableStreamDecoderPrivate *private_; /* avoid the C++ keyword 'private' */
 } OggFLAC__SeekableStreamDecoder;
 
-/*@@@ document */
+/*@@@@ document */
 typedef FLAC__SeekableStreamDecoderReadStatus (*OggFLAC__SeekableStreamDecoderReadCallback)(const OggFLAC__SeekableStreamDecoder *decoder, FLAC__byte buffer[], unsigned *bytes, void *client_data);
 typedef FLAC__SeekableStreamDecoderSeekStatus (*OggFLAC__SeekableStreamDecoderSeekCallback)(const OggFLAC__SeekableStreamDecoder *decoder, FLAC__uint64 absolute_byte_offset, void *client_data);
 typedef FLAC__SeekableStreamDecoderTellStatus (*OggFLAC__SeekableStreamDecoderTellCallback)(const OggFLAC__SeekableStreamDecoder *decoder, FLAC__uint64 *absolute_byte_offset, void *client_data);
@@ -165,7 +165,7 @@ OggFLAC_API void OggFLAC__seekable_stream_decoder_delete(OggFLAC__SeekableStream
  *
  ***********************************************************************/
 
-/*@@@inherit set_serial_number*/
+/*@@@@inherit set_serial_number*/
 
 /** Set the "MD5 signature checking" flag.
  *  This is inherited from FLAC__SeekableStreamDecoder; see

diff --git a/include/OggFLAC/stream_decoder.h b/include/OggFLAC/stream_decoder.h
index f3e5a83f82f5181870adef418b44422beb821265..9d9ed9fa39b4a2db1d2d8f5cc98cd75f51cc844f 100644 (file)
--- a/include/OggFLAC/stream_decoder.h
+++ b/include/OggFLAC/stream_decoder.h
@@ -69,7 +69,7 @@ extern "C" {
  *  This module contains the functions which implement the stream
  *  decoder.
  *
- * The interface here is identical to FLAC's stream decoder,
+ * The interface here is nearly identical to FLAC's stream decoder,
  * including the callbacks, with the addition of
  * OggFLAC__stream_decoder_set_serial_number().  See the
  * \link flac_stream_decoder FLAC stream decoder module \endlink
@@ -317,7 +317,7 @@ OggFLAC_API FLAC__bool OggFLAC__stream_decoder_set_client_data(OggFLAC__StreamDe
 
 /** Set the serial number for the Ogg stream.
  * The default behavior is to use the serial number of the first Ogg
- * page.  Setting a serial number here will explicitly define which
+ * page.  Setting a serial number here will explicitly specify which
  * stream is to be decoded.
  *
  * \default \c use serial number of first page