initial import
authorJosh Coalson <jcoalson@users.sourceforce.net>
Sat, 21 Dec 2002 03:27:14 +0000 (03:27 +0000)
committerJosh Coalson <jcoalson@users.sourceforce.net>
Sat, 21 Dec 2002 03:27:14 +0000 (03:27 +0000)
man/metaflac.1 [new file with mode: 0644]
man/metaflac.sgml [new file with mode: 0644]

diff --git a/man/metaflac.1 b/man/metaflac.1
new file mode 100644 (file)
index 0000000..d5f7146
--- /dev/null
@@ -0,0 +1,216 @@
+.\" This manpage has been automatically generated by docbook2man 
+.\" from a DocBook document.  This tool can be found at:
+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
+.\" Please send any bug reports, improvements, comments, patches, 
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "METAFLAC" "1" "20 December 2002" "" ""
+.SH NAME
+metaflac \- program to list, add, remove, or edit metadata in one or more FLAC files.
+.SH SYNOPSIS
+
+\fBmetaflac\fR [ \fB\fIoptions\fB\fR ] [ \fB\fIoperations\fB\fR ] \fB\fIFLACfile\fB\fR\fI ...\fR
+
+.SH "DESCRIPTION"
+.PP
+Use \fBmetaflac\fR to list, add, remove, or edit
+metadata in one or more FLAC files.  You may perform one major operation,
+or many shorthand operations at a time.
+.SH "OPTIONS"
+.TP
+\fB--preserve-modtime\fR
+Preserve the original modification time in spite of edits.
+.TP
+\fB--with-filename\fR
+Prefix each output line with the FLAC file name (the default if
+more than one FLAC file is specified).
+.TP
+\fB--no-filename\fR
+Do not prefix each output line with the FLAC file name (the default
+if only one FLAC file is specified).
+.TP
+\fB--dont-use-padding\fR
+By default metaflac tries to use padding where possible to avoid
+rewriting the entire file if the metadata size changes.  Use this
+option to tell metaflac to not take advantage of padding this way.
+.SH "SHORTHAND OPERATIONS"
+.TP
+\fB--show-md5sum\fR
+Show the MD5 signature from the STREAMINFO block.
+.TP
+\fB--show-min-blocksize\fR
+Show the minimum block size from the STREAMINFO block.
+.TP
+\fB--show-max-blocksize\fR
+Show the maximum block size from the STREAMINFO block.
+.TP
+\fB--show-min-framesize\fR
+Show the minimum frame size from the STREAMINFO block.
+.TP
+\fB--show-max-framesize\fR
+Show the maximum frame size from the STREAMINFO block.
+.TP
+\fB--show-sample-rate\fR
+Show the sample rate from the STREAMINFO block.
+.TP
+\fB--show-channels\fR
+Show the number of channels from the STREAMINFO block.
+.TP
+\fB--show-bps\fR
+Show the # of bits per sample from the STREAMINFO block.
+.TP
+\fB--show-total-samples\fR
+Show the total # of samples from the STREAMINFO block.
+.TP
+\fB--show-vc-vendor\fR
+Show the vendor string from the VORBIS_COMMENT block.
+.TP
+\fB--show-vc-field=name\fR
+Show all Vorbis comment fields where the the field name matches
+\&'name'.
+.TP
+\fB--remove-vc-field=name\fR
+Remove all Vorbis comment fields whose field name is 'name'.
+.TP
+\fB--remove-vc-firstfield=name\fR
+Remove first Vorbis comment field whose field name is 'name'.
+.TP
+\fB--remove-vc-all\fR
+Remove all Vorbis comment fields, leaving only the vendor string
+in the VORBIS_COMMENT block.
+.TP
+\fB--set-vc-field=field\fR
+Add a Vorbis comment field.  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.
+.TP
+\fB--import-vc-from=file\fR
+Import Vorbis comments 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.
+.TP
+\fB--export-vc-to=file\fR
+Export Vorbis comments to a file.  Use '-' for stdin.  Each
+line will be of the form NAME=VALUE.  Specify
+--no-utf8-convert if necessary.
+.TP
+\fB--import-cuesheet-from=file\fR
+Import a cuesheet from a file.  Only one FLAC file may be
+specified.  A seekpoint will be added for each index point in
+the cuesheet to the SEEKTABLE unless --no-cued-seekpoints is
+specified.
+.TP
+\fB--export-cuesheet-to=file\fR
+Export CUESHEET block to a cuesheet file, suitable for use by
+CD authoring software.  Use '-' for stdin.  Only one FLAC file
+may be specified on the command line.
+.TP
+\fB--add-replay-gain\fR
+Calculates the title and album gains/peaks of the given FLAC
+files as if all the files were part of one album, then stores
+them in the VORBIS_COMMENT block.  The tags are the same as
+those used by vorbisgain.  Existing ReplayGain tags will be
+replaced.  If only one FLAC file is given, the album and title
+gains will be the same.  Since this operation requires two
+passes, it is always executed last, after all other operations
+have been completed and written to disk.  All FLAC files
+specified must have the same resolution, sample rate, and
+number of channels.  The sample rate must be one of 8, 11.025,
+12, 16, 22.05, 24, 32, 44.1, or 48 kHz.
+.TP
+\fB--add-seekpoint={\fI#\fB|\fIX\fB|\fI#x\fB|\fI#s\fB}\fR
+Add seek points to a SEEKTABLE block.  Using #, a seek point at
+that sample number is added.  Using X, a placeholder point is
+added at the end of a the table.  Using #x, # evenly spaced seek
+points will be added, the first being at sample 0.  Using #s, a
+seekpoint will be added every # seconds (# does not have to be a
+whole number; it can be, for example, 9.5, meaning a seekpoint
+every 9.5 seconds).  If no SEEKTABLE block exists, one will be
+created.  If one already exists, points will be added to the
+existing table, and any duplicates will be turned into placeholder
+points.  You may use many --add-seekpoint options; the resulting
+SEEKTABLE will be the unique-ified union of all such values.
+Example: --add-seekpoint=100x --add-seekpoint=3.5s will add 100
+evenly spaced seekpoints and a seekpoint every 3.5 seconds.
+.TP
+\fB--add-padding=length\fR
+Add a padding block of the given length (in bytes).  The overall
+length of the new block will be 4 + length; the extra 4 bytes is
+for the metadata block header.
+.SH "MAJOR OPERATIONS"
+.TP
+\fB--list\fR
+List the contents of one or more metadata blocks to stdout.  By
+default, all metadata blocks are listed in text format.  Use the
+following options to change this behavior:
+.RS
+.TP
+\fB--block-number=#[,#[...]]\fR
+An optional comma-separated list of block numbers to display.
+The first block, the STREAMINFO block, is block 0.
+.TP
+\fB--block-type=type[,type[...]]\fR
+.TP
+\fB--except-block-type=type[,type[...]]\fR
+An optional comma-separated list of block types to included
+or ignored with this option.  Use only one of --block-type or
+--except-block-type.  The valid block types are: STREAMINFO,
+PADDING, APPLICATION, SEEKTABLE, VORBIS_COMMENT.  You may
+narrow down the types of APPLICATION blocks displayed as
+follows:
+
+APPLICATION:abcd        The APPLICATION block(s) whose textual repre-
+sentation of the 4-byte ID is "abcd"
+APPLICATION:0xXXXXXXXX  The APPLICATION block(s) whose hexadecimal big-
+endian representation of the 4-byte ID is
+"0xXXXXXXXX".  For the example "abcd" above the
+hexadecimal equivalalent is 0x61626364
+.sp
+.RS
+.B "Note:"
+if both --block-number and --[except-]block-type are
+specified, the result is the logical AND of both
+arguments.
+.RE
+.TP
+\fB--application-data-format=hexdump|text\fR
+If the application block you are displaying contains binary
+data but your --data-format=text, you can display a hex dump
+of the application data contents instead using
+--application-data-format=hexdump.
+.RE
+.TP
+\fB--remove\fR
+Remove one or more metadata blocks from the metadata.  Unless
+--dont-use-padding is specified, the blocks will be replaced with
+padding.  You may not remove the STREAMINFO block.
+.RS
+.TP
+\fB--block-number=#[,#[...]]\fR
+.TP
+\fB--block-type=type[,type[...]]\fR
+.TP
+\fB--except-block-type=type[,type[...]]\fR
+See --list above for usage.
+.sp
+.RS
+.B "Note:"
+if both --block-number and --[except-]block-type are
+specified, the result is the logical AND of both arguments.
+.RE
+.RE
+.TP
+\fB--remove-all\fR
+Remove all metadata blocks (except the STREAMINFO block) from the
+metadata.  Unless --dont-use-padding is specified, the blocks will
+be replaced with padding.
+.TP
+\fB--merge-padding\fR
+Merge adjacent PADDING blocks into single blocks.
+.TP
+\fB--sort-padding\fR
+Move all PADDING blocks to the end of the metadata and merge them
+into a single block.
+.SH "SEE ALSO"
+.PP
+flac(1).
diff --git a/man/metaflac.sgml b/man/metaflac.sgml
new file mode 100644 (file)
index 0000000..0bab491
--- /dev/null
@@ -0,0 +1,489 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
+     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
+     less'.  A typical entry in a Makefile or Makefile.am is:
+
+manpage.1: manpage.sgml
+       docbook-to-man $< > $@
+  -->
+
+<!-- This is based on an example constructed by Colin Watson
+     <email>cjwatson@debian.org</email>, based on a man page template
+     provided by Tom Christiansen <email>tchrist@jhereg.perl.com</email>
+     and a DocBook man page example by Craig Small
+     <email>csmall@debian.org</email>.
+  -->
+
+  <!-- Fill in the various UPPER CASE things here. -->
+  <!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>">
+  <!-- SECTION should be 1-8, maybe with subsection. Other parameters are
+       allowed: see man(7), man(1). -->
+  <!ENTITY mansection   "<manvolnum>1</manvolnum>">
+  <!ENTITY manemail     "<email>dannf@debian.org</email>">
+  <!ENTITY manusername  "dannf">
+  <!ENTITY manucpackage "<refentrytitle>METAFLAC</refentrytitle>">
+  <!ENTITY manpackage   "metaflac">
+]>
+
+<refentry>
+  <refentryinfo>
+    <address>
+      &manemail;
+    </address>
+    <author>
+      &manfirstname;
+      &mansurname;
+    </author>
+    <copyright>
+      <year>2002</year>
+      <holder>&manusername;</holder>
+    </copyright>
+    &mandate;
+  </refentryinfo>
+  <refmeta>
+    &manucpackage;
+
+    &mansection;
+  </refmeta>
+  <refnamediv>
+    <refname>&manpackage;</refname>
+
+    <refpurpose>
+      program to list, add, remove, or edit metadata in one or more FLAC files.
+    </refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&manpackage;</command>
+
+      <group choice="opt"><arg><replaceable>options</replaceable></arg></group>
+      <group choice="opt">
+       <arg><replaceable>operations</replaceable></arg></group>
+      <arg rep="repeat" choice="req"><replaceable>FLACfile</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para>Use <command>&manpackage;</command> to list, add, remove, or edit
+      metadata in one or more FLAC files.  You may perform one major operation,
+      or many shorthand operations at a time.</para>
+
+  </refsect1>
+  <refsect1>
+    <title>OPTIONS</title>
+
+    <variablelist>
+      <varlistentry>
+        <term><option>--preserve-modtime</option></term>
+        <listitem>
+          <para>
+           Preserve the original modification time in spite of edits.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--with-filename</option></term>
+        <listitem>
+          <para>
+           Prefix each output line with the FLAC file name (the default if
+           more than one FLAC file is specified).
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--no-filename</option></term>
+        <listitem>
+          <para>
+           Do not prefix each output line with the FLAC file name (the default
+           if only one FLAC file is specified).
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--dont-use-padding</option></term>
+        <listitem>
+          <para>
+           By default metaflac tries to use padding where possible to avoid
+           rewriting the entire file if the metadata size changes.  Use this
+           option to tell metaflac to not take advantage of padding this way.
+         </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
+    <title>SHORTHAND OPERATIONS</title>
+
+    <variablelist>
+      <varlistentry>
+        <term><option>--show-md5sum</option></term>
+        <listitem>
+          <para>
+           Show the MD5 signature from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-min-blocksize</option></term>
+        <listitem>
+          <para>
+           Show the minimum block size from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-max-blocksize</option></term>
+        <listitem>
+          <para>
+           Show the maximum block size from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-min-framesize</option></term>
+        <listitem>
+          <para>
+           Show the minimum frame size from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-max-framesize</option></term>
+        <listitem>
+          <para>
+           Show the maximum frame size from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-sample-rate</option></term>
+        <listitem>
+          <para>
+           Show the sample rate from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-channels</option></term>
+        <listitem>
+          <para>
+           Show the number of channels from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-bps</option></term>
+        <listitem>
+          <para>
+           Show the # of bits per sample from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-total-samples</option></term>
+        <listitem>
+          <para>
+           Show the total # of samples from the STREAMINFO block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-vc-vendor</option></term>
+        <listitem>
+          <para>
+           Show the vendor string from the VORBIS_COMMENT block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--show-vc-field=name</option></term>
+        <listitem>
+          <para>
+           Show all Vorbis comment fields where the the field name matches
+           'name'.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--remove-vc-field=name</option></term>
+        <listitem>
+          <para>
+           Remove all Vorbis comment fields whose field name is 'name'.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--remove-vc-firstfield=name</option></term>
+        <listitem>
+          <para>
+           Remove first Vorbis comment field whose field name is 'name'.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--remove-vc-all</option></term>
+        <listitem>
+          <para>
+           Remove all Vorbis comment fields, leaving only the vendor string
+           in the VORBIS_COMMENT block.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--set-vc-field=field</option></term>
+        <listitem>
+          <para>
+           Add a Vorbis comment field.  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.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><option>--import-vc-from=file</option></term>
+        <listitem>
+         <para>
+           Import Vorbis comments 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.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><option>--export-vc-to=file</option></term>
+        <listitem>
+         <para>
+           Export Vorbis comments to a file.  Use '-' for stdin.  Each
+           line will be of the form NAME=VALUE.  Specify
+           --no-utf8-convert if necessary.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><option>--import-cuesheet-from=file</option></term>
+        <listitem>
+         <para>
+           Import a cuesheet from a file.  Only one FLAC file may be
+           specified.  A seekpoint will be added for each index point in
+           the cuesheet to the SEEKTABLE unless --no-cued-seekpoints is
+           specified.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><option>--export-cuesheet-to=file</option></term>
+        <listitem>
+         <para>
+           Export CUESHEET block to a cuesheet file, suitable for use by
+           CD authoring software.  Use '-' for stdin.  Only one FLAC file
+           may be specified on the command line.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><option>--add-replay-gain</option></term>
+        <listitem>
+         <para>
+           Calculates the title and album gains/peaks of the given FLAC
+           files as if all the files were part of one album, then stores
+           them in the VORBIS_COMMENT block.  The tags are the same as
+           those used by vorbisgain.  Existing ReplayGain tags will be
+           replaced.  If only one FLAC file is given, the album and title
+           gains will be the same.  Since this operation requires two
+           passes, it is always executed last, after all other operations
+           have been completed and written to disk.  All FLAC files
+           specified must have the same resolution, sample rate, and
+           number of channels.  The sample rate must be one of 8, 11.025,
+           12, 16, 22.05, 24, 32, 44.1, or 48 kHz.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+       <listitem>
+       <term><option>--add-seekpoint</option>={<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>|<replaceable>#s</replaceable>}</term>
+         <para>
+           Add seek points to a SEEKTABLE block.  Using #, a seek point at
+           that sample number is added.  Using X, a placeholder point is
+           added at the end of a the table.  Using #x, # evenly spaced seek
+           points will be added, the first being at sample 0.  Using #s, a
+           seekpoint will be added every # seconds (# does not have to be a
+           whole number; it can be, for example, 9.5, meaning a seekpoint
+           every 9.5 seconds).  If no SEEKTABLE block exists, one will be
+           created.  If one already exists, points will be added to the
+           existing table, and any duplicates will be turned into placeholder
+           points.  You may use many --add-seekpoint options; the resulting
+           SEEKTABLE will be the unique-ified union of all such values.
+           Example: --add-seekpoint=100x --add-seekpoint=3.5s will add 100
+           evenly spaced seekpoints and a seekpoint every 3.5 seconds.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--add-padding=length</option></term>
+        <listitem>
+          <para>
+           Add a padding block of the given length (in bytes).  The overall
+           length of the new block will be 4 + length; the extra 4 bytes is
+           for the metadata block header.
+         </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
+    <title>MAJOR OPERATIONS</title>
+
+    <variablelist>
+      <varlistentry>
+        <term><option>--list</option></term>
+        <listitem>
+          <para>
+           List the contents of one or more metadata blocks to stdout.  By
+           default, all metadata blocks are listed in text format.  Use the
+           following options to change this behavior:
+         </para>
+         <variablelist>
+           <varlistentry>
+             <term><option>--block-number=#[,#[...]]</option></term>
+             <listitem>
+               <para>
+                 An optional comma-separated list of block numbers to display.
+                 The first block, the STREAMINFO block, is block 0.
+               </para>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term><option>--block-type=type[,type[...]]</option></term>
+             <listitem><para></para></listitem>
+           </varlistentry>
+           <varlistentry>
+             <term><option>--except-block-type=type[,type[...]]</option></term>
+             <listitem>
+               <para>
+                 An optional comma-separated list of block types to included
+                 or ignored with this option.  Use only one of --block-type or
+                 --except-block-type.  The valid block types are: STREAMINFO,
+                 PADDING, APPLICATION, SEEKTABLE, VORBIS_COMMENT.  You may
+                 narrow down the types of APPLICATION blocks displayed as
+                 follows:
+               </para>
+               <para>
+        APPLICATION:abcd        The APPLICATION block(s) whose textual repre-
+                                sentation of the 4-byte ID is "abcd"
+        APPLICATION:0xXXXXXXXX  The APPLICATION block(s) whose hexadecimal big-
+                                endian representation of the 4-byte ID is
+                                "0xXXXXXXXX".  For the example "abcd" above the
+                                hexadecimal equivalalent is 0x61626364
+               </para>
+               <note>
+                 <para>
+                   if both --block-number and --[except-]block-type are
+                   specified, the result is the logical AND of both
+                   arguments.</para></note>
+             </listitem>
+           </varlistentry>
+           <varlistentry>
+             <term><option>--application-data-format=hexdump|text</option></term>
+             <listitem>
+               <para>
+                 If the application block you are displaying contains binary
+                 data but your --data-format=text, you can display a hex dump
+                 of the application data contents instead using
+                 --application-data-format=hexdump.
+               </para>
+             </listitem>
+           </varlistentry>
+         </variablelist>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--remove</option></term>
+        <listitem>
+          <para>
+            Remove one or more metadata blocks from the metadata.  Unless
+            --dont-use-padding is specified, the blocks will be replaced with
+            padding.  You may not remove the STREAMINFO block.
+         </para>
+         <variablelist>
+           <varlistentry>
+             <term><option>--block-number=#[,#[...]]</option></term>
+             <listitem><para></para></listitem>
+           </varlistentry>
+           <varlistentry>
+             <term><option>--block-type=type[,type[...]]</option></term>
+             <listitem><para></para></listitem>
+           </varlistentry>
+           <varlistentry>
+             <term><option>--except-block-type=type[,type[...]]</option></term>
+             <listitem>
+               <para>See --list above for usage.</para>
+               <note>
+                 <para>
+                   if both --block-number and --[except-]block-type are
+                   specified, the result is the logical AND of both arguments.
+                 </para></note>
+             </listitem>
+           </varlistentry>
+         </variablelist>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--remove-all</option></term>
+        <listitem>
+          <para>
+            Remove all metadata blocks (except the STREAMINFO block) from the
+            metadata.  Unless --dont-use-padding is specified, the blocks will
+            be replaced with padding.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--merge-padding</option></term>
+        <listitem>
+          <para>
+           Merge adjacent PADDING blocks into single blocks.
+         </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--sort-padding</option></term>
+        <listitem>
+          <para>
+           Move all PADDING blocks to the end of the metadata and merge them
+            into a single block.
+         </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  
+  <refsect1>
+    <title>SEE ALSO</title>
+
+    <para>flac(1).</para>
+  </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->