mirrors
/
flac
mirror of https://github.com/xiph/flac
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Various documentation fixes, merge with website 

The html documentation was diff'ed to the current website pages
and all difference were merged into the page they weren't yet
incorporated. This includes lots of small fixes and
improvements.

Signed-off-by: Erik de Castro Lopo <erikd@mega-nerd.com>
This commit is contained in:
Martijn van Beurden 2014-08-01 09:57:38 +02:00 committed by Erik de Castro Lopo
parent 27846708fe
commit 0ae3e4689d
12 changed files with 479 additions and 203 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/html/Makefile.am
View File

@ -30,7 +30,6 @@ doc_DATA = \
documentation_tools.html \
documentation_tools_flac.html \
documentation_tools_metaflac.html \
documentation_tools_plugins.html \
faq.html \
favicon.ico \
features.html \

509
doc/html/changelog.html
View File

@ -8,7 +8,7 @@
<!-- A copy of the license can be found at http://www.gnu.org/copyleft/fdl.html -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta name="author" content="Josh Coalson" />
<meta name="description" content="A free, open source codec for lossless audio compression and decompression" />
<meta name="keywords" content="free,lossless,audio,codec,encoder,decoder,compression,compressor,archival,archive,archiving,backup,music" />
@ -76,24 +76,24 @@
<li>
flac:
<ul>
<li>Added support for encoding from and decoding to the RF64 format, and a new corresponding option <span class="argument"><a href="#flac_options_force_rf64_format">--force-rf64-format</a></span>. (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1762502&amp;group_id=13478&amp;atid=363478">SF #1762502</a>). <span class="argument"><a href="documentation_tools_flac.html#flac_options_keep_foreign_metadata">--keep-foreign-metadata</a></span> is also supported.</li>
<li>Added support for encoding from and decoding to the Sony Wave64 format, and a new corresponding option <span class="argument"><a href="#flac_options_force_wave64_format">--force-wave64-format</a></span>. (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1769582&amp;group_id=13478&amp;atid=363478">SF #1769582</a>). <span class="argument"><a href="documentation_tools_flac.html#flac_options_keep_foreign_metadata">--keep-foreign-metadata</a></span> is also supported.</li>
<li>Added new options <span class="argument"><a href="documentation_tools_flac.html#flac_options_preserve_modtime">--preserve-modtime</a></span> and <span class="argument"><a href="documentation_tools_flac.html#flac_options_no_preserve_modtime">--no-preserve-modtime</a></span> to specify whether or not output files should copy the timestamp and permissions from their input files. The default is <span class="argument"><a href="documentation_tools_flac.html#flac_options_preserve_modtime">--preserve-modtime</a></span> as in previous versions. (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1805428&amp;group_id=13478&amp;atid=363478">SF #1805428</a>).</li>
<li>Allow MM:SS:FF and MM:SS.SS time formats in non-CD-DA cuesheets. (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1947353&amp;group_id=13478&amp;atid=363478">SF #1947353</a>, <a href="https://sourceforge.net/tracker2/index.php?func=detail&amp;aid=2182432&amp;group_id=13478&amp;atid=113478">SF #2182432</a>)</li>
<li>The <span class="argument"><a href="documentation_tools_flac.html#flac_options_sector_align">--sector-align</a></span> option of <span class="commandname">flac</span> has been deprecated and may not exist in future versions. <a href="http://www.etree.org/shnutils/shntool/">shntool</a> provides similar functionality. (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1805946&amp;group_id=13478&amp;atid=363478">SF #1805946</a>)</li>
<li>Improved error message when user attempts to decode a non-FLAC file (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=2222789&amp;group_id=13478&amp;atid=113478">SF #2222789</a>).</li>
<li>Fix bug where <span class="commandname">flac</span> was disallowing use of <span class="argument">--replay-gain</span> when encoding from stdin (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1840124&amp;group_id=13478&amp;atid=113478">SF #1840124</a>).</li>
<li>Fix bug with fractional seconds on some locales (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1815517&amp;group_id=13478&amp;atid=113478">SF #1815517</a>, <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1858012&amp;group_id=13478&amp;atid=113478">SF #1858012</a>).</li>
<li>Added support for encoding from and decoding to the RF64 format, and a new corresponding option <span class="argument"><a href="documentation_tools_flac.html#flac_options_force_rf64_format">--force-rf64-format</a></span>. (<a href="http://sourceforge.net/p/flac/feature-requests/78/">SF #1762502</a>). <span class="argument"><a href="documentation_tools_flac.html#flac_options_keep_foreign_metadata">--keep-foreign-metadata</a></span> is also supported.</li>
<li>Added support for encoding from and decoding to the Sony Wave64 format, and a new corresponding option <span class="argument"><a href="documentation_tools_flac.html#flac_options_force_wave64_format">--force-wave64-format</a></span>. (<a href="http://sourceforge.net/p/flac/feature-requests/79/">SF #1769582</a>). <span class="argument"><a href="documentation_tools_flac.html#flac_options_keep_foreign_metadata">--keep-foreign-metadata</a></span> is also supported.</li>
<li>Added new options <span class="argument"><a href="documentation_tools_flac.html#flac_options_preserve_modtime">--preserve-modtime</a></span> and <span class="argument"><a href="documentation_tools_flac.html#negative_options">--no-preserve-modtime</a></span> to specify whether or not output files should copy the timestamp and permissions from their input files. The default is <span class="argument"><a href="documentation_tools_flac.html#flac_options_preserve_modtime">--preserve-modtime</a></span> as in previous versions. (<a href="http://sourceforge.net/p/flac/feature-requests/85/">SF #1805428</a>).</li>
<li>Allow MM:SS:FF and MM:SS.SS time formats in non-CD-DA cuesheets. (<a href="http://sourceforge.net/p/flac/feature-requests/95/">SF #1947353</a>, <a href="http://sourceforge.net/p/flac/bugs/338/">SF #2182432</a>)</li>
<li>The <span class="argument"><a href="documentation_tools_flac.html#flac_options_sector_align">--sector-align</a></span> option of <span class="commandname">flac</span> has been deprecated and may not exist in future versions. <a href="http://www.etree.org/shnutils/shntool/">shntool</a> provides similar functionality. (<a href="http://sourceforge.net/p/flac/feature-requests/86/">SF #1805946</a>)</li>
<li>Improved error message when user attempts to decode a non-FLAC file (<a href="http://sourceforge.net/p/flac/bugs/341/">SF #2222789</a>).</li>
<li>Fix bug where <span class="commandname">flac</span> was disallowing use of <span class="argument">--replay-gain</span> when encoding from stdin (<a href="http://sourceforge.net/p/flac/bugs/313/">SF #1840124</a>).</li>
<li>Fix bug with fractional seconds on some locales (<a href="http://sourceforge.net/p/flac/bugs/309/">SF #1815517</a>, <a href="http://sourceforge.net/p/flac/bugs/321/">SF #1858012</a>).</li>
<li>Read and write appropriate channel masks for 6.1 and 7.1 surround input WAV files. Documentation was also updated.</li>
<li>Correct Wave64 GUIDs.</li>
<li>Support 56kHz to 192kHz gain analysis (patch from Earl Chew)</li>
<li>Add ability to handle utf8 filenames on Windows (large set of patches from Janne Hyvärinen)</li>
<li>Add ability to handle unicode filenames on Windows (large set of patches from Janne Hyv&auml;rinen)</li>
</ul>
</li>
<li>
metaflac:
<ul>
<li>Allow MM:SS:FF and MM:SS.SS time formats in non-CD-DA cuesheets. (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1947353&amp;group_id=13478&amp;atid=363478">SF #1947353</a>, <a href="https://sourceforge.net/tracker2/index.php?func=detail&amp;aid=2182432&amp;group_id=13478&amp;atid=113478">SF #2182432</a>)</li>
<li>Allow MM:SS:FF and MM:SS.SS time formats in non-CD-DA cuesheets. (<a href="http://sourceforge.net/p/flac/feature-requests/95/">SF #1947353</a>, <a href="http://sourceforge.net/p/flac/bugs/338/">SF #2182432</a>)</li>
</ul>
</li>
<li>
@ -106,16 +106,17 @@
<li>
build system:
<ul>
<li>Fixes for autotools (including <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1859664&amp;group_id=13478&amp;atid=313478">SF #1859664</a>).</li>
<li>Fixes for MinGW (including <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=2000973&amp;group_id=13478&amp;atid=113478">SF #2000973</a>, <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=2209829&amp;group_id=13478&amp;atid=113478">SF #2209829</a>).</li>
<li>Fixes for gcc (including <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1834168&amp;group_id=13478&amp;atid=113478">SF #1834168</a>, <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=2002481&amp;group_id=13478&amp;atid=113478">SF #2002481</a>).</li>
<li>Fixes for Sun Studio/Forte (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1701960&amp;group_id=13478&amp;atid=313478">SF #1701960</a>).</li>
<li>Fixes for windows builds (including <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1676822&amp;group_id=13478&amp;atid=113478">SF #1676822</a>, <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1756624&amp;group_id=13478&amp;atid=363478">SF #1756624</a>, <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1809863&amp;group_id=13478&amp;atid=113478">SF #1809863</a>, <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1911149&amp;group_id=13478&amp;atid=363478">SF #1911149</a>).</li>
<li>Fixes for autotools (including <a href="http://sourceforge.net/p/flac/patches/28/">SF #1859664</a>).</li>
<li>Fixes for MinGW (including <a href="http://sourceforge.net/p/flac/bugs/">SF #2000973</a>, <a href="http://sourceforge.net/p/flac/bugs/">SF #2209829</a>).</li>
<li>Fixes for gcc (including <a href="http://sourceforge.net/p/flac/bugs/">SF #1834168</a>, <a href="http://sourceforge.net/p/flac/bugs/334/">SF #2002481</a>).</li>
<li>Fixes for Sun Studio/Forte (<a href="http://sourceforge.net/p/flac/patches/22/">SF #1701960</a>).</li>
<li>Fixes for windows builds (including <a href="http://sourceforge.net/p/flac/bugs/257/">SF #1676822</a>, <a href="http://sourceforge.net/p/flac/feature-requests/73/">SF #1756624</a>, <a href="http://sourceforge.net/p/flac/bugs/307/">SF #1809863</a>, <a href="http://sourceforge.net/p/flac/feature-requests/">SF #1911149</a>).</li>
<li>Fixes for FreeBSD and OpenBSD.</li>
<li>Compile with GNU gcc _FORTIFY_SOURCE=2 and stack protection where those features are detected.</li>
<li>Enable a bunch of GCC compiler warnings and fix code that generates warnings.</li>
</ul>
</li>
<li>
documentation:
<ul>
@ -127,9 +128,9 @@
<li>
libraries:
<ul>
<li>libFLAC encoder was defaulting to level 0 compression instead of 5 (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1816825&amp;group_id=13478&amp;atid=113478">SF #1816825</a>).</li>
<li>Fix bug in bitreader handling of read callback returning a short count (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=2490454&amp;group_id=13478&amp;atid=113478">SF #2490454</a>).</li>
<li>Improve decoder's ability to distinguish between a FLAC sync code and an MPEG one (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=2491433&amp;group_id=13478&amp;atid=113478">SF #2491433</a>).</li>
<li>libFLAC encoder was defaulting to level 0 compression instead of 5 (<a href="http://sourceforge.net/p/flac/bugs/310/">SF #1816825</a>).</li>
<li>Fix bug in bitreader handling of read callback returning a short count (<a href="http://sourceforge.net/p/flac/bugs/345/">SF #2490454</a>).</li>
<li>Improve decoder's ability to distinguish between a FLAC sync code and an MPEG one (<a href="http://sourceforge.net/p/flac/bugs/346/">SF #2491433</a>).</li>
</ul>
</li>
<li>
@ -174,25 +175,25 @@
<li>
Ogg FLAC format:
<ul>
<li>This is not a format change, but changed default extension for Ogg FLAC from .ogg to .oga, according to new Xiph <a href="http://wiki.xiph.org/index.php/MIME_Types_and_File_Extensions">specification</a> (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1762492&amp;group_id=13478&amp;atid=113478">SF #1762492</a>).</li>
<li>This is not a format change, but changed default extension for Ogg FLAC from .ogg to .oga, according to new Xiph <a href="http://wiki.xiph.org/index.php/MIME_Types_and_File_Extensions">specification</a> (<a href="http://sourceforge.net/p/flac/bugs/283/">SF #1762492</a>).</li>
</ul>
</li>
<li>
flac:
<ul>
<li>Added a new option <span class="argument"><a href="documentation_tools_flac.html#flac_options_no_utf8_convert">--no-utf8-convert</a></span> which works like it does in <span class="commandname">metaflac</span> (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=973740&amp;group_id=13478&amp;atid=363478">SF #973740</a>).</li>
<li>Added a new option <span class="argument"><a href="documentation_tools_flac.html#flac_options_keep_foreign_metadata">--keep-foreign-metadata</a></span> which can save/restore RIFF and AIFF chunks to/from FLAC files (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=568264&amp;group_id=13478&amp;atid=363478">SF #363478</a>).</li>
<li>Changed default extension for Ogg FLAC from .ogg to .oga, according to new Xiph <a href="http://wiki.xiph.org/index.php/MIME_Types_and_File_Extensions">specification</a> (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1762492&amp;group_id=13478&amp;atid=113478">SF #1762492</a>).</li>
<li>Fixed bug where using <span class="argument">--replay-gain</span> without any padding option caused only a small PADDING block to be created (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1760790&amp;group_id=13478&amp;atid=113478">SF #1760790</a>).</li>
<li>Fixed bug where encoding from stdin on Windows could fail if WAVE/AIFF contained unknown chunks (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1776803&amp;group_id=13478&amp;atid=113478">SF #1776803</a>).</li>
<li>Fixed bug where importing non-CDDA cuesheets would cause an invalid lead-out track number (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1764105&amp;group_id=13478&amp;atid=113478">SF #1764105</a>).</li>
<li>Added a new option <span class="argument"><a href="documentation_tools_flac.html#flac_options_no_utf8_convert">--no-utf8-convert</a></span> which works like it does in <span class="commandname">metaflac</span> (<a href="http://sourceforge.net/p/flac/feature-requests/35/">SF #973740</a>).</li>
<li>Added a new option <span class="argument"><a href="documentation_tools_flac.html#flac_options_keep_foreign_metadata">--keep-foreign-metadata</a></span> which can save/restore RIFF and AIFF chunks to/from FLAC files (<a href="http://sourceforge.net/p/flac/feature-requests/9/">SF #363478</a>).</li>
<li>Changed default extension for Ogg FLAC from .ogg to .oga, according to new Xiph <a href="http://wiki.xiph.org/index.php/MIME_Types_and_File_Extensions">specification</a> (<a href="http://sourceforge.net/p/flac/bugs/283/">SF #1762492</a>).</li>
<li>Fixed bug where using <span class="argument">--replay-gain</span> without any padding option caused only a small PADDING block to be created (<a href="http://sourceforge.net/p/flac/bugs/282/">SF #1760790</a>).</li>
<li>Fixed bug where encoding from stdin on Windows could fail if WAVE/AIFF contained unknown chunks (<a href="http://sourceforge.net/p/flac/bugs/290/">SF #1776803</a>).</li>
<li>Fixed bug where importing non-CDDA cuesheets would cause an invalid lead-out track number (<a href="http://sourceforge.net/p/flac/bugs/286/">SF #1764105</a>).</li>
</ul>
</li>
<li>
metaflac:
<ul>
<li>Changed default extension for Ogg FLAC from .ogg to .oga, according to new Xiph <a href="http://wiki.xiph.org/index.php/MIME_Types_and_File_Extensions">specification</a> (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1762492&amp;group_id=13478&amp;atid=113478">SF #1762492</a>).</li>
<li>Fixed bug where importing non-CDDA cuesheets would cause an invalid lead-out track number (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1764105&amp;group_id=13478&amp;atid=113478">SF #1764105</a>).</li>
<li>Changed default extension for Ogg FLAC from .ogg to .oga, according to new Xiph <a href="http://wiki.xiph.org/index.php/MIME_Types_and_File_Extensions">specification</a> (<a href="http://sourceforge.net/p/flac/bugs/283/">SF #1762492</a>).</li>
<li>Fixed bug where importing non-CDDA cuesheets would cause an invalid lead-out track number (<a href="http://sourceforge.net/p/flac/bugs/286/">SF #1764105</a>).</li>
</ul>
</li>
<li>
@ -204,14 +205,14 @@
<li>
build system:
<ul>
<li>New configure option <span class="argument">--disable-cpplibs</span> to prevent building libFLAC++ (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1723295&amp;group_id=13478&amp;atid=313478">SF #1723295</a>).</li>
<li>Fixed bug compiling <span class="commandname">flac</span> without Ogg support (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1760786&amp;group_id=13478&amp;atid=113478">SF #1760786</a>).</li>
<li>Fixed bug where sometimes an existing installation of flac could interfere with the build process (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1763690&amp;group_id=13478&amp;atid=113478">SF #1763690</a>).</li>
<li>OS X fixes (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1786225&amp;group_id=13478&amp;atid=313478">SF #1786225</a>).</li>
<li>MinGW fixes (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1684879&amp;group_id=13478&amp;atid=113478">SF #1684879</a>).</li>
<li>Solaris 10 fixes (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1783225&amp;group_id=13478&amp;atid=113478">SF #1783225</a> <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1783630&amp;group_id=13478&amp;atid=113478">SF #1783630</a>).</li>
<li>OS/2 fixes (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1771378&amp;group_id=13478&amp;atid=113478">SF #1771378</a> <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1229495&amp;group_id=13478&amp;atid=113478">SF #1229495</a>).</li>
<li>automake-1.10 fixes (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1791361&amp;group_id=13478&amp;atid=113478">SF #1791361</a> <a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1792179&amp;group_id=13478&amp;atid=113478">SF #1792179</a>).</li>
<li>New configure option <span class="argument">--disable-cpplibs</span> to prevent building libFLAC++ (<a href="http://sourceforge.net/p/flac/patches/23/">SF #1723295</a>).</li>
<li>Fixed bug compiling <span class="commandname">flac</span> without Ogg support (<a href="http://sourceforge.net/p/flac/bugs/281/">SF #1760786</a>).</li>
<li>Fixed bug where sometimes an existing installation of flac could interfere with the build process (<a href="http://sourceforge.net/p/flac/bugs/285/">SF #1763690</a>).</li>
<li>OS X fixes (<a href="http://sourceforge.net/p/flac/patches/25/">SF #1786225</a>).</li>
<li>MinGW fixes (<a href="http://sourceforge.net/p/flac/bugs/264/">SF #1684879</a>).</li>
<li>Solaris 10 fixes (<a href="http://sourceforge.net/p/flac/bugs/294/">SF #1783225</a> <a href="http://sourceforge.net/p/flac/bugs/295/">SF #1783630</a>).</li>
<li>OS/2 fixes (<a href="http://sourceforge.net/p/flac/bugs/287/">SF #1771378</a> <a href="http://sourceforge.net/p/flac/bugs/174/">SF #1229495</a>).</li>
<li>automake-1.10 fixes (<a href="http://sourceforge.net/p/flac/bugs/300/">SF #1791361</a> <a href="http://sourceforge.net/p/flac/bugs/302/">SF #1792179</a>).</li>
</ul>
</li>
<li>
@ -224,9 +225,9 @@
<li>
libraries:
<ul>
<li>libFLAC: Fixed very rare seek bug (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1684049&amp;group_id=13478&amp;atid=113478">SF #1684049</a>).</li>
<li>libFLAC: Fixed seek bug with Ogg FLAC and small streams (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1792172&amp;group_id=13478&amp;atid=113478">SF #1792172</a>).</li>
<li>libFLAC: 64-bit fixes (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1790872&amp;group_id=13478&amp;atid=113478">SF #1790872</a>).</li>
<li>libFLAC: Fixed very rare seek bug (<a href="http://sourceforge.net/p/flac/bugs/263/">SF #1684049</a>).</li>
<li>libFLAC: Fixed seek bug with Ogg FLAC and small streams (<a href="http://sourceforge.net/p/flac/bugs/301/">SF #1792172</a>).</li>
<li>libFLAC: 64-bit fixes (<a href="http://sourceforge.net/p/flac/bugs/299/">SF #1790872</a>).</li>
<li>libFLAC: Fix assembler code to be position independent.</li>
<li>libFLAC: Optimization of a number of inner loop functions.</li>
<li>Added support for encoding the residual coding method introduced in libFLAC 1.2.0 (RESIDUAL_CODING_METHOD_PARTITIONED_RICE2) which will encode 24-bit files more efficiently.</li>
@ -367,10 +368,10 @@
<li>Encoding and decoding speedups for all modes. Encoding at -8 is twice as fast.</li>
<li>Added a new option <span class="argument"><a href="documentation_tools_flac.html#flac_options_warnings_as_errors">-w,--warnings-as-errors</a></span> for treating all warnings as errors.</li>
<li>Allow <span class="argument"><a href="documentation_tools_flac.html#flac_options_picture">--picture</a></span> option to take only a filename, and have all other attributes extracted from the file itself.</li>
<li>Fixed a bug that caused suboptimal default compression settings in some locales (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1608883&amp;group_id=13478&amp;atid=113478">SF #1608883</a>).</li>
<li>Fixed a bug where FLAC-to-FLAC transcoding of a corrupted FLAC file would truncate the transcoded file at the first error (<a href="http://sourceforge.net/tracker2/?func=detail&amp;aid=1615019&amp;group_id=13478&amp;atid=113478">SF #1615019</a>).</li>
<li>Fixed a bug where using <span class="argument"><a href="documentation_tools_flac.html#flac_options_decode_through_errors">-F</a></span> with FLAC-to-FLAC transcoding of a corrupted FLAC would have no effect (<a href="http://sourceforge.net/tracker2/?func=detail&amp;aid=1615391&amp;group_id=13478&amp;atid=113478">SF #1615391</a>).</li>
<li>Fixed a bug where new PICTURE metadata blocks specified with <span class="argument"><a href="documentation_tools_flac.html#flac_options_picture">--picture</a></span> would not be transferred during FLAC-to-FLAC transcoding (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1627993&amp;group_id=13478&amp;atid=113478">SF #1627993</a>).</li>
<li>Fixed a bug that caused suboptimal default compression settings in some locales (<a href="http://sourceforge.net/p/flac/bugs/237/">SF #1608883</a>).</li>
<li>Fixed a bug where FLAC-to-FLAC transcoding of a corrupted FLAC file would truncate the transcoded file at the first error (<a href="http://sourceforge.net/p/flac/bugs/241/">SF #1615019</a>).</li>
<li>Fixed a bug where using <span class="argument"><a href="documentation_tools_flac.html#flac_options_decode_through_errors">-F</a></span> with FLAC-to-FLAC transcoding of a corrupted FLAC would have no effect (<a href="http://sourceforge.net/p/flac/bugs/242/">SF #1615391</a>).</li>
<li>Fixed a bug where new PICTURE metadata blocks specified with <span class="argument"><a href="documentation_tools_flac.html#flac_options_picture">--picture</a></span> would not be transferred during FLAC-to-FLAC transcoding (<a href="http://sourceforge.net/p/flac/bugs/246/">SF #1627993</a>).</li>
</ul>
</li>
<li>
@ -382,15 +383,15 @@
<li>
plugins:
<ul>
<li>Fixed a bug in the XMMS plugin where Ctrl-3 (file info) would cause a crash if the file did not exist (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1634941&amp;group_id=13478&amp;atid=313478">SF #1634941</a>).</li>
<li>Fixed a bug in the XMMS plugin where Ctrl-3 (file info) would cause a crash if the file did not exist (<a href="http://sourceforge.net/p/flac/patches/20/">SF #1634941</a>).</li>
</ul>
</li>
<li>
build system:
<ul>
<li>Fixed a makefile linkage bug with libogg (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1611414&amp;group_id=13478&amp;atid=113478">SF #1611414</a>).</li>
<li>Added pkg-config files for libFLAC and libFLAC++ (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1647881&amp;group_id=13478&amp;atid=313478">SF #1647881</a>).</li>
<li>Added <span class="argument">--disable-ogg</span> option for building without Ogg support even if libogg is installed (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1196996&amp;group_id=13478&amp;atid=113478">SF #1196996</a>).</li>
<li>Fixed a makefile linkage bug with libogg (<a href="http://sourceforge.net/p/flac/bugs/239/">SF #1611414</a>).</li>
<li>Added pkg-config files for libFLAC and libFLAC++ (<a href="http://sourceforge.net/p/flac/patches/21/">SF #1647881</a>).</li>
<li>Added <span class="argument">--disable-ogg</span> option for building without Ogg support even if libogg is installed (<a href="http://sourceforge.net/p/flac/bugs/165/">SF #1196996</a>).</li>
</ul>
</li>
<li>
@ -400,7 +401,7 @@
<li>Much faster Rice partition size estimation which greatly speeds encoding in higher modes.</li>
<li>Increased compression for all modes.</li>
<li>Reduced memory requirements for encoder and decoder.</li>
<li>Fixed a bug with default apodization settings that were erroneous in some locales (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1608883&amp;group_id=13478&amp;atid=113478">SF #1608883</a>).</li>
<li>Fixed a bug with default apodization settings that were erroneous in some locales (<a href="http://sourceforge.net/p/flac/bugs/237/">SF #1608883</a>).</li>
</ul>
</li>
<li>
@ -468,20 +469,20 @@
<li>Added a new option <span class="argument"><a href="documentation_tools_flac.html#flac_options_tag_from_file">--tag-from-file</a></span> for setting a tag from file (e.g. for importing a cuesheet as a tag).</li>
<li>Added a new option <span class="argument"><a href="documentation_tools_flac.html#flac_options_picture">--picture</a></span> for adding pictures.</li>
<li>Added a new option <span class="argument"><a href="documentation_tools_flac.html#flac_options_apodization">--apodization</a></span> for specifying the window function(s) to be used in LPC analysis.</li>
<li>Added support for encoding from non-compressed AIFF-C (<a href="https://sourceforge.net/tracker2/?func=detail&amp;atid=113478&amp;aid=1090933&amp;group_id=13478">SF #1090933</a>).</li>
<li>Importing of non-CDDA-compliant cuesheets now only issues a warning, not an error (see <a href="http://www.hydrogenaudio.org/forums/index.php?showtopic=31282">here</a>).</li>
<li>MD5 comparison failures on decoding are now an error instead of a warning and will also return a non-zero exit code (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1493725&amp;group_id=13478&amp;atid=113478">SF #1493725</a>).</li>
<li>Added support for encoding from non-compressed AIFF-C (<a href="http://sourceforge.net/p/flac/bugs/143/">SF #1090933</a>).</li>
<li>Importing of non-CDDA-compliant cuesheets now only issues a warning, not an error (see <a href="http://www.hydrogenaud.io/forums/index.php?showtopic=31282">here</a>).</li>
<li>MD5 comparison failures on decoding are now an error instead of a warning and will also return a non-zero exit code (<a href="http://sourceforge.net/p/flac/bugs/221/">SF #1493725</a>).</li>
<li>The default padding size is now 8K, or 64K if the input audio stream is more than 20 minutes long.</li>
<li>Fixed a bug in cuesheet parsing where it would return an error if the last line of the cuesheet did not end with a newline.</li>
<li>Fixed a bug that caused a crash when <span class="argument">-a</span> and <span class="argument">-t</span> were used together (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1229481&amp;group_id=13478&amp;atid=113478">SF #1229481</a>).</li>
<li>Fixed a bug with --sector-align where appended samples were not always totally silent (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1237707&amp;group_id=13478&amp;atid=113478">SF #1237707</a>).</li>
<li>Fixed a bug that caused a crash when <span class="argument">-a</span> and <span class="argument">-t</span> were used together (<a href="http://sourceforge.net/p/flac/bugs/173/">SF #1229481</a>).</li>
<li>Fixed a bug with --sector-align where appended samples were not always totally silent (<a href="http://sourceforge.net/p/flac/bugs/179/">SF #1237707</a>).</li>
<li>Fixed bugs with --sector-align and raw input files.</li>
<li>Fixed a bug printing out unknown AIFF subchunk names (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1267476&amp;group_id=13478&amp;atid=113478">SF #1267476</a>).</li>
<li>Fixed a bug where WAVE files with "data" subchunks of size 0 where accepted (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1293830&amp;group_id=13478&amp;atid=113478">SF #1293830</a>).</li>
<li>Fixed a bug where sync error at end-of-stream of truncated files was not being caught (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1244071&amp;group_id=13478&amp;atid=113478">SF #1244071</a>).</li>
<li>Fixed a problem with filename parsing if file does not have extension but also has a . in the path (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1161916&amp;group_id=13478&amp;atid=113478">SF #1161916</a>).</li>
<li>Fixed a problem with fractional-second parsing for <span class="argument">--skip</span>/<span class="argument">--until</span> in some locales (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1031043&amp;group_id=13478&amp;atid=113478">SF #1031043</a>).</li>
<li>Increase progress report rate when -p and -e are used together (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1580122&amp;group_id=13478&amp;atid=113478">SF #1580122</a>).</li>
<li>Fixed a bug printing out unknown AIFF subchunk names (<a href="http://sourceforge.net/p/flac/bugs/186/">SF #1267476</a>).</li>
<li>Fixed a bug where WAVE files with "data" subchunks of size 0 where accepted (<a href="http://sourceforge.net/p/flac/bugs/190/">SF #1293830</a>).</li>
<li>Fixed a bug where sync error at end-of-stream of truncated files was not being caught (<a href="http://sourceforge.net/p/flac/bugs/183/">SF #1244071</a>).</li>
<li>Fixed a problem with filename parsing if file does not have extension but also has a . in the path (<a href="http://sourceforge.net/p/flac/bugs/159/">SF #1161916</a>).</li>
<li>Fixed a problem with fractional-second parsing for <span class="argument">--skip</span>/<span class="argument">--until</span> in some locales (<a href="http://sourceforge.net/p/flac/bugs/125/">SF #1031043</a>).</li>
<li>Increase progress report rate when -p and -e are used together (<a href="http://sourceforge.net/p/flac/bugs/229/">SF #1580122</a>).</li>
</ul>
</li>
<li>
@ -492,7 +493,7 @@
<li>Added a new option <span class="argument"><a href="documentation_tools_metaflac.html#metaflac_shorthand_import_picture_from">--import-picture-from</a></span> for importing pictures.</li>
<li>Added a new option <span class="argument"><a href="documentation_tools_metaflac.html#metaflac_shorthand_export_picture_to">--export-picture-to</a></span> for exporting pictures.</li>
<li>Added shorthand operation <span class="argument"><a href="documentation_tools_metaflac.html#metaflac_shorthand_remove_replay_gain">--remove-replay-gain</a></span> for removing ReplayGain tags.</li>
<li><span class="argument"><a href="documentation_tools_metaflac.html#metaflac_shorthand_export_cuesheet_to">--export-cuesheet-to</a></span> now properly specifies the FLAC file name (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1272825&amp;group_id=13478&amp;atid=363478">SF #1272825</a>).</li>
<li><span class="argument"><a href="documentation_tools_metaflac.html#metaflac_shorthand_export_cuesheet_to">--export-cuesheet-to</a></span> now properly specifies the FLAC file name (<a href="http://sourceforge.net/p/flac/feature-requests/46/">SF #1272825</a>).</li>
<li>Importing of non-CDDA-compliant cuesheets now issues a warning.</li>
<li>Removed the following deprecated tag editing options; you should use the new option names shown instead:
<ul>
@ -506,7 +507,7 @@
<li>Removed <span class="argument">--export-vc-to</span>; use <span class="argument">--export-tags-to</span></li>
</ul>
</li>
<li>Disallow multiple input FLAC files when --import-tags-from=- is used (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1082577&amp;group_id=13478&amp;atid=113478">SF #1082577</a>).</li>
<li>Disallow multiple input FLAC files when --import-tags-from=- is used (<a href="http://sourceforge.net/p/flac/bugs/141/">SF #1082577</a>).</li>
</ul>
</li>
<li>
@ -520,11 +521,11 @@
<li>
build system:
<ul>
<li>Added support for building on OS/2 with EMX (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1229495&amp;group_id=13478&amp;atid=113478">SF #1229495</a>)</li>
<li>Added support for building with Borland C++ (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1599018&amp;group_id=13478&amp;atid=313478">SF #1599018</a>)</li>
<li>Added a <span class="argument">--disable-xmms-plugin</span> option to <span class="command">configure</span> to prevent building the XMMS plugin (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=930494&amp;group_id=13478&amp;atid=363478">SF #930494</a>).</li>
<li>Added a <span class="argument">--disable-doxygen-docs</span> option to <span class="command">configure</span> for disabling Doxygen-based API doc generation (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1365935&amp;group_id=13478&amp;atid=313478">SF #1365935</a>).</li>
<li>Added a <span class="argument">--disable-thorough-tests</span> option to <span class="command">configure</span> to do the basic library, stream, and tool tests in a reasonable time (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1077948&amp;group_id=13478&amp;atid=363478">SF #1077948</a>).</li>
<li>Added support for building on OS/2 with EMX (<a href="http://sourceforge.net/p/flac/bugs/174/">SF #1229495</a>)</li>
<li>Added support for building with Borland C++ (<a href="http://sourceforge.net/p/flac/patches/17/">SF #1599018</a>)</li>
<li>Added a <span class="argument">--disable-xmms-plugin</span> option to <span class="command">configure</span> to prevent building the XMMS plugin (<a href="http://sourceforge.net/p/flac/feature-requests/33/">SF #930494</a>).</li>
<li>Added a <span class="argument">--disable-doxygen-docs</span> option to <span class="command">configure</span> for disabling Doxygen-based API doc generation (<a href="http://sourceforge.net/p/flac/patches/12/">SF #1365935</a>).</li>
<li>Added a <span class="argument">--disable-thorough-tests</span> option to <span class="command">configure</span> to do the basic library, stream, and tool tests in a reasonable time (<a href="http://sourceforge.net/p/flac/feature-requests/40/">SF #1077948</a>).</li>
<li>Added large file support with <span class="argument">AC_SYS_LARGEFILE</span>; use <span class="argument">--disable-largefile</span> with <span class="command">configure</span> to disable.</li>
</ul>
</li>
@ -535,10 +536,10 @@
<li>Merged libOggFLAC++ into libFLAC++; both formats are now supporte through the same API.</li>
<li>libFLAC and libFLAC++: Simplified encoder setup with new <span class="argument">FLAC__stream_encoder_set_compression_level()</span> function.</li>
<li>libFLAC: Improved compression with no impact on FLAC format or decoding time by adding a windowing stage before LPC analysis.</li>
<li>libFLAC: Fixed a bug where missing STREAMINFO fields (min/max framesize, total samples, MD5 sum) and seek point offsets were not getting rewritten back to Ogg FLAC file (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1338969&amp;group_id=13478&amp;atid=113478">SF #1338969</a>).</li>
<li>libFLAC: Fixed a bug where missing STREAMINFO fields (min/max framesize, total samples, MD5 sum) and seek point offsets were not getting rewritten back to Ogg FLAC file (<a href="http://sourceforge.net/p/flac/bugs/197/">SF #1338969</a>).</li>
<li>libFLAC: Fixed a bug in cuesheet parsing where it would return an error if the last line of the cuesheet did not end with a newline.</li>
<li>libFLAC: Fixed UTF-8 decoder to disallow non-shortest-form and surrogate sequences (see <a href="http://www.unicode.org/versions/corrigendum1.html">here</a>).</li>
<li>libFLAC: Fixed a bug in the return value for <span class="argument">FLAC__stream_decoder_set_metadata_respond_application()</span> and <span class="argument">FLAC__stream_decoder_set_metadata_ignore_application()</span> when there was a memory allocation error (<a href="https://sourceforge.net/tracker2/?func=detail&amp;aid=1235005&amp;group_id=13478&amp;atid=113478">SF #1235005</a>).</li>
<li>libFLAC: Fixed a bug in the return value for <span class="argument">FLAC__stream_decoder_set_metadata_respond_application()</span> and <span class="argument">FLAC__stream_decoder_set_metadata_ignore_application()</span> when there was a memory allocation error (<a href="http://sourceforge.net/p/flac/bugs/176/">SF #1235005</a>).</li>
</ul>
</li>
<li>
@ -642,7 +643,7 @@
<li>
plugins:
<ul>
<li>Added support for HTTP streaming in XMMS plugin. <b>NOTE</b>: there is a <a href="http://bugs.xmms.org/show_bug.cgi?id=2038">bug</a> in the XMMS mpg123 plugin that hijacks FLAC streams; to fix it you will need to add the '.flac' extension to the list of exceptions in <span class="code">Input/mpg123/mpg123.c:is_our_file()</span> in the XMMS sources and recompile.</li>
<li>Added support for HTTP streaming in XMMS plugin. <b>NOTE</b>: there is a bug in the XMMS mpg123 plugin that hijacks FLAC streams; to fix it you will need to add the '.flac' extension to the list of exceptions in <span class="code">Input/mpg123/mpg123.c:is_our_file()</span> in the XMMS sources and recompile.</li>
</ul>
</li>
<li>
@ -747,7 +748,7 @@
<li>New option <span class="argument"><a href="documentation_tools_flac.html#flac_options_force">-f</a></span> (<span class="argument"><a href="documentation_tools_flac.html#flac_options_force">--force</a></span>) to force overwriting if the output file already exists.</li>
<li>New option <span class="argument"><a href="documentation_tools_flac.html#flac_options_cue">--cue</a></span> to select a specific section to decode using cuesheet track/index points.</li>
<li>New option <span class="argument"><a href="documentation_tools_flac.html#flac_options_totally_silent">--totally-silent</a></span> to suppress all output.</li>
<li>New (but undocumented) option <span class="argument">--apply-replaygain-which-is-not-lossless</span> which applies ReplayGain to the decoded output. See <a href="http://www.hydrogenaudio.org/forums/index.php?showtopic=17293&amp;st=11">this thread</a> for usage and caveats.</li>
<li>New (but undocumented) option <span class="argument">--apply-replaygain-which-is-not-lossless</span> which applies ReplayGain to the decoded output. See <a href="http://www.hydrogenaud.io/forums/index.php?showtopic=17293&amp;st=11">this thread</a> for usage and caveats.</li>
<li>When encoding to Ogg FLAC, use a random serial number (instead of 0 as was done before) when a serial number is not specified.</li>
<li>When encoding multiple Ogg FLAC streams, <span class="argument">--serial-number</span> or random serial number sets the first number, which is then incremented for subsequent streams (before, the same serial number was used for all streams).</li>
<li>Decoder no longer exits with an error when writing to stdout and the pipe is broken.</li>
@ -757,12 +758,12 @@
<li>Bug fix: calculating ReplayGain on 48kHz streams.</li>
<li>Bug fix: check for supported block alignments in WAVE files.</li>
<li>Bug fix: "offset" field in AIFF SSND chunk properly handled.</li>
<li>Bug fix: <a href="http://sourceforge.net/tracker2/?func=detail&amp;aid=679166&amp;group_id=13478&amp;atid=113478">#679166</a>: flac doesn't respect RIFF subchunk padding byte.</li>
<li>Bug fix: <a href="http://sourceforge.net/tracker2/?func=detail&amp;aid=828391&amp;group_id=13478&amp;atid=113478">#828391</a>: --add-replay-gain segfaults.</li>
<li>Bug fix: <a href="http://sourceforge.net/tracker2/?func=detail&amp;aid=851155&amp;group_id=13478&amp;atid=113478">#851155</a>: Can't seek to position in flac file.</li>
<li>Bug fix: <a href="http://sourceforge.net/tracker2/?func=detail&amp;aid=851756&amp;group_id=13478&amp;atid=113478">#851756</a>: flac --skip --until reads entire file.</li>
<li>Bug fix: <a href="http://sourceforge.net/tracker2/?func=detail&amp;aid=877122&amp;group_id=13478&amp;atid=113478">#877122</a>: problem parsing cuesheet with CATALOG entry.</li>
<li>Bug fix: <a href="http://sourceforge.net/tracker2/?func=detail&amp;aid=896057&amp;group_id=13478&amp;atid=113478">#896057</a>: parsing ISRC number from cuesheet.</li>
<li>Bug fix: <a href="http://sourceforge.net/p/flac/bugs/77/">#679166</a>: flac doesn't respect RIFF subchunk padding byte.</li>
<li>Bug fix: <a href="http://sourceforge.net/p/flac/bugs/90/">#828391</a>: --add-replay-gain segfaults.</li>
<li>Bug fix: <a href="http://sourceforge.net/p/flac/bugs/96/">#851155</a>: Can't seek to position in flac file.</li>
<li>Bug fix: <a href="http://sourceforge.net/p/flac/bugs/97/">#851756</a>: flac --skip --until reads entire file.</li>
<li>Bug fix: <a href="http://sourceforge.net/p/flac/bugs/100/">#877122</a>: problem parsing cuesheet with CATALOG entry.</li>
<li>Bug fix: <a href="http://sourceforge.net/p/flac/bugs/104/">#896057</a>: parsing ISRC number from cuesheet.</li>
</ul>
</li>
<li>
@ -793,7 +794,7 @@
<li>Support for big-endian architectures in XMMS plugin.</li>
<li>Removed support for ID3 tags.</li>
<li>Bug fix: make hard limiter default to off in XMMS plugin.</li>
<li>Bug fix: stream length calculation bug in XMMS plugin, debian bug #200435; <a href="http://sourceforge.net/mailarchive/forum.php?thread_id=2733072&amp;forum_id=6312">see also</a>.</li>
<li>Bug fix: stream length calculation bug in XMMS plugin, debian bug #200435</li>
<li>Bug fix: small memory leak in XMMS plugin.</li>
</ul>
</li>
@ -907,6 +908,360 @@
</ul>
</li>
</ul>
<br />
<a name="flac_1_1_0"><b>FLAC 1.1.0</b> (26-Jan-2003)</a>
<br />
<ul>
<li>
General:
<ul>
<li>All code is now <a href="http://valgrind.org/">Valgrind</a>-clean!</li>
<li>New <a href="format.html#def_CUESHEET">CUESHEET</a> metadata block for storing CD TOC and index point information. Now a CD can be completely backed up to a single FLAC file for archival.</li>
<li><a href="http://www.replaygain.org/">ReplayGain</a> support.</li>
<li>Better compression of 24-bit files.</li>
<li>More complete AIFF support.</li>
<li>3DNow! optimizations enabled by default.</li>
<li>Complete MSVC build system with .dsp projects for everything, which can build both static libs and DLLs, and in debug or release mode, all in the same source tree.</li>
</ul>
<span class="commandname">flac</span>:
<ul>
<li>Can now decode FLAC to AIFF; new <span class="argument">--force-aiff-format</span> option.</li>
<li>New <span class="argument">--cuesheet</span> option for reading and storing a cuesheet when encoding a whole CD. Automatically creates seek points for track and index points unless <span class="argument">--no-cued-seekpoints</span> is used.</li>
<li>New <span class="argument">--replay-gain</span> option for calculating ReplayGain values and storing them as tags.</li>
<li>New <span class="argument">--until</span> option complements <span class="argument">--skip</span> to stop decoding at a specified point in the stream.</li>
<li><span class="argument">--skip</span> and <span class="argument">--until</span> now also accept mm:ss.ss format.</li>
<li>New <span class="argument">-S #s</span> flavor to specify seekpoints every '#' number of seconds.</li>
<li><span class="commandname">flac</span> now defaults to <span class="argument">-S 10s</span> instead of <span class="argument">-S 100x</span> for the seek table.</li>
<li><span class="commandname">flac</span> now adds a 4k PADDING block by default (turn off with <span class="argument">--no-padding</span>).</li>
<li>Fixed a bug with --skip and AIFF-to-FLAC encoding.</li>
<li>Fixed a bug where decoding a FLAC file whose total_samples==0 in the STREAMINFO would corrupt the WAVE header.</li>
</ul>
<span class="commandname">metaflac</span>:
<ul>
<li>New <span class="argument">--import-cuesheet-from</span> option for reading and storing a cuesheet to a FLAC-encoded CD. Automatically creates seek points for track and index points unless <span class="argument">--no-cued-seekpoints</span> is used.</li>
<li>New <span class="argument">--export-cuesheet-to</span> option for writing a cuesheet from a FLAC file for use with CD authoring software.</li>
<li>New <span class="argument">--add-replay-gain</span> option for calculating ReplayGain values and storing them as tags.</li>
<li>New <span class="argument">--add-seekpoint</span> option to add seekpoints to an existing FLAC file. Includes new <span class="argument">--add-seekpoint=#s</span> flavor to add seekpoints every '#' number of seconds.</li>
</ul>
XMMS plugin:
<ul>
<li>Configurable sample resolution conversion with dither.</li>
<li>ReplayGain support with customizable noise shaping, pre-amp, and optional hard limiter.</li>
<li>New Vorbis comment editor.</li>
<li>File info now works.</li>
<li>Bitrate now shows the smoothed instantaneous bitrate.</li>
<li>Uses the ARTIST tag if there is no PERFORMER tag.</li>
</ul>
Winamp2 plugin:
<ul>
<li>Configurable sample resolution conversion with dither.</li>
<li>ReplayGain support with customizable noise shaping, pre-amp, and optional hard limiter.</li>
<li>File info now works.</li>
<li>Uses the ARTIST tag if there is no PERFORMER tag.</li>
</ul>
Libraries (developers take note!):
<ul>
<li>All code and tests are instrumented for Valgrind. All tests run Valgrind-clean, meaning no memory leaks or buffer over/under-runs.</li>
<li>Separate 64-bit datapath through the filter in <span class="commandname">libFLAC</span> for better compression of &gt;16 bps files.</li>
<li><span class="code">FLAC__metadata_object_new(FLAC__METADATA_TYPE_VORBIS_COMMENT)</span> now sets the vendor string.</li>
<li>The documentation on the usage of <span class="code">FLAC::Iterator::get_block()</span> in <span class="commandname">libFLAC++</span> has an important correction. If you use this class make sure to read <a href="api/group__flacpp__metadata__level2.html">this</a>.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_1_0_4"><b>FLAC 1.0.4</b> (24-Sep-2002)</a>
<br />
<ul>
<li>
Plugins:
<ul>
<li>Support for Vorbis comments, ID3 v1 and v2 tags.</li>
<li>Configurable title formatting and charset conversion in XMMS plugin.</li>
<li>Support for 8- and 24-bit FLAC files. There is a compile-time option for raw 24-bit output or 24bps-to-16bps linear dithering (the default).</li>
</ul>
<span class="commandname">flac</span>:
<ul>
<li>Improved option parser (now uses getopt).</li>
<li>AIFF input support (thanks to Brady Patterson).</li>
<li>Small decoder speedup.</li>
<li><span class="argument">--sector-align</span> now supported for raw input files.</li>
<li>New -T, --tag options for adding Vorbis comments while encoding.</li>
<li>New --serial-number option for use with --ogg.</li>
<li>Automatically writes vendor string in Vorbis comments.</li>
<li>Drastically reduced memory requirements.</li>
<li>Fixed bug where extra fmt/data chunks that were supposed to be skipped were not getting skipped.</li>
<li>Fixed bug in granulepos setting for Ogg FLAC streams.</li>
<li>Fixed memory leak when encoding multiple files with -V.</li>
</ul>
<span class="commandname">metaflac</span>:
<ul>
<li>UTF-8 support in Vorbis comments.</li>
<li>New --import-vc-from and --export-vc-to commands for importing/exporting Vorbis comments from/to a file. For example, the following can be used to copy tags back and forth:<br />
<span class="code">
metaflac --export-vc-to=- --no-utf8-convert file.flac | vorbiscomment --raw -w file.ogg<br />
vorbiscomment --raw -l file.ogg | metaflac --import-vc-from=- --no-utf8-convert file.flac<br />
</span>
</li>
<li>Fixed <a href="http://sourceforge.net/p/flac/bugs/54/">bug #606796</a> where <span class="commandname">metaflac</span> was failing on read-only files.</li>
</ul>
Libraries:
<ul>
<li>All APIs now meticulously documented via Doxygen. <a href="api/index.html">See here</a>.</li>
<li>New <span class="commandname">libOggFLAC</span> and <span class="commandname">libOggFLAC++</span> libraries. These wrap around <span class="commandname">libFLAC</span> to provide encoding and decoding of Ogg FLAC streams, providing interfaces similar to the ones of the native FLAC libraries. These are also documented via Doxygen.</li>
<li>New FLAC__SeekableStreamEncoder and FLAC__FileEncoder in <span class="commandname">libFLAC</span> simplify common encoding tasks.</li>
<li>New verify mode in all encoders.</li>
<li>FLAC__stream_encoder_finish() now resets the defaults just like the stream decoders.</li>
<li>Drastically reduced memory requirements of encoders and decoders.</li>
<li>Encoder now automatically writes vendor string in VORBIS_COMMENT block.</li>
<li>Encoding speedup of fixed predictors and MD5 speedup for 16bps mono/stereo signals on x86 (thanks to Miroslav Lichvar).</li>
<li>Fixed bug in metadata interface where a bps in STREAMINFO > 16 was incorrectly parsed.</li>
<li>Fixed bug where aborting stream decoder could cause infinite loop.</li>
<li>Behavior change: simplified decoder *_process() commands.</li>
<li>Behavior change: calling FLAC__stream_encoder_init() calls write callback once for "fLaC" signature and once for each metadata block.</li>
<li>Behavior change: deprecated do_escape_coding and rice_parameter_search_distance in encoder.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_1_0_3"><b>FLAC 1.0.3</b> (03-Jul-2002)</a>
<br />
<ul>
<li>
New features:
<ul>
<li>24-bit input support restored in <span class="commandname">flac</span>.</li>
<li>Decoder speedup in <span class="commandname">libFLAC</span>, which is directly passed on to the command-line decoder and plugins.</li>
<li>New <span class="argument">-F</span> option to <span class="commandname">flac</span> to continue decoding in spite of errors.</li>
<li>Correctly set granulepos in Ogg packets so seeking Ogg FLAC streams will be easier.</li>
<li>New <a href="format.html#metadata_block_vorbis_comment">VORBIS_COMMENT</a> metadata block for tagging with Vorbis-style comments.</li>
<li>Vastly improved <span class="commandname">metaflac</span>, now with many editing and tagging options.</li>
<li>Partial id3v1 support in Winamp plugins.</li>
<li>Updated Winamp 3 plugin.</li>
<li>Note: new semantics for -P option in <span class="commandname">flac</span>.</li>
<li>Note: removed -R option in <span class="commandname">flac</span>.</li>
</ul>
New library features:
<ul>
<li>Previously mentioned decoder speedup in <span class="commandname">libFLAC</span>.</li>
<li>New metadata interface to <span class="commandname">libFLAC</span> for manipulating metadata in FLAC files.</li>
<li>New <span class="commandname">libFLAC++</span> API, an object wrapper around <span class="commandname">libFLAC</span>.</li>
<li>New <a href="format.html#metadata_block_vorbis_comment">VORBIS_COMMENT</a> metadata block for tagging with Vorbis-style comments.</li>
<li>Customizable metadata filtering by type in decoders.</li>
<li>Stream encoder can take an arbitrary list of metadata blocks, instead of just one SEEKTABLE and/or PADDING block.</li>
</ul>
Bugs fixed:
<ul>
<li>Fixed bug with using pipes under Windows.</li>
<li>Fixed several bugs in the plugins and made them more robust in general.</li>
<li>Fixed bug in <span class="commandname">flac</span> where decoding to WAVE of a FLAC file with 0 for total_samples in the STREAMINFO block yielded a WAVE chunk of 0 size.</li>
<li>Fixed bug in Ogg packet numbering.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_1_0_2"><b>FLAC 1.0.2</b> (03-Dec-2001)</a>
<br />
<ul>
<li>
This release is only to fix a bug that was causing some of the plugins to crash sporadically. It can also affect <span class="commandname">libFLAC</span> users that reuse one file decoder instance for multiple files
</li>
</ul>
<br />
<a name="flac_1_0_1"><b>FLAC 1.0.1</b> (14-Nov-2001)</a>
<br />
<ul>
<li>
New features for users:
<ul>
<li>Support for Ogg-FLAC, i.e. <span class="commandname">flac</span> can now read and write FLAC streams using Ogg as the transport layer.</li>
<li>New Winamp 3 plugin based on the Wasabi Beta 1 SDK.</li>
<li>New utilities for adding FLAC support to the Monkey's Audio GUI (see <a href="documentation_tasks.html#monkey">how</a>).</li>
<li>Mac OS X support. The download area now contains an OS X binary release.</li>
<li>Mingw32 support.</li>
<li>Better handling of MS-specific 'fmt' chunks in WAVE files.</li>
</ul>
New features for developers:
<ul>
<li>Added a SeekableStreamDecoder layer between StreamDecoder and FileDecoder. This makes it easier to use libFLAC in situations where files have been abstracted away. See the latest <a href="api/index.html">documentation</a> for more. The interface for the StreamDecoder and FileDecoder remain the same and are still binary-compatible with libFLAC 1.0.</li>
<li>Drastically reduced the stack requirements of the encoder.</li>
</ul>
Bug fixes:
<ul>
<li>Fixed a serious bug with <span class="commandname">flac</span> and raw input where the encoder was trying to rewind when it shouldn't, which would add 12 junk samples to the encoded file. This was not present in WAVE encoding.</li>
<li>Fixed a minor bug in <span class="commandname">libFLAC</span> with setting the file name to stdin on a file decoder.</li>
<li>Fixed a minor bug in <span class="commandname">libFLAC</span> where multiple calls to setting the file name on a file decoder caused leaked memory.</li>
<li>Fixed a minor bug in <span class="commandname">metaflac</span>, now correctly skips an id3v2 tag if present.</li>
<li>Fixed a minor bug in <span class="commandname">metaflac</span>, now correctly skips long metadata blocks.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_1_0"><b>FLAC 1.0</b> (20-Jul-2001)</a>
<br />
<ul>
<li>
It's finally here. There are a few new features but mostly it is minor bug fixes since 0.10:
<ul>
<li>New '--sector-align' option to <span class="commandname">flac</span> which aligns a group of encoded files on CD audio sector boundaries.</li>
<li>New '--output-prefix' option to <span class="commandname">flac</span> to allow the user to prepend a prefix to all output filenames (useful, for example, for encoding/decoding to a different directory).</li>
<li>Better WAVE autodetection (doesn't rely on ungetc() anymore).</li>
<li>Cleaner one-line encoding/decoding stats.</li>
<li>Changes to the libFLAC interface and type names to make binary compatibility easier to maintain in the future.</li>
<li>New '--sse-os' option to 'configure' to enable faster SSE-based routines.</li>
<li>Another (hopefully last) fix to the Winamp 2 plugin.</li>
<li>Slightly improved Rice parameter estimation.</li>
<li>Bug fixes for some very rare corner cases when encoding.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_0_10"><b>FLAC 0.10</b> (07-Jun-2001)</a>
<br />
<ul>
<li>
This is probably the final beta. There have been many improvements in the last two months:
<ul>
<li>Both the encoder and decoder have been significantly sped up. Aside from C improvements, the code base now has an assembly infrastructure that allows assembly routines for different architectures to be easily integrated. Many key routines have now have faster IA-32 implementations (thanks to Miroslav).</li>
<li>A new metadata block <a href="format.html#def_SEEKTABLE">SEEKTABLE</a> has been defined to hold an arbitrary number of seek points, which speeds up seeking within a stream.</li>
<li><span class="commandname">flac</span> now has a command-line usage similar to 'gzip'; make sure to see the latest <a href="documentation.html">documentation</a> for the new usage. It also attempts to preserve the input file's timestamp and permissions.</li>
<li>The -# options in <span class="commandname">flac</span> have been tweaked to yield the best compression-to-encode-time ratios. The new default is -5.</li>
<li><span class="commandname">flac</span> can now usually autodetect WAVE files when encoding so that -fw is usually not needed when encoding from stdin.</li>
<li>The WAVE reader in <span class="commandname">flac</span> now just ignores (with a warning) unsupported sub-chunks instead of aborting with an error.</li>
<li>Added an option '--delete-input-file' to <span class="commandname">flac</span> which automatically deletes the input after a successful encode/decode.</li>
<li>Added an option '-o' to <span class="commandname">flac</span> to force the output file name (the old usage of "flac - outputfilename" is no longer supported).</li>
<li>Changed the XMMS plugin to send smaller chunks of samples (now 512) so that visualization is not slow.</li>
<li>Fixed a bug in the stream decoder where the decoded samples counter got corrupted after a seek.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_0_9"><b>FLAC 0.9</b> (31-Mar-2001)</a>
<br />
<ul>
<li>
Bug fixes and some new features:
<ul>
<li>FLAC's sync code has been lengthened to 14 bits from 9 bits. This should enable a faster and more robust synchronization mechanism.</li>
<li>Two reserved bits were added to the frame header.</li>
<li>A CRC-16 was added to the FLAC frame footer, and the decoder now does frame integrity checking based on the CRC.</li>
<li>The format now includes a new subframe field to indicate when a subblock has one or more 0 LSBs for all samples. This increases compression on some kinds of data.</li>
<li>Added two options to the analysis mode, one for including the residual signal in the analysis file, and one for generating gnuplot files of each subframe's residual distribution with some statistics. See the latest <a href="documentation.html#analysis_options">documentation</a>.</li>
<li>XMMS plugin now supports 8-bit files.</li>
<li>Fixed a bug in the Winamp2 plugin where the audio sounded garbled.</li>
<li>Fixed a bug in the Winamp2 plugin where Winamp would hang sporadically at the end of a track (c.f. <a href="http://sourceforge.net/projects/flac/&amp;atid=113478">bug #231197</a>).</li>
</ul>
</li>
</ul>
<br />
<a name="flac_0_8"><b>FLAC 0.8</b> (05-Mar-2001)</a>
<br />
<ul>
<li>
Changes since 0.7:
<ul>
<li>Created a new utility called <span class="commandname">metaflac</span>. It is a metadata editor for .flac files. Right now it just lists the contents of the metadata blocks but eventually it will allow update/insertion/deletion.</li>
<li>Added two new metadata blocks: PADDING which has an obvious function, and APPLICATION, which is meant to be open to third party applications. See the <a href="format.html#def_APPLICATION">latest format docs</a> for more info, or the new <a href="id.html">id registration page</a>.</li>
<li>Added a <span class="argument">-P</span> option to <span class="commandname">flac</span> to reserve a PADDING block when encoding.</li>
<li>Added support for 24-bit files to <span class="commandname">flac</span> (the FLAC format always supported it).</li>
<li>Started the Winamp3 plugin.</li>
<li>Greatly expanded the test suite, adding more streams (24-bit streams, noise streams, non-audio streams, more patterns) and more option combinations to the encoder. The test suite runs about 30 streams and over 5000 encodings now.</li>
<li>Fixed a bug in <span class="commandname">libFLAC</span> that happened when using an exhaustive LPC coefficient quantization search with 8 bps input.</li>
<li>Fixed a bug in <span class="commandname">libFLAC</span> where the error estimation in the fixed predictor could overflow.</li>
<li>Fixed a bug in <span class="commandname">libFLAC</span> where LPC was attempted even when the autocorrelation coefficients implied it wouldn't help.</li>
<li>Reworked the LPC coefficient quantizer, which also fixed another bug that might occur in rare cases.</li>
<li>Really fixed the '-V overflow' bug (c.f. <a href="http://sourceforge.net/p/flac/bugs/5/">bug #231976</a>).</li>
<li>Fixed a bug in <span class="commandname">flac</span> related to the decode buffer sizing.</li>
</ul>
FLAC is very close to being ready for an official release. The only known problems left are with the Winamp plugins, which should be fixed soon, and pipes with MSVC.
</li>
</ul>
<br />
<a name="flac_0_7"><b>FLAC 0.7</b> (12-Feb-2001)</a>
<br />
<ul>
<li>
Changes:
<ul>
<li>Fixed a bug that happened when both -fr and --seek were used at the same time.</li>
<li>Fixed a bug with -p (c.f. <a href="http://sourceforge.net/p/flac/bugs/1/">bug #230992</a>).</li>
<li>Fixed a bug that happened when using large (&gt;32K) blocksizes and -V (c.f. <a href="http://sourceforge.net/p/flac/bugs/5/">bug #231976</a>).</li>
<li>Fixed a bug where encoder was double-closing a file.</li>
<li>Expanded the test suite.</li>
<li>Added more optimization flags for gcc, which should speed up flac.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_0_6"><b>FLAC 0.6</b> (28-Jan-2001)</a>
<br />
<ul>
<li>
The encoder is now much faster. The -m option has been sped up by 4x and -r improved, meaning that in the default compression mode (-6), encoding should be at least 3 times faster. Other changes:
<ul>
<li>Some bugs related to <span class="commandname">flac</span> and pipes were fixed</li>
<li>A "loose mid-side" (<span class="argument">-M</span>) option to the encoder has been added, which adaptively switches between independent and mid-side coding, instead of the exhaustive search that <span class="argument">-m</span> does.</li>
<li>An analyze mode (<span class="argument">-a</span>) has been added to <span class="commandname">flac</span>. This is useful mainly for developers; currently it will dump info about each frame and subframe to a file. It's a text file in a format that can be easily processed by scripts; a separate analysis program is in the works.</li>
<li>The source now has an autoconf/libtool-based build system. This should allow the source to build "out-of-the-box" on many more platforms.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_0_5"><b>FLAC 0.5</b> (15-Jan-2001)</a>
<br />
<ul>
<li>
This is the first beta version of FLAC. Being beta, there will be no changes to the format that will break older streams, unless a serious bug involving the format is found. What this means is that, barring such a bug, streams created with 0.5 will be decodable by future versions. This version also includes some new features:
<ul>
<li>An <a href="http://userpages.umbc.edu/~mabzug1/cs/md5/md5.html">MD5 signature</a> of the unencoded audio is computed during encoding, and stored in the Encoding metadata block in the stream header. When decoding, <span class="commandname">flac</span> will now compute the MD5 signature of the decoded data and compare it against the signature in the stream header.</li>
<li>A test mode (<span class="argument">-t</span>) has been added to <span class="commandname">flac</span>. It works like decode mode but doesn't write an output file.</li>
</ul>
</li>
</ul>
<br />
<a name="flac_0_4"><b>FLAC 0.4</b> (23-Dec-2000)</a>
<br />
<ul>
<li>This version fixes a bug in the constant subframe detection. More importantly, a verify option (-V) has been added to <span class="commandname">flac</span> that verifies the encoding process. With this option turned on, <span class="commandname">flac</span> will create a parallel decoder while encoding to make sure that the encoded output decodes to exactly match the original input. In this way, any unknown bug in the encoder will be caught and <span class="commandname">flac</span> will abort with an error message.</li>
</ul>
</div>
<div class="box_footer"></div>
</div>

2
doc/html/documentation.html
View File

@ -55,7 +55,7 @@
<li><a href="documentation_tools.html">Official Tools</a> - How to use the <span class="commandname">flac</span> and <span class="commandname">metaflac</span> command-line tools.</li>
<li><a href="http://xiph.org/flac/comparison.html">Comparison</a> - A comparison of FLAC with other lossless codecs.</li>
<li><a href="documentation_bugs.html">Bugs</a> - How to report bugs and request features, and a list of known bugs in the FLAC tools.</li>
<li><a href="http://sourceforge.net/tracker/?group_id=13478&amp;atid=213478">Request Support</a> - Support for the official FLAC tools. For other programs, use <a href="http://www.hydrogenaudio.org/">hydrogenaudio.org</a></li>
<li><a href="http://sourceforge.net/p/flac/support-requests/">Request Support</a> - Support for the official FLAC tools. For other programs, use <a href="http://www.hydrogenaud.io/">hydrogenaud.io</a></li>
<li><a href="http://lists.xiph.org/mailman/listinfo/flac">FLAC Mailing List</a> - General discussion about FLAC, tools, releases, etc. (You must subscribe to post.)</li>
</ul>
For developers who want to add FLAC support to their programs:

17
doc/html/documentation_bugs.html
View File

@ -42,12 +42,19 @@
</div>
<div class="box_header"></div>
<div class="box_body">
The following are major known bugs in the current (1.1.4) release:
The following are major known bugs in the current (1.3.0) release:
<ul>
<li>
When encoding to Ogg FLAC, if there are too many seek points (&gt;240), the seek table will not have the offsets written back properly after encoding.
If you use the --replay-gain option with flac, but no --padding/-P option, only a very small padding block will be created. The workaround is to always use a -P option when using --replay-gain to make sure the correct amount of padding is added.
</li>
<li>
When encoding to Ogg FLAC, the progress indicator is broken
</li>
<li>
When encoding to Ogg FLAC, the number of seek points is limited to 240.
</li>
</ul>
The first two have been fixed, these fixes will be incorporated in the next release.
</div>
<div class="box_footer"></div>
</div>
@ -60,11 +67,9 @@
</div>
<div class="box_header"></div>
<div class="box_body">
To report a bug, please go to the <a href="http://sourceforge.net/tracker/?group_id=13478&amp;atid=113478">FLAC bug tracker</a> (or appropriately the <a href="http://sourceforge.net/tracker/?group_id=13478&amp;atid=363478">feature request tracker</a>, <a href="http://sourceforge.net/tracker/?group_id=13478&amp;atid=313478">patch page</a>, or <a href="http://sourceforge.net/tracker/?group_id=13478&amp;atid=213478">support page</a>).<br />
To report a bug, please go to the <a href="http://sourceforge.net/p/flac/bugs/">FLAC bug tracker</a> (or appropriately the <a href="http://sourceforge.net/p/flac/feature-requests/">feature request tracker</a>, <a href="http://sourceforge.net/p/flac/patches/">patch page</a>, or <a href="http://sourceforge.net/p/flac/support-requests/">support page</a>).<br />
<br />
First check that there is not already an existing request. If you do submit a new request, make sure and provide an email contact <b>and</b> use the Monitor feature.<br />
<br />
Note that we get many false bug reports from people with faulty hardware or who overclock their machines that FLAC is not working. Please do due diligence if you are getting FLAC encoding or decoding errors that it is not the fault of the hardware. FLAC encoding tends to highlight problems with bad RAM, corrupted files, and excessive overclocking.
First check that there is not already an existing request. If you do submit a new request, make sure and provide an email contact <b>and</b> use the Monitor feature.
</div>
<div class="box_footer"></div>
</div>

3
doc/html/documentation_tools.html
View File

@ -46,12 +46,11 @@
<ul>
<li><a href="documentation_tools_flac.html">flac</a> - The command-line encoder and decoder.</li>
<li><a href="documentation_tools_metaflac.html">metaflac</a> - The command-line metadata editor.</li>
<li><a href="documentation_tools_plugins.html">plugins</a> - Setting up the Winamp and XMMS plugins.</li>
</ul>
Other resources:
<ul>
<li><a href="documentation_bugs.html">Bugs</a> - How to report bugs and request features, and a list of known bugs in the FLAC tools.</li>
<li><a href="http://sourceforge.net/tracker/?group_id=13478&amp;atid=213478">Request Support</a> - Support for the official FLAC tools. For other programs, use <a href="http://www.hydrogenaudio.org/">hydrogenaudio.org</a></li>
<li><a href="http://sourceforge.net/p/flac/support-requests/">Request Support</a> - Support for the official FLAC tools. For other programs, use <a href="http://www.hydrogenaud.io/">hydrogenaud.io</a></li>
<li><a href="http://lists.xiph.org/mailman/listinfo/flac">FLAC Mailing List</a> - General discussion about FLAC, tools, releases, etc. (You must subscribe to post.)</li>
</ul>
<br />

16
doc/html/documentation_tools_flac.html
View File

@ -355,29 +355,35 @@
<tr>
<td nowrap="nowrap" align="right" valign="top" bgcolor="#F4F4CC">
<a name="flac_options_skip" />
<span class="argument">--skip={#|mm:ss.ss}</span>
<span class="argument">--skip={#|mm:ss.ss}<br />--skip={#|mm:ss,ss}</span>
</td>
<td>
Skip over the first # of samples of the input. This works for both encoding and decoding, but not testing. The alternative form <span class="argument">mm:ss.ss</span> can be used to specify minutes, seconds, and fractions of a second.<br />
<br />
Note that the use of either a dot or a comma depends on the locale used for the system.<br />
<br />
Examples:<br />
<br />
<span class="argument">--skip=123</span> : skip the first 123 samples of the input<br />
<span class="argument">--skip=1:23.45</span> : skip the first 1 minute and 23.45 seconds of the input
<span class="argument">--skip=1:23.45</span> : skip the first 1 minute and 23.45 seconds of the input, with a locale using the point as decimal separator<br />
<span class="argument">--skip=1:23,45</span> : skip the first 1 minute and 23.45 seconds of the input, with a locale using the comma as decimal separator
</td>
</tr>
<tr>
<td nowrap="nowrap" align="right" valign="top" bgcolor="#F4F4CC">
<a name="flac_options_until" />
<span class="argument">--until={#|[+|-]mm:ss.ss}</span>
<span class="argument">--until={#|[+|-]mm:ss.ss}<br />--until={#|[+|-]mm:ss,ss}</span>
</td>
<td>
Stop at the given sample number for each input file. This works for both encoding and decoding, but not testing. The given sample number is not included in the decoded output. The alternative form <span class="argument">mm:ss.ss</span> can be used to specify minutes, seconds, and fractions of a second. If a <span class="argument">+</span> sign is at the beginning, the <span class="argument">--until</span> point is relative to the <span class="argument">--skip</span> point. If a <span class="argument">-</span> sign is at the beginning, the <span class="argument">--until</span> point is relative to end of the audio.<br />
<br />
Note that the use of either a dot or a comma depends on the locale used for the system.<br />
<br />
Examples:<br />
<br />
<span class="argument">--until=123</span> : decode only the first 123 samples of the input (samples 0-122, stopping at 123)<br />
<span class="argument">--until=1:23.45</span> : decode only the first 1 minute and 23.45 seconds of the input<br />
<span class="argument">--until=1:23,45</span> : decode only the first 1 minute and 23.45 seconds of the input, if your locale setting uses a comma as decimal separator<br />
<span class="argument">--skip=1:00 --until=+1:23.45</span> : decode 1:00.00 to 2:23.45<br />
<span class="argument">--until=-1:23.45</span> : decode everything except the last 1 minute and 23.45 seconds<br />
<span class="argument">--until=-0:00</span> : decode until the end of the input (the same as not specifying <span class="argument">--until</span>)
@ -550,7 +556,7 @@
<span class="argument">--replay-gain</span>
</td>
<td>
Calculate <a href="http://www.replaygain.org/">ReplayGain</a> values and store them as FLAC tags, similar to <a href="http://packages.qa.debian.org/v/vorbisgain.html">VorbisGain</a>. Title gains/peaks will be computed for each input file, and an album gain/peak will be computed for all files. All input files must have the same resolution, sample rate, and number of channels. Only mono and stereo files are allowed, and the sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz. Also note that this option may leave a few extra bytes in a <span class="code">PADDING</span> block as the exact size of the tags is not known until all files are processed.<br />
Calculate <a href="http://wiki.hydrogenaud.io/index.php?title=ReplayGain_specification">ReplayGain</a> values and store them as FLAC tags, similar to <a href="http://packages.qa.debian.org/v/vorbisgain.html">VorbisGain</a>. Title gains/peaks will be computed for each input file, and an album gain/peak will be computed for all files. All input files must have the same resolution, sample rate, and number of channels. Only mono and stereo files are allowed, and the sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz. Also note that this option may leave a few extra bytes in a <span class="code">PADDING</span> block as the exact size of the tags is not known until all files are processed.<br />
<br />
Note that this option cannot be used when encoding to standard output (stdout).
</td>
@ -849,6 +855,7 @@
Window audio data with given the apodization function. The functions are: bartlett, bartlett_hann, blackman, blackman_harris_4term_92db, connes, flattop, gauss(STDDEV), hamming, hann, kaiser_bessel, nuttall, rectangle, triangle, tukey(P), welch.<br />
For gauss(STDDEV), STDDEV is the standard deviation (0&lt;STDDEV&lt;=0.5).<br />
For tukey(P), P specifies the fraction of the window that is tapered (0&lt;=P&lt;=1; P=0 corresponds to "rectangle" and P=1 corresponds to "hann").<br />
Please note that for both P as well as STDDEV, the use of a point or comma as decimal separator is locale-dependent.<br />
More than one -A option (up to 32) may be used. Any function that is specified erroneously is silently dropped. The encoder chooses suitable defaults in the absence of any -A options; any -A option specified replaces the default(s).<br />
When more than one function is specified, then for every subframe the encoder will try each of them separately and choose the window that results in the smallest compressed subframe. Multiple functions can greatly increase the encoding time.<br />
</td>
@ -1018,6 +1025,7 @@
<span class="argument">--no-mid-side</span><br />
<span class="argument">--no-ogg</span><br />
<span class="argument">--no-padding</span><br />
<span class="argument">--no-preserve-modtime</span><br />
<span class="argument">--no-qlp-coeff-prec-search</span><br />
<span class="argument">--no-residual-gnuplot</span><br />
<span class="argument">--no-residual-text</span><br />

83
doc/html/documentation_tools_plugins.html
View File

@ -1,83 +0,0 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!-- Copyright (c) 2000-2009 Josh Coalson -->
<!-- Copyright (c) 2011-2013 Xiph.Org Foundation -->
<!-- Permission is granted to copy, distribute and/or modify this document -->
<!-- under the terms of the GNU Free Documentation License, Version 1.1 -->
<!-- or any later version published by the Free Software Foundation; -->
<!-- with no invariant sections. -->
<!-- A copy of the license can be found at http://www.gnu.org/copyleft/fdl.html -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta name="author" content="Josh Coalson" />
<meta name="description" content="A free, open source codec for lossless audio compression and decompression" />
<meta name="keywords" content="free,lossless,audio,codec,encoder,decoder,compression,compressor,archival,archive,archiving,backup,music" />
<link rel="shortcut icon" type="image/x-icon" href="favicon.ico" />
<link rel="stylesheet" type="text/css" href="flac.css" />
<title>FLAC - documentation</title>
</head>
<body>
<div class="logo">
<a href="index.html"><img src="images/logo130.gif" alt="FLAC Logo" align="middle" border="0" hspace="0" /></a>
</div>
<div class="above_nav"></div>
<div class="navbar">
&nbsp;<a href="index.html">home</a>&nbsp;&nbsp;|
&nbsp;<a href="faq.html">faq</a>&nbsp;&nbsp;|
&nbsp;<a href="documentation.html">documentation</a>&nbsp;&nbsp;|
&nbsp;<a href="developers.html">developers</a>&nbsp;&nbsp;|
&nbsp;<a href="changelog.html">changelog</a>&nbsp;&nbsp;|
&nbsp;<a href="http://xiph.org/flac">more</a>
</div>
<div class="below_nav"></div>
<div class="box">
<div class="box_title">
<a name="plugins"></a><a name="xmms_plugin">xmms plugin</a>
</div>
<div class="box_header"></div>
<div class="box_body">
Normally the FLAC plugin for XMMS is installed with a package, but some of the <a href="http://xiph.org/flac/download.html">binary builds</a> have a compiled plugin. All that is necessary is to copy <span class="code">libxmms-flac.so</span> to the directory where XMMS looks for input plugins (usually <span class="code">/usr/lib/xmms/Input</span> or <span class="code">$HOME/.xmms/Input</span>). There is nothing else to configure. Make sure to restart XMMS before trying to play any <span class="code">.flac</span> files.
</div>
<div class="box_footer"></div>
</div>
<br />
<div class="box">
<div class="box_title">
<a name="winamp_plugin">winamp plugin</a>
</div>
<div class="box_header"></div>
<div class="box_body">
Since Winamp 5.31, Nullsoft has supplied a FLAC plugin with their Full install; nothing else is needed to get FLAC to play in Wnamp.<br />
<br />
Before Winamp 5.31 it was necessary to use our FLAC plugin. If you have an older version of Winamp, our plugin is still available in the <a href="http://cyberial.com/flacinstaller.asp">FLAC Installer for Windows</a>. The Winamp plugin should work for both Winamp2 and Winamp5. All that is necessary is to copy <span class="code">in_flac.dll</span> to the <span class="code">Plugins/</span> directory of your Winamp installation. There is nothing else to configure. Make sure to restart Winamp before trying to play any <span class="code">.flac</span> files.
</div>
<div class="box_footer"></div>
</div>
<div class="copyright">
<!-- @@@ oh so hacky -->
<table>
<tr>
<td align="left">
Copyright (c) 2000-2009 Josh Coalson
<br/>
Copyright (c) 2011-2013 Xiph.Org Foundation
</td>
<td width="1%" align="right">
<a href="http://validator.w3.org/check?uri=referer"><img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" border="0" hspace="0" /></a>
</td>
</tr>
</table>
</div>
</body>
</html>

23
doc/html/faq.html
View File

@ -127,9 +127,6 @@
<li>
<a href="faq.html#tools__long_meta_edits"><b>Why does it take so long to edit some FLAC files with metaflac?</b></a>
</li>
<li>
<a href="faq.html#tools__unicode_filenames_windows"><b>Why don't Unicode file names work with <span class="commandname">flac/<span class="commandname">metaflac</span></span> on Windows?</b></a>
</li>
<li>
<a href="faq.html#tools__wildcards_on_windows"><b>Why don't wildcards for file names like *.flac or *.wav work with <span class="commandname">flac</span>/<span class="commandname">metaflac</span> on Windows?</b></a>
</li>
@ -184,7 +181,7 @@
<a name="general__how_to"><b>I have a FLAC file, how do I play it?</b></a><br />
<b>How can I create FLAC files?</b><br />
<br />
See <a href="http://xiph.org/flac/documentation_tasks.html">Using FLAC</a>.<br />
See <a href="http://xiph.org/flac/documentation_tasks.html">Using FLAC</a> or a <a href="http://xiph.org/flac/links.html">list of hardware that supports FLAC</a>.<br />
<br />
<a name="general__license"><b>What licensing applies to the FLAC format and software?</b></a><br />
<br />
@ -202,7 +199,7 @@
<br />
<a name="general__software_wmp"><b>How can I play FLAC in Windows Media Player?</b></a><br />
<br />
See <a href="http://www.losslessaudioblog.com/wmpmce-lossless-guide/">this guide</a>.<br />
The easiest way is to use the Xiph.org Directshow Filters, <a href="http://www.xiph.org/dshow/downloads/">download them here</a><br />
<br />
<a name="general__hardware"><b>What hardware products support FLAC?</b></a><br />
<br />
@ -294,11 +291,11 @@
<a name="tools__eac_and_flac"><b>How do I set up EAC to rip directly to FLAC?</b></a><br />
<br />
See Case's excellent <a href="http://www.saunalahti.fi/cse/EAC/index.html">EAC configuration page</a>. Or use <a href="http://www.legroom.net/modules.php?op=modload&amp;name=Open_Source&amp;file=index&amp;page=software&amp;app=autoflac">AutoFLAC</a>, <a href="http://www.omniencoder.com/">Omni Encoder</a>, or <a href="http://mareo.netfirms.com/">MAREO</a> to rip to FLAC or multiple formats at once.<br />
See Case's excellent <a href="http://www.saunalahti.fi/cse/EAC/index.html">EAC configuration page</a>. Or use <a href="http://www.legroom.net/software/autoflac">AutoFLAC</a> or <a href="http://mareo.netfirms.com/">MAREO</a> to rip to FLAC or multiple formats at once.<br />
<br />
<a name="tools__runtime75"><b>Why am I getting "Run-time error '75': Path/File access error" with FLAC Frontend?</b></a><br />
<br />
Depending on how FLAC Frontend is installed, it could be one of two things: 1) you are trying to encode to file to a directory where you do not have write permission; 2) the FLAC Frontend program must be set to run as Administrator by opening Windows Explorer, navigating to <span class="command">C:\Program Files\FLAC</span> (or wherever FLAC was installed), then right-clicking on <span class="command">FLAC Frontend.exe</span> and checking "Run this program as an administrator".<br />
You are probably using an old version of FLAC Frontend. Try downloading a new version from <a href="http://flacfrontend.sf.net/">this sourceforge page</a><br />
<br />
<a name="tools__option_blocking"><b>How do I encode a file that starts with a dash?</b></a><br />
<br />
@ -310,13 +307,9 @@
<br />
Since metadata is stored at the beginning of a FLAC file, changing the length of it can sometimes cause the whole file to be rewritten. You can avoid this by adding padding with <span class="commandname">flac</span> when you encode, or with <span class="commandname">metaflac</span> after encoding. By default, <span class="commandname">flac</span> adds 8k of padding; you can change this amount if you need more or less.<br />
<br />
<a name="tools__unicode_filenames_windows"><b>Why don't Unicode file names work with <span class="commandname">flac</span>/<span class="commandname">metaflac</span> on Windows?</b></a><br />
<br />
Windows implements Unicode filenames differently than all other operating systems, and can only be supported via Windows APIs (non-portable). Also the method is different for different versions of Windows. It's so hard to get right that most programs that have to work for other operating systems also do not support it. A workaround can be found <a href="http://www.hydrogenaudio.org/forums/index.php?showtopic=48131">here</a>.<br />
<br />
<a name="tools__wildcards_on_windows"><b>Why don't wildcards for file names like *.flac or *.wav work with <span class="commandname">flac</span>/<span class="commandname">metaflac</span> on Windows?</b></a><br />
<br />
The Windows command shells (cmd.exe, command.com) implement wildcard handling differently than most other shells, leaving it up to the program to do everything including difficult and ambiguous cases. For an explanation of why wildcards on cmd.exe/command.com are dangerous, see <a href="http://www.hydrogenaudio.org/forums/index.php?showtopic=50667&amp;st=75&amp;p=466078&amp;#entry466078">here</a>. Better command shells for Windows exist, e.g. from <a href="http://cygwin.com/">Cygwin</a>. A workaround with the Windows shells is to do something like:<br />
The Windows command shells (cmd.exe, command.com) implement wildcard handling differently than most other shells, leaving it up to the program to do everything including difficult and ambiguous cases. For an explanation of why wildcards on cmd.exe/command.com are dangerous, see <a href="http://www.hydrogenaud.io/forums/index.php?showtopic=50667&amp;st=75&amp;p=466078&amp;#entry466078">here</a>. Better command shells for Windows exist, e.g. from <a href="http://cygwin.com/">Cygwin</a>. A workaround with the Windows shells is to do something like:<br />
<br />
<tt>for %F in (*.wav) do flac "%F"</tt><br />
<br />
@ -326,9 +319,9 @@
<br />
The only known cause of verify errors is faulty hardware. The dead giveaway is that if you repeat the exact same command, the error occurs in a different place or not at all. This can also happen when decoding or testing a FLAC file. If this is happening it is your hardware and not a FLAC bug.<br />
<br />
The problem is usually caused by overclocking/overheating the CPU or bad RAM. Try one of the many free programs available for testing hardware (e.g. <a href="http://www.memtest86.org/">Memtest86+</a>). We have had reports of a few cases where a system is passing with flying colors and still getting unrepeatable FLAC errors, and the one thing many (all?) of these systems have in common is an ASUS motherboard (A7V133 or P3V4X) which we suspect is buggy in some way. (<a href="https://sourceforge.net/tracker/index.php?func=detail&amp;aid=884401&amp;group_id=13478&amp;atid=113478">See also</a>)<br />
The problem is usually caused by overclocking/overheating the CPU or bad RAM. Try one of the many free programs available for testing hardware (e.g. <a href="http://www.memtest.org/">Memtest</a>).<br />
<br />
If you ever have a verify error that fails at the same place every time, please <a href="faq.html#project__submit_bug">file a bug</a>, uploading a sample according to <a href="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=585158&amp;group_id=13478&amp;atid=113478">the instructions found at the bottom of this bug report</a>.<br />
If you ever have a verify error that fails at the same place every time, please <a href="faq.html#project__submit_bug">file a bug</a>, uploading a sample according to <a href="http://sourceforge.net/p/flac/bugs/42/">the instructions found at the bottom of this bug report</a>.<br />
<br />
<a name="tools__wave_flac_wave"><b>I compressed a WAVE file to FLAC, then decompressed to WAVE, and the two weren't identical. Why?</b></a><br />
<a name="tools__skipped_subchunk"><b>I compressed a WAVE file to FLAC and it said "warning: skipping unknown sub-chunk LIST". Why?</b></a><br />
@ -369,7 +362,7 @@
<a name="project__lists"><b>Where are the mailing lists, forums, discussion areas, etc.?</b></a><br />
<br />
There are a few places. The main discussions happen on <a href="http://lists.xiph.org/mailman/listinfo">the official FLAC mailing lists</a> (you must subscribe to post). Also, there is a lot of discussion relating to FLAC on <a href="http://www.hydrogenaudio.org/">Hydrogen Audio</a>.<br />
There are a few places. The main discussions happen on <a href="http://lists.xiph.org/mailman/listinfo">the official FLAC mailing lists</a> (you must subscribe to post). Also, there is a lot of discussion relating to FLAC on <a href="http://www.hydrogenaud.io/">Hydrogen Audio</a>.<br />
<br />
<a name="project__submit_bug"><b>How do I submit a bug report?</b></a><br />
<br />

14
doc/html/format.html
View File

@ -136,10 +136,10 @@
FLAC owes much to the many people who have advanced the audio compression field so freely. For instance:
<ul>
<li>
<a href="http://svr-www.eng.cam.ac.uk/~ajr/">A. J. Robinson</a> for his work on <a href="http://www-svr.eng.cam.ac.uk/reports/abstracts/robinson_tr156.html">Shorten</a>; his paper is a good starting point on some of the basic methods used by FLAC. FLAC trivially extends and improves the fixed predictors, LPC coefficient quantization, and Rice coding used in Shorten.
<a href="http://svr-www.eng.cam.ac.uk/~ajr/">A. J. Robinson</a> for his work on <a href="http://svr-www.eng.cam.ac.uk/reports/abstracts/robinson_tr156.html">Shorten</a>; his paper is a good starting point on some of the basic methods used by FLAC. FLAC trivially extends and improves the fixed predictors, LPC coefficient quantization, and Rice coding used in Shorten.
</li>
<li>
<a href="http://commsci.usc.edu/faculty/golomb.html">S. W. Golomb</a> and Robert F. Rice; their universal codes are used by FLAC's entropy coder.
<a href="https://web.archive.org/web/20040215005354/http://csi.usc.edu/faculty/golomb.html">S. W. Golomb</a> and Robert F. Rice; their universal codes are used by FLAC's entropy coder.
</li>
<li>
N. Levinson and J. Durbin; the reference encoder uses an algorithm developed and refined by them for determining the LPC coefficients from the autocorrelation coefficients.
@ -231,10 +231,10 @@
<b>Constant</b>. This predictor is used whenever the subblock is pure DC ("digital silence"), i.e. a constant value throughout. The signal is run-length encoded and added to the stream.
</li>
<li>
<b>Fixed linear predictor</b>. FLAC uses a class of computationally-efficient fixed linear predictors (for a good description, see <a href="http://www.hpl.hp.com/techreports/1999/HPL-1999-144.pdf">audiopak</a> and <a href="http://svr-www.eng.cam.ac.uk/~ajr/GroupPubs/Robinson94-tr156/index.html">shorten</a>). FLAC adds a fourth-order predictor to the zero-to-third-order predictors used by Shorten. Since the predictors are fixed, the predictor order is the only parameter that needs to be stored in the compressed stream. The error signal is then passed to the residual coder.
<b>Fixed linear predictor</b>. FLAC uses a class of computationally-efficient fixed linear predictors (for a good description, see <a href="http://www.hpl.hp.com/techreports/1999/HPL-1999-144.pdf">audiopak</a> and <a href="http://svr-www.eng.cam.ac.uk/reports/abstracts/robinson_tr156.html">shorten</a>). FLAC adds a fourth-order predictor to the zero-to-third-order predictors used by Shorten. Since the predictors are fixed, the predictor order is the only parameter that needs to be stored in the compressed stream. The error signal is then passed to the residual coder.
</li>
<li>
<b>FIR Linear prediction</b>. For more accurate modeling (at a cost of slower encoding), FLAC supports up to 32nd order FIR linear prediction (again, for information on linear prediction, see <a href="http://www.hpl.hp.com/techreports/1999/HPL-1999-144.pdf">audiopak</a> and <a href="http://svr-www.eng.cam.ac.uk/~ajr/GroupPubs/Robinson94-tr156/index.html">shorten</a>). The reference encoder uses the Levinson-Durbin method for calculating the LPC coefficients from the autocorrelation coefficients, and the coefficients are quantized before computing the residual. Whereas encoders such as Shorten used a fixed quantization for the entire input, FLAC allows the quantized coefficient precision to vary from subframe to subframe. The FLAC reference encoder estimates the optimal precision to use based on the block size and dynamic range of the original signal.
<b>FIR Linear prediction</b>. For more accurate modeling (at a cost of slower encoding), FLAC supports up to 32nd order FIR linear prediction (again, for information on linear prediction, see <a href="http://www.hpl.hp.com/techreports/1999/HPL-1999-144.pdf">audiopak</a> and <a href="http://svr-www.eng.cam.ac.uk/reports/abstracts/robinson_tr156.html">shorten</a>). The reference encoder uses the Levinson-Durbin method for calculating the LPC coefficients from the autocorrelation coefficients, and the coefficients are quantized before computing the residual. Whereas encoders such as Shorten used a fixed quantization for the entire input, FLAC allows the quantized coefficient precision to vary from subframe to subframe. The FLAC reference encoder estimates the optimal precision to use based on the block size and dynamic range of the original signal.
</li>
</ul>
<a name="residualcoding"><font size="+1"><b><u>Residual Coding</u></b></font></a><br />
@ -263,7 +263,7 @@
<li><a name="def_SEEKTABLE"><b>SEEKTABLE</b></a>: This is an optional block for storing seek points. It is possible to seek to any given sample in a FLAC stream without a seek table, but the delay can be unpredictable since the bitrate may vary widely within a stream. By adding seek points to a stream, this delay can be significantly reduced. Each seek point takes 18 bytes, so 1% resolution within a stream adds less than 2k. There can be only one SEEKTABLE in a stream, but the table can have any number of seek points. There is also a special 'placeholder' seekpoint which will be ignored by decoders but which can be used to reserve space for future seek point insertion.</li>
<li><a name="def_VORBIS_COMMENT"><b>VORBIS_COMMENT</b></a>: This block is for storing a list of human-readable name/value pairs. Values are encoded using UTF-8. It is an implementation of the <a href="http://xiph.org/vorbis/doc/v-comment.html">Vorbis comment specification</a> (without the framing bit). This is the only officially supported tagging mechanism in FLAC. There may be only one VORBIS_COMMENT block in a stream. In some external documentation, Vorbis comments are called FLAC tags to lessen confusion.</li>
<li><a name="def_CUESHEET"><b>CUESHEET</b></a>: This block is for storing various information that can be used in a cue sheet. It supports track and index points, compatible with Red Book CD digital audio discs, as well as other CD-DA metadata such as media catalog number and track ISRCs. The CUESHEET block is especially useful for backing up CD-DA discs, but it can be used as a general purpose cueing mechanism for playback.</li>
<li><a name="def_PICTURE"><b>PICTURE</b></a>: This block is for storing pictures associated with the file, most commonly cover art from CDs. There may be more than one PICTURE block in a file. The picture format is similar to the <a href="http://www.id3.org/id3v2.4.0-frames.txt">APIC frame in ID3v2</a>. The PICTURE block has a type, MIME type, and UTF-8 description like ID3v2, and supports external linking via URL (though this is discouraged). The differences are that there is no uniqueness constraint on the description field, and the MIME type is mandatory. The FLAC PICTURE block also includes the resolution, color depth, and palette size so that the client can search for a suitable picture without having to scan them all.</li>
<li><a name="def_PICTURE"><b>PICTURE</b></a>: This block is for storing pictures associated with the file, most commonly cover art from CDs. There may be more than one PICTURE block in a file. The picture format is similar to the <a href="http://www.id3.org/id3v2.4.0-frames">APIC frame in ID3v2</a>. The PICTURE block has a type, MIME type, and UTF-8 description like ID3v2, and supports external linking via URL (though this is discouraged). The differences are that there is no uniqueness constraint on the description field, and the MIME type is mandatory. The FLAC PICTURE block also includes the resolution, color depth, and palette size so that the client can search for a suitable picture without having to scan them all.</li>
</ul>
</li>
<li>
@ -834,7 +834,7 @@
&lt;12*8&gt;
</td>
<td>
Track ISRC. This is a 12-digit alphanumeric code; see <a href="http://www.ifpi.org/isrc/isrc_handbook.html">here</a> and <a href="http://www.disctronics.co.uk/technology/cdaudio/cdaud_isrc.htm">here</a>. A value of 12 ASCII NUL characters may be used to denote absence of an ISRC.
Track ISRC. This is a 12-digit alphanumeric code; see <a href="http://isrc.ifpi.org/">here</a> and <a href="http://www.disctronics.co.uk/technology/cdaudio/cdaud_isrc.htm">here</a>. A value of 12 ASCII NUL characters may be used to denote absence of an ISRC.
</td>
</tr>
<tr>
@ -1792,7 +1792,7 @@
Encoding parameter:<br />
<ul>
<li>
<tt>0000-11110</tt> : Rice parameter.
<tt>00000-11110</tt> : Rice parameter.
</li>
<li>
<tt>11111</tt> : Escape code, meaning the partition is in unencoded binary form using n bits per sample; n follows as a 5-bit number.

2
doc/html/id.html
View File

@ -251,7 +251,7 @@
<tt>786D6364 - "xmcd"</tt>
</td>
<td>
<a href="http://www.amb.org/xmcd">xmcd</a>
<a href="http://www.amb.org/xmcd/">xmcd</a>
</td>
</tr>
<!--

8
doc/html/license.html
View File

@ -46,17 +46,17 @@
<br />
The FLAC and Ogg FLAC formats themselves, and their specifications, are fully open to the public to be used for any purpose (the FLAC project reserves the right to set the FLAC specification and certify compliance). They are free for commercial or noncommercial use. That means that commercial developers may independently write FLAC or Ogg FLAC software which is compatible with the specifications for no charge and without restrictions of any kind. There are no licensing fees or royalties of any kind for use of the formats or their specifications, or for distributing, selling, or streaming media in the FLAC or Ogg FLAC formats.<br />
<br />
The FLAC project also makes available software that implements the formats, which is distributed according to <a href="http://www.opensource.org/docs/definition.php">Open Source</a> licenses as follows:<br />
The FLAC project also makes available software that implements the formats, which is distributed according to <a href="http://opensource.org/docs/definition.php">Open Source</a> licenses as follows:<br />
<br />
The reference implementation libraries are licensed under the New <!-- <a href="http://www.xiph.org/licenses/bsd/"> --><a href="https://git.xiph.org/?p=flac.git;a=blob;f=COPYING.Xiph">BSD License</a>. In simple terms, these libraries may be used by any application, Open or proprietary, linked or incorporated in whole, so long as acknowledgement is made to Xiph.org Foundation when using the source code in whole or in derived works. The Xiph License is free enough that the libraries have been used in commercial products to implement FLAC, including in the firmware of hardware devices where other Open Source licenses can be problematic. In the source code these libraries are called <span class="commandname">libFLAC</span> and <span class="commandname">libFLAC++</span>.<br />
The reference implementation libraries are licensed under the New <!-- <a href="http://www.xiph.org/licenses/bsd/"> --><a href="https://git.xiph.org/?p=flac.git;a=blob_plain;f=COPYING.Xiph">BSD License</a>. In simple terms, these libraries may be used by any application, Open or proprietary, linked or incorporated in whole, so long as acknowledgement is made to Xiph.org Foundation when using the source code in whole or in derived works. The Xiph License is free enough that the libraries have been used in commercial products to implement FLAC, including in the firmware of hardware devices where other Open Source licenses can be problematic. In the source code these libraries are called <span class="commandname">libFLAC</span> and <span class="commandname">libFLAC++</span>.<br />
<br />
The rest of the software that the FLAC project provides is licensed under the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> (GPL). This software includes various utilities for converting files to and from FLAC format, plugins for audio players, et cetera. In general, the GPL allows redistribution as long as derived works are also made available in source code form according to compatible terms.<br />
<br />
Neither the FLAC nor Ogg FLAC formats nor any of the implemented encoding/decoding methods are covered by any known patent.<br />
<br />
FLAC is one of a family of codecs of the Xiph.org Foundation, all created according to the same free ideals. For some other codecs' descriptions of the Xiph License see the <a href="http://www.vorbis.com/faq.psp#flic">Vorbis</a> license page.<br />
FLAC is one of a family of codecs of the Xiph.org Foundation, all created according to the same free ideals. For some other codecs' descriptions of the Xiph License see the <a href="http://speex.org/fsos/">Speex</a> and <a href="http://www.vorbis.com/faq/#flic">Vorbis</a> license pages.<br />
<br />
If you would like to redistribute parts or all of FLAC under different terms, contact the developers on the flac-dev mailinglist.
If you would like to redistribute parts or all of FLAC under different terms, <a href="http://lists.xiph.org/mailman/listinfo/flac-dev">contact the FLAC-dev mailinglist</a>.
</div>
<div class="box_footer"></div>
</div>

4
doc/html/ogg_mapping.html
View File

@ -42,7 +42,7 @@
</div>
<div class="box_header"></div>
<div class="box_body">
This page specifies the way in which compressed FLAC data is encapsulated in an Ogg transport layer. It assumes basic knowledge of the <a href="format.html">FLAC format</a> and <a href="http://www.xiph.org/vorbis/doc/oggstream.html">Ogg structure</a> and <a href="http://www.xiph.org/vorbis/doc/framing.html">framing</a>.<br />
This page specifies the way in which compressed FLAC data is encapsulated in an Ogg transport layer. It assumes basic knowledge of the <a href="format.html">FLAC format</a> and <a href="http://xiph.org/vorbis/doc/oggstream.html">Ogg structure</a> and <a href="http://xiph.org/vorbis/doc/framing.html">framing</a>.<br />
<br />
The original FLAC format includes a very thin transport system. This system of compressed FLAC audio data mixed with a thin transport has come to be known as 'native FLAC'. The transport consists of audio frame headers and footers which contain synchronization patterns, timecodes, and checksums (but notably not frame lengths), and a metadata system. It is very lightweight and does not support more elaborate transport mechanisms such as multiple logical streams, but it has served its purpose well.<br />
<br />
@ -93,7 +93,7 @@
FLAC packets may span page boundaries.
</li>
<li>
The granule position of pages containing FLAC audio follows the same semantics as that for Ogg-encapsulated Vorbis as described <a href="http://www.xiph.org/vorbis/doc/vorbis-ogg.html">here</a>.
The granule position of pages containing FLAC audio follows the same semantics as that for Ogg-encapsulated Vorbis as described <a href="http://xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-126000A">here</a>.
</li>
<li>
Redundant fields in the STREAMINFO packet may be set to zero (indicating "unknown" in native FLAC), which also facilitates single-pass encoding. These fields are: the minimum and maximum frame sizes, the total samples count, and the MD5 signature. "Unknown" values for these fields will not prevent a compliant native FLAC or Ogg FLAC decoder from decoding the stream.