Commit af653828 authored by Josh Coalson's avatar Josh Coalson

add note about re-encoding older versions of Ogg FLAC

parent 68d13215
......@@ -106,7 +106,7 @@
<LI>
Ogg FLAC format:
<UL>
<LI>First official FLAC-&gt;Ogg bitstream mapping standardized (see new <A HREF="ogg_mapping.html">FLAC-to-Ogg mapping specification</A>)</LI>
<LI>First official FLAC-&gt;Ogg bitstream mapping standardized (see new <A HREF="ogg_mapping.html">FLAC-to-Ogg mapping specification</A>). See the documentation for the <A HREF="documentation.html#flac_options_ogg"><TT>--ogg</TT></A> switch about having to re-encode older Ogg FLAC files.</LI>
</UL>
</LI>
<LI>
......
......@@ -438,7 +438,8 @@
</TD>
<TD>
When encoding, generate Ogg FLAC output instead of native FLAC. Ogg FLAC streams are FLAC streams wrapped in an Ogg transport layer. The resulting file should have an '.ogg' extension and will still be decodable by <TT><B>flac</B></TT>.<P>
When decoding, force the input to be treated as Ogg FLAC. This is useful when piping input from stdin or when the filename does not end in '.ogg'.
When decoding, force the input to be treated as Ogg FLAC. This is useful when piping input from stdin or when the filename does not end in '.ogg'.<P>
<B>NOTE:</B> Ogg FLAC files created prior to <B><TT>flac</TT></B> 1.1.1 used an ad-hoc mapping and do not support seeking. They should be decoded and re-encoded with <B><TT>flac</TT></B> 1.1.1 or later.
</TD>
</TR>
<A NAME="flac_options_serial_number">
......
......@@ -98,7 +98,7 @@
In the interest of simplicity and expediency, the second method was chosen for the first official FLAC-&gt;Ogg mapping. A mapping version is included in the first packet so that a less redundant mapping can be defined in the future.
</P>
<P>
It should also be noted that support for encapsulating FLAC in Ogg has been present in the FLAC tools since version 1.0.1. However, the mappings used were never formalized and have insurmountable problems. For that reason, Ogg FLAC streams created with <B><TT>flac</TT></B> versions before 1.1.1 should be decoded by the corresponding version of <B><TT>flac</TT></B>, and re-encoded with <B><TT>flac</TT></B> 1.1.1 or later. Since the support for Ogg FLAC before FLAC 1.1.1 was limited, we hope this will not result in too much inconvenience.
It should also be noted that support for encapsulating FLAC in Ogg has been present in the FLAC tools since version 1.0.1. However, the mappings used were never formalized and have insurmountable problems. For that reason, Ogg FLAC streams created with <B><TT>flac</TT></B> versions before 1.1.1 should be decoded and re-encoded with <B><TT>flac</TT></B> 1.1.1 or later (<B><TT>flac</TT></B> 1.1.1 can decode all previous Ogg FLAC files, but files made prior to 1.1.0 don't support seeking). Since the support for Ogg FLAC before FLAC 1.1.1 was limited, we hope this will not result in too much inconvenience.
</P>
<P>
Version 1.0 of the FLAC-to-Ogg mapping then is a simple identifying header followed by pure native FLAC data, as follows:
......
Markdown is supported
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