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

diff --git a/doc/html/changelog.html b/doc/html/changelog.html
index 39be1d4..6f363fe 100644 (file)
--- a/doc/html/changelog.html
+++ b/doc/html/changelog.html
@@ -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 />

diff --git a/doc/html/documentation_tools_flac.html b/doc/html/documentation_tools_flac.html
index 4720b53..64a1300 100644 (file)
--- a/doc/html/documentation_tools_flac.html
+++ b/doc/html/documentation_tools_flac.html
@@ -319,6 +319,15 @@
                        </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" />
                                        <span class="argument">--keep-foreign-metadata</span>
                                </td>
@@ -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 />

diff --git a/man/flac.sgml b/man/flac.sgml
index cd34dfd..7572a73 100644 (file)
--- a/man/flac.sgml
+++ b/man/flac.sgml
@@ -206,6 +206,14 @@
        </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>
          <listitem>
@@ -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>