From 85d7b9f01c9fe00cbcd60cd4b7281e37dac2e84a Mon Sep 17 00:00:00 2001 From: Josh Coalson Date: Wed, 7 Jul 2004 19:45:48 +0000 Subject: [PATCH] minor comments --- include/FLAC/metadata.h | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/include/FLAC/metadata.h b/include/FLAC/metadata.h index f8d99276..6345ef14 100644 --- a/include/FLAC/metadata.h +++ b/include/FLAC/metadata.h @@ -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()