rename metaflac *-vc-* options to *-tag-* ones, only ones remain but deprecated
[platform/upstream/flac.git] / man / metaflac.sgml
index 0bab491..f4f2e7e 100644 (file)
@@ -20,7 +20,7 @@ manpage.1: manpage.sgml
   <!ENTITY manfirstname "<firstname>dann</firstname>">
   <!ENTITY mansurname   "<surname>frazier</surname>">
   <!-- Please adjust the date whenever revising the manpage. -->
-  <!ENTITY mandate      "<date>2002-11-30</date>">
+  <!ENTITY mandate      "<date>2004-09-14</date>">
   <!-- SECTION should be 1-8, maybe with subsection. Other parameters are
        allowed: see man(7), man(1). -->
   <!ENTITY mansection   "<manvolnum>1</manvolnum>">
@@ -40,7 +40,7 @@ manpage.1: manpage.sgml
       &mansurname;
     </author>
     <copyright>
-      <year>2002</year>
+      <year>2002,2003,2004</year>
       <holder>&manusername;</holder>
     </copyright>
     &mandate;
@@ -194,7 +194,7 @@ manpage.1: manpage.sgml
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><option>--show-vc-vendor</option></term>
+        <term><option>--show-vendor-tag</option></term>
         <listitem>
           <para>
            Show the vendor string from the VORBIS_COMMENT block.
@@ -202,65 +202,63 @@ manpage.1: manpage.sgml
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><option>--show-vc-field=name</option></term>
+        <term><option>--show-tag=name</option></term>
         <listitem>
           <para>
-           Show all Vorbis comment fields where the the field name matches
-           'name'.
+           Show all tags where the the field name matches 'name'.
          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><option>--remove-vc-field=name</option></term>
+        <term><option>--remove-tag=name</option></term>
         <listitem>
           <para>
-           Remove all Vorbis comment fields whose field name is 'name'.
+           Remove all tags whose field name is 'name'.
          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><option>--remove-vc-firstfield=name</option></term>
+        <term><option>--remove-first-tag=name</option></term>
         <listitem>
           <para>
-           Remove first Vorbis comment field whose field name is 'name'.
+           Remove first tag whose field name is 'name'.
          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><option>--remove-vc-all</option></term>
+        <term><option>--remove-all-tags</option></term>
         <listitem>
           <para>
-           Remove all Vorbis comment fields, leaving only the vendor string
-           in the VORBIS_COMMENT block.
+           Remove all tags, leaving only the vendor string.
          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><option>--set-vc-field=field</option></term>
+        <term><option>--set-tag=field</option></term>
         <listitem>
           <para>
-           Add a Vorbis comment field.  The field must comply with the
+           Add a tag.  The field must comply with the
            Vorbis comment spec, of the form "NAME=VALUE".  If there is
-           currently no VORBIS_COMMENT block, one will be created.
+           currently no tag block, one will be created.
          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-       <term><option>--import-vc-from=file</option></term>
+       <term><option>--import-tags-from=file</option></term>
         <listitem>
          <para>
-           Import Vorbis comments from a file.  Use '-' for stdin.  Each
+           Import tags from a file.  Use '-' for stdin.  Each
            line should be of the form NAME=VALUE.  Multi-line comments
-           are currently not supported.  Specify --remove-vc-all and/or
-           --no-utf8-convert before --import-vc-from if necessary.
+           are currently not supported.  Specify --remove-all-tags and/or
+           --no-utf8-convert before --import-tags-from if necessary.
          </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-       <term><option>--export-vc-to=file</option></term>
+       <term><option>--export-tags-to=file</option></term>
         <listitem>
          <para>
-           Export Vorbis comments to a file.  Use '-' for stdin.  Each
+           Export tags to a file.  Use '-' for stdin.  Each
            line will be of the form NAME=VALUE.  Specify
            --no-utf8-convert if necessary.
          </para>
@@ -306,8 +304,8 @@ manpage.1: manpage.sgml
         </listitem>
       </varlistentry>
       <varlistentry>
-       <listitem>
        <term><option>--add-seekpoint</option>={<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>|<replaceable>#s</replaceable>}</term>
+       <listitem>
          <para>
            Add seek points to a SEEKTABLE block.  Using #, a seek point at
            that sample number is added.  Using X, a placeholder point is