minor formatting
[flac.git] / man / flac.sgml
1 <!doctype refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
2
3   <!-- Fill in your name for FIRSTNAME and SURNAME. -->
4   <!ENTITY dhfirstname "<firstname>Matt</firstname>">
5   <!ENTITY dhsurname   "<surname>Zimmerman</surname>">
6   <!-- Please adjust the date whenever revising the manpage. -->
7   <!ENTITY dhdate      "<date>July 29, 2004</date>">
8   <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
9        allowed: see man(7), man(1). -->
10   <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
11   <!ENTITY dhemail     "<email>mdz@debian.org</email>">
12   <!ENTITY dhusername  "Matt Zimmerman">
13   <!ENTITY dhucpackage "<refentrytitle>FLAC</refentrytitle>">
14   <!ENTITY dhpackage   "flac">
15
16   <!ENTITY debian      "<productname>Debian GNU/Linux</productname>">
17   <!ENTITY gnu         "<acronym>GNU</acronym>">
18 ]>
19
20 <refentry>
21   <docinfo>
22     <address>
23         &dhemail;
24     </address>
25     <author>
26         &dhfirstname;
27         &dhsurname;
28       </author>
29         <copyright>
30                     <year>2002,2003,2004</year>
31                     <holder>&dhusername;</holder>
32         </copyright>
33             &dhdate;
34         </docinfo>
35   <refmeta>
36       &dhucpackage;
37
38       &dhsection;
39     </refmeta>
40       <refnamediv>
41                    <refname>&dhpackage;</refname>
42
43         <refpurpose>Free Lossless Audio Codec</refpurpose>
44       </refnamediv>
45         <refsynopsisdiv>
46           <cmdsynopsis>
47             <command>flac</command>
48             <arg choice=opt><replaceable>options</replaceable></arg>
49             <group rep=repeat>
50                <arg><replaceable>infile.wav</replaceable></arg>
51                <arg><replaceable>infile.aiff</replaceable></arg>
52                <arg><replaceable>infile.raw</replaceable></arg>
53                <arg>-</arg>
54             </group>
55           </cmdsynopsis>
56           <cmdsynopsis>
57             <command>flac</command>
58             <group>
59                <arg>-d</arg> <arg>--decode</arg>
60                <arg>-t</arg> <arg>--test</arg>
61                <arg>-a</arg> <arg>--analyze</arg>
62             </group>
63             <arg choice=opt><replaceable>OPTIONS</replaceable></arg>
64             <arg choice=opt rep=repeat><replaceable>infile.flac</replaceable></arg>
65           </cmdsynopsis>
66         </refsynopsisdiv>
67         <refsect1>
68           <title>DESCRIPTION</title>
69
70           <para><command>flac</command> is a command-line tool for
71              encoding, decoding, testing and analyzing FLAC streams.
72           </para>
73
74           <para>This manual page was originally written for the &debian;
75             distribution because the original program did not have a
76             manual page.</para>
77
78         </refsect1>
79         <refsect1>
80           <title>OPTIONS</title>
81
82           <para>A summary of options is included below.  For a complete
83           description, see the HTML documentation.</para>
84
85           <refsect2>
86             <title>General Options</title>
87
88             <variablelist>
89               <varlistentry>
90                 <term><option>-v</option>, <option>--version</option>
91                 </term>
92                 <listitem>
93                   <para>Show the flac version number</para>
94                 </listitem>
95               </varlistentry>
96
97               <varlistentry>
98                 <term><option>-h</option>, <option>--help</option>
99                 </term>
100                 <listitem>
101                   <para>Show basic usage and a list of all options</para>
102                 </listitem>
103               </varlistentry>
104
105               <varlistentry>
106                 <term><option>-H</option>, <option>--explain</option>
107                 </term>
108                 <listitem>
109                   <para>Show detailed explanation of usage and all options</para>
110                 </listitem>
111               </varlistentry>
112
113               <varlistentry>
114                 <term><option>-d</option>, <option>--decode</option>
115                 </term>
116                 <listitem>
117                   <para>Decode (the default behavior is to encode)</para>
118                 </listitem>
119               </varlistentry>
120
121               <varlistentry>
122                 <term><option>-t</option>, <option>--test</option>
123                 </term>
124                 <listitem>
125                   <para>Test a flac encoded file (same as -d
126                     except no decoded file is written)</para>
127                 </listitem>
128               </varlistentry>
129
130               <varlistentry>
131                 <term><option>-a</option>, <option>--analyze</option>
132                 </term>
133                 <listitem>
134                   <para>Analyze a FLAC encoded file (same as -d
135                     except an analysis file is written)</para>
136                 </listitem>
137               </varlistentry>
138
139               <varlistentry>
140                 <term><option>-c</option>, <option>--stdout</option>
141                 </term>
142                 <listitem>
143                   <para>Write output to stdout</para>
144                 </listitem>
145               </varlistentry>
146
147               <varlistentry>
148                 <term><option>-s</option>, <option>--silent</option>
149                 </term>
150                 <listitem>
151                   <para>Silent mode (do not write runtime
152                     encode/decode statistics to stderr)</para>
153                 </listitem>
154               </varlistentry>
155
156               <varlistentry>
157                 <term><option>--totally-silent</option>
158                 </term>
159                 <listitem>
160                   <para>Do not print anything of any kind,
161                     including warnings or errors.  The exit
162                     code will be the only way to determine
163                     successful completion.</para>
164                 </listitem>
165               </varlistentry>
166
167               <varlistentry>
168                 <term><option>-f</option>, <option>--force</option>
169                 </term>
170                 <listitem>
171                   <para>Force overwriting of output files.  By default,
172                     flac warns that the output file already exists and
173                     continues to the next file.</para>
174                 </listitem>
175               </varlistentry>
176
177               <varlistentry>
178                 <term><option>-o</option> <replaceable>filename</replaceable>, <option>--output-name</option>=<replaceable>filename</replaceable></term>
179                 <listitem>
180                   <para>Force the output file name (usually flac just
181                     changes the extension).  May only be used when
182                     encoding a single file.  May not be used in
183                     conjunction with --output-prefix.</para>
184                 </listitem>
185               </varlistentry>
186
187               <varlistentry>
188                 <term><option>--output-prefix</option>=<replaceable>string</replaceable></term>
189                 <listitem>
190                   <para>Prefix each output file name with the given
191                     string.  This can be useful for encoding or decoding
192                     files to a different directory.  Make sure if your
193                     string is a path name that it ends with a trailing
194                     `/' (slash).</para>
195                 </listitem>
196               </varlistentry>
197
198               <varlistentry>
199                 <term><option>--delete-input-file</option>
200                 </term>
201                 <listitem>
202                   <para>Automatically delete the input file after a
203                     successful encode or decode.  If there was an
204                     error (including a verify error) the input file
205                     is left intact.</para>
206                 </listitem>
207               </varlistentry>
208
209               <varlistentry>
210                 <term><option>--skip</option>={<replaceable>#</replaceable>|<replaceable>mm:ss.ss</replaceable>}</term>
211                 <listitem>
212                   <para>Skip over the first number of samples of the input.
213                     This works for both encoding and decoding, but not
214                     testing.  The alternative form mm:ss.ss can be used
215                     to specify minutes, seconds, and fractions of a
216                     second.</para>
217                 </listitem>
218               </varlistentry>
219
220               <varlistentry>
221                 <term><option>--until</option>={<replaceable>#</replaceable>|[<replaceable>+</replaceable>|<replaceable>-</replaceable>]<replaceable>mm:ss.ss</replaceable>}</term>
222                 <listitem>
223                   <para>Stop at the given sample number for each input file.
224                     This works for both encoding and decoding, but not testing.
225                     The given sample number is not included in the decoded
226                     output.  The alternative form mm:ss.ss can be used to
227                     specify minutes, seconds, and fractions of a second.  If a
228                     `+' (plus) sign is at the beginning, the --until point is
229                     relative to the --skip point.  If a `-' (minus) sign is at
230                     the beginning, the --until point is relative to end of the
231                     audio.</para>
232                 </listitem>
233               </varlistentry>
234
235               <varlistentry>
236                 <term><option>--ogg</option></term>
237
238                 <listitem>
239                   <para>When encoding, generate Ogg FLAC output instead
240                     of native FLAC.  Ogg FLAC streams are FLAC streams
241                     wrapped in an Ogg transport layer.  The resulting
242                     file should have an '.ogg' extension and will still
243                     be decodable by flac.</para>
244                   <para>When decoding, force the input to be treated as
245                     Ogg FLAC.  This is useful when piping input from
246                     stdin or when the filename does not end in '.ogg'.</para>
247                 </listitem>
248               </varlistentry>
249
250               <varlistentry>
251                 <term><option>--serial-number</option>=<replaceable>#</replaceable></term>
252
253                 <listitem>
254                   <para>When used with --ogg, specifies the serial number to
255                     use for the first Ogg FLAC stream, which is then
256                     incremented for each additional stream.  When encoding and
257                     no serial number is given, flac uses a random number for
258                     the first stream, then increments it for each additional
259                     stream.  When decoding and no number is given, flac uses
260                     the serial number of the first page.</para>
261                 </listitem>
262               </varlistentry>
263
264             </variablelist>
265           </refsect2>
266
267           <refsect2>
268             <title>Analysis Options</title>
269
270             <variablelist>
271               <varlistentry>
272                 <term><option>--residual-text</option>
273                 </term>
274                 <listitem>
275                   <para>Includes the residual signal in the analysis
276                     file.  This will make the file very big, much
277                     larger than even the decoded file.</para>
278                 </listitem>
279               </varlistentry>
280
281               <varlistentry>
282                 <term><option>--residual-gnuplot</option>
283                 </term>
284                 <listitem>
285                   <para>Generates a gnuplot file for every subframe;
286                     each file will contain the residual distribution
287                     of the subframe.  This will create a lot of
288                     files.</para>
289                 </listitem>
290               </varlistentry>
291
292             </variablelist>
293           </refsect2>
294
295           <refsect2>
296             <title>Decoding Options</title>
297
298             <variablelist>
299               <varlistentry>
300                 <term><option>--cue=[<replaceable>#.#</replaceable>][-[<replaceable>#.#</replaceable>]]</option></term>
301                 <listitem>
302                   <para>Set the beginning and ending cuepoints to decode.
303                     The optional first #.# is the track and index point at
304                     which decoding will start; the default is the beginning
305                     of the stream.  The optional second #.# is the track
306                     and index point at which decoding will end; the default
307                     is the end of the stream.  If the seekpoint does not
308                     exist, the closest one before it (for the start point)
309                     or after it (for the end point) will be used.  If those
310                     don't exist, the start of the stream (for the start
311                     point) or end of the stream (for the end point) will be
312                     used.  The cuepoints are merely translated into sample
313                     numbers then used as --skip and --until.</para>
314                 </listitem>
315               </varlistentry>
316
317               <varlistentry>
318                 <term><option>-F</option>, <option>--decode-through-errors</option>
319                 </term>
320                 <listitem>
321                   <para>By default flac stops decoding with an error
322                     and removes the partially decoded file if it
323                     encounters a bitstream error.  With -F, errors are
324                     still printed but flac will continue decoding to
325                     completion.  Note that errors may cause the decoded
326                     audio to be missing some samples or have silent
327                     sections.</para>
328                 </listitem>
329               </varlistentry>
330
331             </variablelist>
332           </refsect2>
333
334           <refsect2>
335             <title>Encoding Options</title>
336
337             <variablelist>
338               <varlistentry>
339                 <term><option>-V</option>, <option>--verify</option></term>
340
341                 <listitem>
342                   <para>Verify a correct encoding by decoding the
343                     output in parallel and comparing to the
344                     original</para>
345                 </listitem>
346               </varlistentry>
347
348               <varlistentry>
349                 <term><option>--lax</option></term>
350
351                 <listitem>
352                   <para>Allow encoder to generate non-Subset
353                     files.</para>
354                 </listitem>
355               </varlistentry>
356
357               <varlistentry>
358                 <term><option>--replay-gain</option></term>
359
360                 <listitem>
361                   <para>Calculate ReplayGain values and store in
362                     Vorbis comments, similar to vorbisgain.  Title
363                     gains/peaks will be computed for each input
364                     file, and an album gain/peak will be computed
365                     for all files.  All input files must have the
366                     same resolution, sample rate, and number of
367                     channels.  Only mono and stereo files are
368                     allowed, and the sample rate must be one of
369                     8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48
370                     kHz.  Also note that this option may leave a
371                     few extra bytes in a PADDING block as the exact
372                     size of the tags is not known until all files
373                     are processed.  Note that this option cannot be
374                     used when encoding to standard output (stdout).
375                     </para>
376                 </listitem>
377               </varlistentry>
378
379               <varlistentry>
380                 <term><option>--cuesheet</option>=<replaceable>filename</replaceable></term>
381
382                 <listitem>
383                   <para>Import the given cuesheet file and store it in a
384                     CUESHEET metadata block.  This option may only be used
385                     when encoding a single file.  A seekpoint will be added
386                     for each index point in the cuesheet to the SEEKTABLE
387                     unless --no-cued-seekpoints is specified.</para>
388                 </listitem>
389               </varlistentry>
390
391               <varlistentry>
392                 <term><option>--sector-align</option></term>
393
394                 <listitem>
395                   <para>Align encoding of multiple CD format WAVE
396                     files on sector boundaries.  See the HTML
397                     documentation for more information.</para>
398                 </listitem>
399               </varlistentry>
400
401               <varlistentry>
402                 <term><option>-S</option> {<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>|<replaceable>#s</replaceable>}, <option>--seekpoint</option>={<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>|<replaceable>#s</replaceable>}</term>
403
404                 <listitem>
405                   <para>
406                     Include a point or points in a SEEKTABLE.  Using #,
407                     a seek point at that sample number is added.  Using
408                     X, a placeholder point is added at the end of a the
409                     table.  Using #x, # evenly spaced seek points will
410                     be added, the first being at sample 0.  Using #s, a
411                     seekpoint will be added every # seconds (# does not
412                     have to be a whole number; it can be, for example, 9.5,
413                     meaning a seekpoint every 9.5 seconds).  You may use
414                     many -S options; the resulting SEEKTABLE will be the
415                     unique-ified union of all such values.  With no -S
416                     options, flac defaults to '-S 10s'.  Use --no-seektable
417                     for no SEEKTABLE.  Note: '-S #x' and '-S #s' will not
418                     work if the encoder can't determine the input size before
419                     starting.  Note: if you use '-S #' and # is >=
420                     samples in the input, there will be either no seek
421                     point entered (if the input size is determinable
422                     before encoding starts) or a placeholder point (if
423                     input size is not determinable).</para>
424                 </listitem>
425               </varlistentry>
426
427               <varlistentry>
428                 <term><option>-P</option> <replaceable>#</replaceable>, <option>--padding</option>=<replaceable>#</replaceable></term>
429
430                 <listitem>
431                   <para>Tell the encoder to write a PADDING metadata
432                     block of the given length (in bytes) after the
433                     STREAMINFO block.  This is useful if you plan to
434                     tag the file later with an APPLICATION block;
435                     instead of having to rewrite the entire file later
436                     just to insert your block, you can write directly
437                     over the PADDING block.  Note that the total length
438                     of the PADDING block will be 4 bytes longer than
439                     the length given because of the 4 metadata block
440                     header bytes.  You can force no PADDING block at
441                     all to be written with --no-padding.  The encoder
442                     writes a PADDING block of 4096 bytes by default.
443                     </para>
444                 </listitem>
445               </varlistentry>
446
447               <varlistentry>
448                 <term><option>-T</option> <replaceable>FIELD=VALUE</replaceable>, <option>--tag</option>=<replaceable>FIELD=VALUE</replaceable></term>
449
450                 <listitem>
451                   <para>Add a Vorbis comment.  The comment must adhere
452                     to the Vorbis comment spec; i.e. the FIELD must
453                     contain only legal characters, terminated by an
454                     'equals' sign.  Make sure to quote the comment if
455                     necessary.  This option may appear more than once
456                     to add several comments.  NOTE: all tags will be
457                     added to all encoded files.</para>
458                 </listitem>
459               </varlistentry>
460
461               <varlistentry>
462                 <term><option>-b</option> <replaceable>#</replaceable>, <option>--blocksize</option>=<replaceable>#</replaceable></term>
463
464                 <listitem>
465                   <para>Specify the block size in samples.  The
466                     default is 1152 for -l 0, else 4608; must be one of
467                     192, 576, 1152, 2304, 4608, 256, 512, 1024, 2048,
468                     4096, 8192, 16384, or 32768 (unless --lax is used)</para>
469                 </listitem>
470               </varlistentry>
471
472               <varlistentry>
473                 <term><option>-m</option>, <option>--mid-side</option></term>
474
475                 <listitem>
476                   <para>Try mid-side coding for each frame (stereo
477                     input only)</para>
478                 </listitem>
479               </varlistentry>
480
481               <varlistentry>
482                 <term><option>-M</option>, <option>--adaptive-mid-side</option></term>
483
484                 <listitem>
485                   <para>Adaptive mid-side coding for all frames (stereo
486                     input only)</para>
487                 </listitem>
488               </varlistentry>
489
490               <varlistentry>
491                 <term><option>-0</option>..<option>-8</option>, <option>--compression-level-0</option>..<option>--compression-level-8</option></term>
492
493                 <listitem>
494                   <para>Fastest compression..highest compression
495                     (default is -5).  These are synonyms for other
496                     options:</para>
497
498                   <variablelist>
499                     <varlistentry>
500                       <term><option>-0</option>, <option>--compression-level-0</option></term>
501
502                       <listitem>
503                         <para>Synonymous with -l 0 -b 1152 -r 2,2
504                           </para>
505                       </listitem>
506                     </varlistentry>
507
508                     <varlistentry>
509                       <term><option>-1</option>, <option>--compression-level-1</option></term>
510
511                       <listitem>
512                         <para>Synonymous with -l 0 -b 1152 -M -r 2,2
513                           </para>
514                       </listitem>
515                     </varlistentry>
516
517                     <varlistentry>
518                       <term><option>-2</option>, <option>--compression-level-2</option></term>
519
520                       <listitem>
521                         <para>Synonymous with -l 0 -b 1152 -m -r 3
522                           </para>
523                       </listitem>
524                     </varlistentry>
525
526                     <varlistentry>
527                       <term><option>-3</option>, <option>--compression-level-3</option></term>
528
529                       <listitem>
530                         <para>Synonymous with -l 6 -b 4608 -r 3,3
531                           </para>
532                       </listitem>
533                     </varlistentry>
534
535                     <varlistentry>
536                       <term><option>-4</option>, <option>--compression-level-4</option></term>
537
538                       <listitem>
539                         <para>Synonymous with -l 8 -b 4608 -M -r 3,3
540                           </para>
541                       </listitem>
542                     </varlistentry>
543
544                     <varlistentry>
545                       <term><option>-5</option>, <option>--compression-level-5</option></term>
546
547                       <listitem>
548                         <para>Synonymous with -l 8 -b 4608 -m -r 3,3
549                           </para>
550                       </listitem>
551                     </varlistentry>
552
553                     <varlistentry>
554                       <term><option>-6</option>, <option>--compression-level-6</option></term>
555
556                       <listitem>
557                         <para>Synonymous with -l 8 -b 4608 -m -r 4
558                           </para>
559                       </listitem>
560                     </varlistentry>
561
562                     <varlistentry>
563                       <term><option>-7</option>, <option>--compression-level-7</option></term>
564
565                       <listitem>
566                         <para>Synonymous with -l 8 -b 4608 -m -e -r 6
567                           </para>
568                       </listitem>
569                     </varlistentry>
570
571                     <varlistentry>
572                       <term><option>-8</option>, <option>--compression-level-8</option></term>
573
574                       <listitem>
575                         <para>Synonymous with -l 12 -b 4608 -m -e -r 6
576                           </para>
577                       </listitem>
578                     </varlistentry>
579                   </variablelist>
580
581                 </listitem>
582
583               </varlistentry>
584
585               <varlistentry>
586                 <term><option>--fast</option></term>
587
588                 <listitem>
589                   <para>Fastest compression.  Currently
590                     synonymous with -0.</para>
591                 </listitem>
592               </varlistentry>
593
594               <varlistentry>
595                 <term><option>--best</option></term>
596
597                 <listitem>
598                   <para>Highest compression.  Currently
599                     synonymous with -8.</para>
600                 </listitem>
601               </varlistentry>
602
603               <varlistentry>
604                 <term><option>-e</option>, <option>--exhaustive-model-search</option></term>
605
606                 <listitem>
607                   <para>Do exhaustive model search
608                     (expensive!)</para>
609                 </listitem>
610               </varlistentry>
611
612               <varlistentry>
613                 <term><option>-l</option> <replaceable>#</replaceable>, <option>--max-lpc-order</option>=<replaceable>#</replaceable></term>
614
615                 <listitem>
616                   <para>Set the maximum LPC order; 0 means use only the fixed predictors</para>
617                 </listitem>
618               </varlistentry>
619
620               <varlistentry>
621                 <term><option>-p</option>, <option>--qlp-coeff-precision-search</option></term>
622
623                 <listitem>
624                   <para>Do exhaustive search of LP coefficient
625                     quantization (expensive!).  Overrides -q;
626                     does nothing if using -l 0</para>
627                 </listitem>
628               </varlistentry>
629
630               <varlistentry>
631                 <term><option>-q</option> <replaceable>#</replaceable>, <option>--qlp-coeff-precision</option>=<replaceable>#</replaceable></term>
632
633                 <listitem>
634                   <para>Precision of the quantized linear-predictor
635                     coefficients, 0 => let encoder decide (min is 5,
636                     default is 0)</para>
637                 </listitem>
638               </varlistentry>
639
640               <varlistentry>
641                 <term><option>-r</option> [<replaceable>#</replaceable>,]<replaceable>#</replaceable>, <option>--rice-partition-order</option>=[<replaceable>#</replaceable>,]<replaceable>#</replaceable></term>
642
643                 <listitem>
644                   <para>Set the [min,]max residual partition order
645                     (0..16). min defaults to 0 if unspecified.  Default
646                     is -r 3,3.</para>
647                 </listitem>
648               </varlistentry>
649
650             </variablelist>
651
652           </refsect2>
653           <refsect2>
654             <title>Format Options</title>
655
656             <variablelist>
657               <varlistentry>
658                 <term><option>--endian</option>={<replaceable>big</replaceable>|<replaceable>little</replaceable>}</term>
659
660                 <listitem>
661                   <para>Set the byte order for samples</para>
662                 </listitem>
663               </varlistentry>
664
665               <varlistentry>
666                 <term><option>--channels</option>=<replaceable>#</replaceable></term>
667
668                 <listitem>
669                   <para>Set number of channels.</para>
670                 </listitem>
671               </varlistentry>
672
673               <varlistentry>
674                 <term><option>--bps</option>=<replaceable>#</replaceable></term>
675
676                 <listitem>
677                   <para>Set bits per sample.</para>
678                 </listitem>
679               </varlistentry>
680
681               <varlistentry>
682                 <term><option>--sample-rate</option>=<replaceable>#</replaceable></term>
683
684                 <listitem>
685                   <para>Set sample rate (in Hz).</para>
686                 </listitem>
687               </varlistentry>
688
689               <varlistentry>
690                 <term><option>--sign</option>={<replaceable>signed</replaceable>|<replaceable>unsigned</replaceable>}</term>
691
692                 <listitem>
693                   <para>Set the sign of samples (the default is signed).</para>
694                 </listitem>
695               </varlistentry>
696
697               <varlistentry>
698                 <term><option>--input-size</option>=<replaceable>#</replaceable></term>
699
700                 <listitem>
701                   <para>Specify the size of the raw input in bytes.  If you are
702                     encoding raw samples from stdin, you must set this option
703                     in order to be able to use --skip, --until, --cue-sheet, or
704                     other options that need to know the size of the input
705                     beforehand.  If the size given is greater than what is
706                     found in the input stream, the encoder will complain about
707                     an unexpected end-of-file.  If the size given is less,
708                     samples will be truncated.</para>
709                 </listitem>
710               </varlistentry>
711
712               <varlistentry>
713                 <term><option>--force-aiff-format</option></term>
714
715                 <listitem>
716                   <para>Force the decoder to output AIFF format.  This option
717                     is not needed if the output filename (as set by -o) ends
718                     with <filename>.aiff</filename>.  Also, this option has no
719                     effect when encoding since input AIFF is auto-detected.</para>
720                 </listitem>
721               </varlistentry>
722
723               <varlistentry>
724                 <term><option>--force-raw-format</option></term>
725
726                 <listitem>
727                   <para>Force input (when encoding) or output (when decoding)
728                     to be treated as raw samples (even if filename ends
729                     in <filename>.wav</filename>).</para>
730                 </listitem>
731               </varlistentry>
732
733             </variablelist>
734           </refsect2>
735
736           <refsect2>
737             <title>Negative Options</title>
738
739             <variablelist>
740               <varlistentry>
741                 <term><option>--no-adaptive-mid-side</option></term>
742                 <term><option>--no-decode-through-errors</option></term>
743                 <term><option>--no-delete-input-file</option></term>
744                 <term><option>--no-exhaustive-model-search</option></term>
745                 <term><option>--no-lax</option></term>
746                 <term><option>--no-mid-side</option></term>
747                 <term><option>--no-ogg</option></term>
748                 <term><option>--no-padding</option></term>
749                 <term><option>--no-qlp-coeff-precision-search</option></term>
750                 <term><option>--no-residual-gnuplot</option></term>
751                 <term><option>--no-residual-text</option></term>
752                 <term><option>--no-sector-align</option></term>
753                 <term><option>--no-seektable</option></term>
754                 <term><option>--no-silent</option></term>
755                 <term><option>--no-verify</option></term>
756                 <listitem>
757                   <para>These flags can be used to invert the sense
758                     of the corresponding normal option.</para>
759                 </listitem>
760               </varlistentry>
761             </variablelist>
762
763           </refsect2>
764
765         </refsect1>
766           <refsect1>
767             <title>SEE ALSO</title>
768
769             <para>metaflac(1).</para>
770
771             <para>The programs are documented fully by HTML format
772               documentation, available in
773               <filename>/usr/share/doc/flac/html</filename> on
774                 &debian; systems.</para>
775           </refsect1>
776           <refsect1>
777             <title>AUTHOR</title>
778
779             <para>This manual page was written by &dhusername; &dhemail; for
780               the &debian; system (but may be used by others).</para>
781
782             <!-- <para>Permission is granted to copy, distribute and/or modify
783             this document under the terms of the <acronym>GNU</acronym> Free
784             Documentation License, Version 1.1 or any later version
785             published by the Free Software Foundation; with no Invariant
786             Sections, no Front-Cover Texts and no Back-Cover Texts.  A copy
787             of the license can be found under
788           <filename>/usr/share/common-licenses/FDL</filename>.</para> -->
789
790         </refsect1>
791       </refentry>
792
793         <!-- Keep this comment at the end of the file
794               Local variables:
795               mode: sgml
796               sgml-omittag:t
797               sgml-shorttag:t
798               sgml-minimize-attributes:nil
799               sgml-always-quote-attributes:t
800               sgml-indent-step:2
801               sgml-indent-data:t
802               sgml-parent-document:nil
803               sgml-default-dtd-file:nil
804               sgml-exposed-tags:nil
805               sgml-local-catalogs:nil
806               sgml-local-ecat-files:nil
807               End:
808               -->