libFLAC/lpc.c: Fix signed integer overflow
[flac.git] / doc / html / documentation_tools_metaflac.html
index 376846a..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  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">--no-utf8-convert</span>
                                </td>
                                <td>
-                                       Do not convert tags from UTF-8 to local charset, or vice versa.  This is useful for scripts.
+                                       Do not convert tags from UTF-8 to local charset, or vice versa.  This is useful for scripts, and setting tags in situations where the locale is wrong.
                                </td>
                        </tr>
                        <tr>
                                        <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>
                        <tr>
                                <td nowrap="nowrap" align="right" valign="top" bgcolor="#F4F4CC">
                                        <a name="metaflac_shorthand_import_picture_from" />
-                                       <span class="argument">--import-picture-from=SPECIFICATION</span>
+                                       <span class="argument">--import-picture-from={FILENAME|SPECIFICATION}</span>
                                </td>
                                <td>
                                        Import a picture and store it in a <a href="format.html#def_PICTURE"><span class="code">PICTURE</span></a> metadata block.  See the <span class="commandname">flac</span> option <span class="argument"><a href="documentation_tools_flac.html#flac_options_picture">--picture</a></span> for an explanation of the <span class="argument">SPECIFICATION</span> syntax.
                                        <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  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>