mirror of https://github.com/xiph/flac
deprecate --sector-align; add --preserve-modtime and --no-preserve-modtime switches
This commit is contained in:
Josh Coalson
parent
a5b34c33ee
commit
08ef65e9cd
|
|
@ -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&aid=1805428&group_id=13478&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&aid=1805946&group_id=13478&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>
|
||||
|
|
|
|||
Loading…
Reference in New Issue