Commit 08ef65e9 authored by Josh Coalson's avatar Josh Coalson

deprecate --sector-align; add --preserve-modtime and --no-preserve-modtime switches

parent a5b34c33
......@@ -53,6 +53,89 @@
<br />
<!-- @@@@@@
<a name="flac_1_2_2"><b>FLAC 1.2.2</b> (@@-@@@-2007)</a>
<br />
<ul>
<li>
General:
<ul>
<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.</li>
</ul>
</li>
<li>
FLAC format:
<ul>
<li>(none)</li>
</ul>
</li>
<li>
Ogg FLAC format:
<ul>
<li>(none)</li>
</ul>
</li>
<li>
flac:
<ul>
<li>Added a 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/tracker/index.php?func=detail&amp;aid=1805428&amp;group_id=13478&amp;atid=363478">SF #1805428</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/tracker/index.php?func=detail&amp;aid=1805946&amp;group_id=13478&amp;atid=363478">SF #1805946</a>)</li>
</ul>
</li>
<li>
metaflac:
<ul>
<li>(none)</li>
</ul>
</li>
<li>
plugins:
<ul>
<li>(none)</li>
</ul>
</li>
<li>
build system:
<ul>
<li>(none)</li>
</ul>
</li>
<li>
documentation:
<ul>
<li>(none)</li>
</ul>
</li>
<li>
libraries:
<ul>
<li>(none)</li>
</ul>
</li>
<li>
Interface changes (see also the <a href="http://flac.sourceforge.net/api/group__porting__1__2__1__to__1__2__2.html">porting guide</a> for specific instructions on porting to FLAC 1.2.2):
<ul>
<li>
libFLAC:
<ul>
<li>(none)</li>
</ul>
</li>
<li>
libFLAC++:
<ul>
<li>(none)</li>
</ul>
</li>
</ul>
</li>
</ul>
<br />
-->
<a name="flac_1_2_1"><b>FLAC 1.2.1</b> (17-Sep-2007)</a>
<br />
......
......@@ -317,6 +317,15 @@
Automatically delete the input file after a successful encode or decode. If there was an error (including a verify error) the input file is left intact.
</td>
</tr>
<tr>
<td nowrap="nowrap" align="right" valign="top" bgcolor="#F4F4CC">
<a name="flac_options_preserve_modtime" />
<span class="argument">--preserve-modtime</span>
</td>
<td>
Output files have their timestamps/permissions set to match those of their inputs (this is default). Use <span class="argument">--no-preserve-modtime</span> to make output files have the current time and default permissions.
</td>
</tr>
<tr>
<td nowrap="nowrap" align="right" valign="top" bgcolor="#F4F4CC">
<a name="flac_options_keep_foreign_metadata" />
......@@ -611,7 +620,9 @@
<br />
This option will have no effect if the files are already aligned (as is the normally the case with WAVE files ripped from a CD). <span class="commandname">flac</span> can only align a set of files given in one invocation of <span class="commandname">flac</span>.<br />
<br />
<b>WARNING:</b> The ordering of files is important! If you give a command like '<span class="code">flac --sector-align *.wav</span>' the shell may not expand the wildcard to the order you expect. To be safe you should '<span class="code">echo *.wav</span>' first to confirm the order, or be explicit like '<span class="code">flac --sector-align 8.wav 9.wav 10.wav</span>'.
<b>WARNING:</b> The ordering of files is important! If you give a command like '<span class="code">flac --sector-align *.wav</span>' the shell may not expand the wildcard to the order you expect. To be safe you should '<span class="code">echo *.wav</span>' first to confirm the order, or be explicit like '<span class="code">flac --sector-align 8.wav 9.wav 10.wav</span>'.<br />
<br />
<b>NOTE:</b>This option is DEPRECATED and may not exist in future version of <span class="commandname">flac</span>. <a href="http://www.etree.org/shnutils/shntool/">shntool</a> provides similar functionality.
</td>
</tr>
<tr>
......@@ -1053,10 +1064,12 @@
<a href="#negative_options" /><span class="argument">--no-delete-input-file</span></a><br />
<a href="#negative_options" /><span class="argument">--no-escape-coding</span></a><br />
<a href="#negative_options" /><span class="argument">--no-exhaustive-model-search</span></a><br />
<a href="#negative_options" /><span class="argument">--no-keep-foreign-metadata</span></a><br />
<a href="#negative_options" /><span class="argument">--no-lax</span></a><br />
<a href="#negative_options" /><span class="argument">--no-mid-side</span></a><br />
<a href="#negative_options" /><span class="argument">--no-ogg</span></a><br />
<a href="#negative_options" /><span class="argument">--no-padding</span></a><br />
<a href="#negative_options" /><span class="argument">--no-preserve-modtime</span></a><br />
<a href="#negative_options" /><span class="argument">--no-qlp-coeff-precision-search</span></a><br />
<a href="#negative_options" /><span class="argument">--no-residual-gnuplot</span></a><br />
<a href="#negative_options" /><span class="argument">--no-residual-text</span></a><br />
......
......@@ -205,6 +205,14 @@
</listitem>
</varlistentry>
<varlistentry>
<term><option>--preserve-modtime</option>
</term>
<listitem>
<para>Output files have their timestamps/permissions set to match those of their inputs (this is default). Use --no-preserve-modtime to make output files have the current time and default permissions.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--keep-foreign-metadata</option>
</term>
......@@ -376,7 +384,7 @@
<term><option>--sector-align</option></term>
<listitem>
<para>Align encoding of multiple CD format files on sector boundaries. See the HTML documentation for more information.</para>
<para>Align encoding of multiple CD format files on sector boundaries. See the HTML documentation for more information. This option is DEPRECATED and may not exist in future versions of flac.</para>
</listitem>
</varlistentry>
......@@ -670,6 +678,8 @@
<term><option>--no-adaptive-mid-side</option></term>
<term><option>--no-decode-through-errors</option></term>
<term><option>--no-delete-input-file</option></term>
<term><option>--no-preserve-modtime</option></term>
<term><option>--no-keep-foreign-metadata</option></term>
<term><option>--no-exhaustive-model-search</option></term>
<term><option>--no-lax</option></term>
<term><option>--no-mid-side</option></term>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment