final merge of changes from the end of the flac 1.0.4 maintenance branch
diff --git a/doc/html/documentation.html b/doc/html/documentation.html
index 1542541..f76a140 100644
--- a/doc/html/documentation.html
+++ b/doc/html/documentation.html
@@ -490,9 +490,9 @@
</LI>
</UL>
You may use many -S options; the resulting SEEKTABLE will be the unique-ified union of all such values.<BR>
- With no -S options, flac defaults to '-S 100x'. Use -S- for no SEEKTABLE.<BR>
+ With no -S options, flac defaults to '-S 100x'. Use --no-seektable for no SEEKTABLE.<BR>
<B>NOTE:</B> -S #x will not work if the encoder can't determine the input size before starting.<BR>
- <B>NOTE:</B> if you use -S # and # is >= samples in the input, there will be either no seek point entered (if the input size is determinable before encoding starts) or a placeholder point (if input size is not determinable).<BR>
+ <B>NOTE:</B> if you use -S # and # is >= samples in the input, there will be either no seek point entered (if the input size is determinable before encoding starts) or a placeholder point (if input size is not determinable).<BR>
</TD>
</TR>
<TR>
@@ -500,7 +500,7 @@
<TT>-P #</TT>, <TT>--padding=#</TT>
</TD>
<TD>
- Tell the encoder to write a <TT>PADDING</TT> metadata block of the given length (in bytes) after the <TT>STREAMINFO</TT> block. This is useful if you plan to tag the file later with an <TT>APPLICATION</TT> block; instead of having to rewrite the entire file later just to insert your block, you can write directly over the <TT>PADDING</TT> block. Note that the total length of the <TT>PADDING</TT> block will be 4 bytes longer than the length given because of the 4 metadata block header bytes. You can force no <TT>PADDING</TT> block at all to be written with <TT>-P-</TT>, which is the default.
+ Tell the encoder to write a <TT>PADDING</TT> metadata block of the given length (in bytes) after the <TT>STREAMINFO</TT> block. This is useful if you plan to tag the file later with an <TT>APPLICATION</TT> block; instead of having to rewrite the entire file later just to insert your block, you can write directly over the <TT>PADDING</TT> block. Note that the total length of the <TT>PADDING</TT> block will be 4 bytes longer than the length given because of the 4 metadata block header bytes. You can force no <TT>PADDING</TT> block at all to be written with <TT>--no-padding</TT>, which is the default.
</TD>
</TR>
<TR>
@@ -524,7 +524,7 @@
<TT>-m</TT>, <TT>--mid-side</TT>
</TD>
<TD>
- Enable mid-side coding (only for stereo streams). Tends to increase compression by a few percent on average. For each block both the stereo pair and mid-side versions of the block will be encoded, and smallest resulting frame will be stored. Currently mid-side encoding is only available when bits-per-sample <= 16.
+ Enable mid-side coding (only for stereo streams). Tends to increase compression by a few percent on average. For each block both the stereo pair and mid-side versions of the block will be encoded, and smallest resulting frame will be stored. Currently mid-side encoding is only available when bits-per-sample <= 16.
</TD>
</TR>
<TR>
@@ -644,7 +644,7 @@
<TT>-l #</TT>, <TT>--max-lpc-order=#</TT>
</TD>
<TD>
- Specifies the maximum LPC order. This number must be <= 32. If 0, the encoder will not attempt generic linear prediction, and use only fixed predictors. Using fixed predictors is faster but usually results in files being 5-10% larger.
+ Specifies the maximum LPC order. This number must be <= 32. If 0, the encoder will not attempt generic linear prediction, and use only fixed predictors. Using fixed predictors is faster but usually results in files being 5-10% larger.
</TD>
</TR>
<TR>
@@ -888,7 +888,10 @@
<P>
<UL>
<LI>
- None.
+ <B><TT>metaflac</TT></B> has a bug where, if --import-vc-from is used on a FLAC file that has no Vorbis comment block, the FLAC file can be corrupted. All FLAC files generated by 1.0.4 have a Vorbis comment block added automatically but files from 1.0.3 and before do not. This is fixed in CVS.
+ </LI>
+ <LI>
+ There is an odd bug in <B><TT>metaflac</TT></B> such that you must always use the <TT>--dont-use-padding</TT> option with <TT>--add-padding</TT> or the padding block won't be written. This is fixed in CVS.
</LI>
</UL>
</P>