document --keep-foreign-metadata

diff --git a/man/flac.sgml b/man/flac.sgml
index 2758db4..cd34dfd 100644 (file)
--- a/man/flac.sgml
+++ b/man/flac.sgml
@@ -206,6 +206,14 @@
        </varlistentry>
 
        <varlistentry>
+         <term><option>--keep-foreign-metadata</option>
+         </term>
+         <listitem>
+           <para>If encoding, save WAVE or AIFF non-audio chunks in FLAC metadata.  If decoding, restore any saved non-audio chunks from FLAC metadata when writing the decoded file.  Foreign metadata cannot be transcoded, e.g. WAVE chunks saved in a FLAC file cannot be restored when decoding to AIFF.  Input and output must be regular files (not stdin or stdout).</para>
+         </listitem>
+       </varlistentry>
+
+       <varlistentry>
          <term><option>--skip</option>={<replaceable>#</replaceable>|<replaceable>mm:ss.ss</replaceable>}</term>
          <listitem>
            <para>Skip over the first number of samples of the input.  This works for both encoding and decoding, but not testing.  The alternative form mm:ss.ss can be used to specify minutes, seconds, and fractions of a second.</para>