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