Commit 85d7b9f0 authored by Josh Coalson's avatar Josh Coalson
Browse files

minor comments

parent 0e33f035
......@@ -76,8 +76,9 @@
* the whole file is read into memory and manipulated before writing
* out again.
*
* What do we mean by efficient? When writing metadata back to a FLAC
* file it is possible to grow or shrink the metadata such that the entire
* What do we mean by efficient? Since FLAC metadata appears at the
* beginning of the file, when writing metadata back to a FLAC file
* it is possible to grow or shrink the metadata such that the entire
* file must be rewritten. However, if the size remains the same during
* changes or PADDING blocks are utilized, only the metadata needs to be
* overwritten, which is much faster.
......@@ -186,7 +187,7 @@ FLAC_API FLAC__bool FLAC__metadata_get_streaminfo(const char *filename, FLAC__St
*
* \note
* Do not modify the \a is_last, \a length, or \a type fields of returned
* FLAC__MetadataType objects. These are managed automatically.
* FLAC__StreamMetadata objects. These are managed automatically.
*
* \note
* If any of the modification functions
......@@ -524,7 +525,7 @@ FLAC_API FLAC__bool FLAC__metadata_simple_iterator_delete_block(FLAC__Metadata_S
*
* \note
* Do not modify the is_last, length, or type fields of returned
* FLAC__MetadataType objects. These are managed automatically.
* FLAC__StreamMetadata objects. These are managed automatically.
*
* \note
* The metadata objects returned by FLAC__metadata_iterator_get_block()
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment