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

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 />

doc/html/documentation_tools_flac.html

@@ -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 />

man/flac.sgml

@@ -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>