From af653828eafccd49684af093cf268e607d4c4e5e Mon Sep 17 00:00:00 2001 From: Josh Coalson Date: Tue, 14 Sep 2004 00:41:39 +0000 Subject: [PATCH] add note about re-encoding older versions of Ogg FLAC --- doc/html/changelog.html | 2 +- doc/html/documentation.html | 3 ++- doc/html/ogg_mapping.html | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/doc/html/changelog.html b/doc/html/changelog.html index 2087fd0..8a7b1b0 100644 --- a/doc/html/changelog.html +++ b/doc/html/changelog.html @@ -106,7 +106,7 @@
  • Ogg FLAC format:
  • diff --git a/doc/html/documentation.html b/doc/html/documentation.html index cb1e84d..5f28974 100644 --- a/doc/html/documentation.html +++ b/doc/html/documentation.html @@ -438,7 +438,8 @@ 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 flac.

    - 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'.

    + NOTE: Ogg FLAC files created prior to flac 1.1.1 used an ad-hoc mapping and do not support seeking. They should be decoded and re-encoded with flac 1.1.1 or later. diff --git a/doc/html/ogg_mapping.html b/doc/html/ogg_mapping.html index fe9e01d..8c72bee 100644 --- a/doc/html/ogg_mapping.html +++ b/doc/html/ogg_mapping.html @@ -98,7 +98,7 @@ In the interest of simplicity and expediency, the second method was chosen for the first official FLAC->Ogg mapping. A mapping version is included in the first packet so that a less redundant mapping can be defined in the future.

    - 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 flac versions before 1.1.1 should be decoded by the corresponding version of flac, and re-encoded with flac 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 flac versions before 1.1.1 should be decoded and re-encoded with flac 1.1.1 or later (flac 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.

    Version 1.0 of the FLAC-to-Ogg mapping then is a simple identifying header followed by pure native FLAC data, as follows: -- 2.7.4