libFLAC/lpc.c: Fix signed integer overflow
[flac.git] / doc / html / documentation_tools_metaflac.html
index 377ee98..122d70b 100644 (file)
@@ -1,11 +1,12 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Copyright (c) 2000,2001,2002,2003,2004,2005,2006,2007  Josh Coalson -->
+<!-- Copyright (c) 2000-2009  Josh Coalson -->
+<!-- Copyright (c) 2011-2016  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>
+<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
        <meta name="author" content="Josh Coalson" />
@@ -19,7 +20,7 @@
 <body>
 
 <div class="logo">
-       <a href="http://flac.sourceforge.net/"><img src="images/logo130.gif" alt="FLAC Logo" align="middle" border="0" hspace="0" /></a>
+       <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="news.html">news</a>&nbsp;&nbsp;|
-       &nbsp;<a href="download.html">download</a>&nbsp;&nbsp;|
        &nbsp;<a href="documentation.html">documentation</a>&nbsp;&nbsp;|
-       &nbsp;<a href="comparison.html">comparison</a>&nbsp;&nbsp;|
+       &nbsp;<a href="developers.html">developers</a>&nbsp;&nbsp;|
        &nbsp;<a href="changelog.html">changelog</a>&nbsp;&nbsp;|
-       &nbsp;<a href="links.html">links</a>&nbsp;&nbsp;|
-       &nbsp;<a href="developers.html">developers</a>&nbsp;
-</div>
-
-<div class="langbar">
-       &nbsp;english&nbsp;&nbsp;|
-       &nbsp;<a href="ru/documentation.html">russian</a>&nbsp;
+       &nbsp;<a href="http://xiph.org/flac">more</a>
 </div>
 
 <div class="below_nav"></div>
                                        <span class="argument">--show-tag=NAME</span>
                                </td>
                                <td>
-                                       Show all tags where the the field name matches <span class="argument">NAME</span>.
+                                       Show all tags where the field name matches <span class="argument">NAME</span>.
                                </td>
                        </tr>
                        <tr>
                                        <span class="argument">--add-replay-gain</span>
                                </td>
                                <td>
-                                       Calculates the title and album gains/peaks of the given FLAC files as if all the files were part of one album, then stores them in the <span class="code">VORBIS_COMMENT</span> block.  The tags are the same as those used by <span class="commandname">vorbisgain</span>.  Existing ReplayGain tags will be replaced.  If only one FLAC file is given, the album and title gains will be the same.  Since this operation requires two passes, it is always executed last, after all other operations have been completed and written to disk.  All FLAC files specified must have the same resolution, sample rate, and number of channels.  The sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz.
+                                       Calculates the title and album gains/peaks of the given FLAC files as if all the files were part of one album, then stores them as FLAC tags.  The tags are the same as those used by <span class="commandname">vorbisgain</span>.  Existing ReplayGain tags will be replaced.  If only one FLAC file is given, the album and title gains will be the same.  Since this operation requires two passes, it is always executed last, after all other operations have been completed and written to disk.  All FLAC files specified must have the same resolution, sample rate, and number of channels.  The sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz.
+                               </td>
+                       </tr>
+                       <tr>
+                               <td nowrap="nowrap" align="right" valign="top" bgcolor="#F4F4CC">
+                                       <a name="metaflac_shorthand_add_replay_gain_scan" />
+                                       <span class="argument">--scan-replay-gain</span>
+                               </td>
+                               <td>
+                                       Like <span class="argument">--add-replay-gain</span>, but only analyzes the files rather than writing them to the tags.
                                </td>
                        </tr>
                        <tr>
                <br />
                <a name="option_index"><font size="+1"><b><u>Option Index</u></b></font></a><br />
                <br />
-               <a href="#metaflac_shorthand_add_padding" /><span class="argument">--add-padding</span></a><br />
-               <a href="#metaflac_shorthand_add_replay_gain" /><span class="argument">--add-replay-gain</span></a><br />
-               <a href="#metaflac_shorthand_add_seekpoint" /><span class="argument">--add-seekpoint</span></a><br />
-               <a href="#metaflac_options_dont_use_padding" /><span class="argument">--dont-use-padding</span></a><br />
-               <a href="#metaflac_shorthand_export_cuesheet_to" /><span class="argument">--export-cuesheet-to</span></a><br />
-               <a href="#metaflac_shorthand_export_picture_to" /><span class="argument">--export-picture-to</span></a><br />
-               <a href="#metaflac_shorthand_export_tags_to" /><span class="argument">--export-tags-to</span></a><br />
-               <a href="#metaflac_shorthand_import_cuesheet_from" /><span class="argument">--import-cuesheet-from</span></a><br />
-               <a href="#metaflac_shorthand_import_picture_from" /><span class="argument">--import-picture-from</span></a><br />
-               <a href="#metaflac_shorthand_import_tags_from" /><span class="argument">--import-tags-from</span></a><br />
-               <a href="#metaflac_operations_list" /><span class="argument">--list</span></a><br />
-               <a href="#metaflac_operations_merge_padding" /><span class="argument">--merge-padding</span></a><br />
-               <a href="#metaflac_options_no_filename" /><span class="argument">--no-filename</span></a><br />
-               <a href="#metaflac_options_no_utf8_convert" /><span class="argument">--no-utf8-convert</span></a><br />
-               <a href="#metaflac_options_preserve_modtime" /><span class="argument">--preserve-modtime</span></a><br />
-               <a href="#metaflac_shorthand_remove_all_tags" /><span class="argument">--remove-all-tags</span></a><br />
-               <a href="#metaflac_operations_remove_all" /><span class="argument">--remove-all</span></a><br />
-               <a href="#metaflac_shorthand_remove_first_tag" /><span class="argument">--remove-first-tag</span></a><br />
-               <a href="#metaflac_shorthand_remove_replay_gain" /><span class="argument">--remove-replay-gain</span></a><br />
-               <a href="#metaflac_shorthand_remove_tag" /><span class="argument">--remove-tag</span></a><br />
-               <a href="#metaflac_operations_remove" /><span class="argument">--remove</span></a><br />
-               <a href="#metaflac_shorthand_set_tag_from_file" /><span class="argument">--set-tag-from-file</span></a><br />
-               <a href="#metaflac_shorthand_set_tag" /><span class="argument">--set-tag</span></a><br />
-               <a href="#metaflac_shorthand_show_bps" /><span class="argument">--show-bps</span></a><br />
-               <a href="#metaflac_shorthand_show_channels" /><span class="argument">--show-channels</span></a><br />
-               <a href="#metaflac_shorthand_show_max_blocksize" /><span class="argument">--show-max-blocksize</span></a><br />
-               <a href="#metaflac_shorthand_show_max_framesize" /><span class="argument">--show-max-framesize</span></a><br />
-               <a href="#metaflac_shorthand_show_md5sum" /><span class="argument">--show-md5sum</span></a><br />
-               <a href="#metaflac_shorthand_show_min_blocksize" /><span class="argument">--show-min-blocksize</span></a><br />
-               <a href="#metaflac_shorthand_show_min_framesize" /><span class="argument">--show-min-framesize</span></a><br />
-               <a href="#metaflac_shorthand_show_sample_rate" /><span class="argument">--show-sample-rate</span></a><br />
-               <a href="#metaflac_shorthand_show_tag" /><span class="argument">--show-tag</span></a><br />
-               <a href="#metaflac_shorthand_show_total_samples" /><span class="argument">--show-total-samples</span></a><br />
-               <a href="#metaflac_shorthand_show_vendor_tag" /><span class="argument">--show-vendor-tag</span></a><br />
-               <a href="#metaflac_operations_sort_padding" /><span class="argument">--sort-padding</span></a><br />
-               <a href="#metaflac_operations_version" /><span class="argument">--version</span></a><br />
-               <a href="#metaflac_options_with_filename" /><span class="argument">--with-filename</span></a><br />
+               <a href="#metaflac_shorthand_add_padding"><span class="argument">--add-padding</span></a><br />
+               <a href="#metaflac_shorthand_add_replay_gain"><span class="argument">--add-replay-gain</span></a><br />
+               <a href="#metaflac_shorthand_add_seekpoint"><span class="argument">--add-seekpoint</span></a><br />
+               <a href="#metaflac_options_dont_use_padding"><span class="argument">--dont-use-padding</span></a><br />
+               <a href="#metaflac_shorthand_export_cuesheet_to"><span class="argument">--export-cuesheet-to</span></a><br />
+               <a href="#metaflac_shorthand_export_picture_to"><span class="argument">--export-picture-to</span></a><br />
+               <a href="#metaflac_shorthand_export_tags_to"><span class="argument">--export-tags-to</span></a><br />
+               <a href="#metaflac_shorthand_import_cuesheet_from"><span class="argument">--import-cuesheet-from</span></a><br />
+               <a href="#metaflac_shorthand_import_picture_from"><span class="argument">--import-picture-from</span></a><br />
+               <a href="#metaflac_shorthand_import_tags_from"><span class="argument">--import-tags-from</span></a><br />
+               <a href="#metaflac_operations_list"><span class="argument">--list</span></a><br />
+               <a href="#metaflac_operations_merge_padding"><span class="argument">--merge-padding</span></a><br />
+               <a href="#metaflac_options_no_filename"><span class="argument">--no-filename</span></a><br />
+               <a href="#metaflac_options_no_utf8_convert"><span class="argument">--no-utf8-convert</span></a><br />
+               <a href="#metaflac_options_preserve_modtime"><span class="argument">--preserve-modtime</span></a><br />
+               <a href="#metaflac_shorthand_remove_all_tags"><span class="argument">--remove-all-tags</span></a><br />
+               <a href="#metaflac_operations_remove_all"><span class="argument">--remove-all</span></a><br />
+               <a href="#metaflac_shorthand_remove_first_tag"><span class="argument">--remove-first-tag</span></a><br />
+               <a href="#metaflac_shorthand_remove_replay_gain"><span class="argument">--remove-replay-gain</span></a><br />
+               <a href="#metaflac_shorthand_remove_tag"><span class="argument">--remove-tag</span></a><br />
+               <a href="#metaflac_operations_remove"><span class="argument">--remove</span></a><br />
+               <a href="#metaflac_shorthand_scan_replay_gain"><span class="argument">--scan-replay-gain</span></a><br />
+               <a href="#metaflac_shorthand_set_tag_from_file"><span class="argument">--set-tag-from-file</span></a><br />
+               <a href="#metaflac_shorthand_set_tag"><span class="argument">--set-tag</span></a><br />
+               <a href="#metaflac_shorthand_show_bps"><span class="argument">--show-bps</span></a><br />
+               <a href="#metaflac_shorthand_show_channels"><span class="argument">--show-channels</span></a><br />
+               <a href="#metaflac_shorthand_show_max_blocksize"><span class="argument">--show-max-blocksize</span></a><br />
+               <a href="#metaflac_shorthand_show_max_framesize"><span class="argument">--show-max-framesize</span></a><br />
+               <a href="#metaflac_shorthand_show_md5sum"><span class="argument">--show-md5sum</span></a><br />
+               <a href="#metaflac_shorthand_show_min_blocksize"><span class="argument">--show-min-blocksize</span></a><br />
+               <a href="#metaflac_shorthand_show_min_framesize"><span class="argument">--show-min-framesize</span></a><br />
+               <a href="#metaflac_shorthand_show_sample_rate"><span class="argument">--show-sample-rate</span></a><br />
+               <a href="#metaflac_shorthand_show_tag"><span class="argument">--show-tag</span></a><br />
+               <a href="#metaflac_shorthand_show_total_samples"><span class="argument">--show-total-samples</span></a><br />
+               <a href="#metaflac_shorthand_show_vendor_tag"><span class="argument">--show-vendor-tag</span></a><br />
+               <a href="#metaflac_operations_sort_padding"><span class="argument">--sort-padding</span></a><br />
+               <a href="#metaflac_operations_version"><span class="argument">--version</span></a><br />
+               <a href="#metaflac_options_with_filename"><span class="argument">--with-filename</span></a><br />
 
        </div>
        <div class="box_footer"></div>
        <table>
                <tr>
                        <td align="left">
-                               Copyright (c) 2000,2001,2002,2003,2004,2005,2006,2007  Josh Coalson
-                       </td>
-                       <td width="1%" align="right">
-                               <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=13478&amp;type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
-                       </td>
-                       <td width="1%" align="right">
-                               <a href="http://www.eff.org/cafe/"><img src="images/cafebug.gif" alt="CAFE Logo" border="0" /></a><br />
-                       </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>
+                               Copyright (c) 2000-2009  Josh Coalson
+                               <br/>
+                               Copyright (c) 2011-2016  Xiph.Org Foundation
                        </td>
                </tr>
        </table>