add anchors for each option, add commented out docs for --apply-replaygain-which...
authorJosh Coalson <jcoalson@users.sourceforce.net>
Fri, 23 Jul 2004 05:07:36 +0000 (05:07 +0000)
committerJosh Coalson <jcoalson@users.sourceforce.net>
Fri, 23 Jul 2004 05:07:36 +0000 (05:07 +0000)
doc/html/documentation.html

index db3e251..f536d65 100644 (file)
                                <A NAME="general_options"><FONT SIZE="+1"><B>General Options</B></FONT></A>
                        </TD>
                </TR>
+               <A NAME="flac_options_version">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-v</TT>, <TT>--version</TT>
                                Show the <B><TT>flac</TT></B> version number.
                        </TD>
                </TR>
+               <A NAME="flac_options_help">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-h</TT>, <TT>--help</TT>
                                Show basic usage and a list of all options.  Running <B><TT>flac</TT></B> without arguments shows the short help screen by default.
                        </TD>
                </TR>
+               <A NAME="flac_options_explain">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-H</TT>, <TT>--explain</TT>
                                Show detailed explanation of usage and all options.  Running <B><TT>flac</TT></B> without arguments shows the short help screen by default.
                        </TD>
                </TR>
+               <A NAME="flac_options_decode">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-d</TT>, <TT>--decode</TT>
                                Decode (<B><TT>flac</TT></B> encodes by default).  <B><TT>flac</TT></B> will exit with an exit code of <TT>1</TT> (and print a message, even in silent mode) if there were any errors during decoding, including when the MD5 checksum does not match the decoded output.  Otherwise the exit code will be <TT>0</TT>.
                        </TD>
                </TR>
+               <A NAME="flac_options_test">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-t</TT>, <TT>--test</TT>
                                Test (same as <B><TT>-d</TT></B> except no decoded file is written).  The exit codes are the same as in decode mode.
                        </TD>
                </TR>
+               <A NAME="flac_options_analyze">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-a</TT>, <TT>--analyze</TT>
                                Analyze (same as <B><TT>-d</TT></B> except an analysis file is written).  The exit codes are the same as in decode mode.  This option is mainly for developers; the output will be a text file that has data about each frame and subframe.
                        </TD>
                </TR>
+               <A NAME="flac_options_stdout">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-c</TT>, <TT>--stdout</TT>
                                Write output to stdout.
                        </TD>
                </TR>
+               <A NAME="flac_options_silent">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-s</TT>, <TT>--silent</TT>
                                Silent: do not show encoding/decoding statistics.
                        </TD>
                </TR>
+               <A NAME="flac_options_totally_silent">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--totally-silent</TT>
                                Do not print anything of any kind, including warnings or errors.  The exit code will be the only way to determine successful completion.
                        </TD>
                </TR>
+               <A NAME="flac_options_force">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-f</TT>, <TT>--force</TT>
                                Force overwriting of output files.  By default, <TT><B>flac</B></TT> warns that the output file already exists and continues to the next file.
                        </TD>
                </TR>
+               <A NAME="flac_options_output_name">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-o filename</TT>,<BR><TT>--output-name=filename</TT>
                                Force the output file name (usually <TT><B>flac</B></TT> just changes the extension).  May only be used when encoding a single file.  May not be used in conjunction with <TT>--output-prefix</T>.
                        </TD>
                </TR>
+               <A NAME="flac_options_output_prefix">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--output-prefix=string</TT>
                                Prefix each output file name with the given string.  This can be useful for encoding/decoding files to a different directory.  Make sure if your string is a path name that it ends with a trailing '<TT>/</TT>' slash.
                        </TD>
                </TR>
+               <A NAME="flac_options_delete_input_file">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--delete-input-file</TT>
                                Automatically delete the input file after a successful encode or decode.  If there was an error (including a verify error) the input file is left intact.
                        </TD>
                </TR>
+               <A NAME="flac_options_skip">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--skip={#|mm:ss.ss}</TT>
                                <TT>--skip=1:23.45</TT> : skip the first 1 minute and 23.45 seconds of the input
                        </TD>
                </TR>
+               <A NAME="flac_options_until">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--until={#|[+|-]mm:ss.ss}</TT>
                                <TT>--until=-0:00</TT> : decode until the end of the input (the same as not specifying <TT>--until</TT>)
                        </TD>
                </TR>
+               <A NAME="flac_options_ogg">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--ogg</TT>
                                When decoding, force the input to be treated as Ogg-FLAC.  This is useful when piping input from stdin or when the filename does not end in '.ogg'.
                        </TD>
                </TR>
+               <A NAME="flac_options_serial_number">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--serial-number=#</TT>
                                <A NAME="analysis_options"><FONT SIZE="+1"><B>Analysis Options</B></FONT></A>
                        </TD>
                </TR>
+               <A NAME="flac_options_residual_text">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--residual-text</TT>
                                Includes the residual signal in the analysis file.  This will make the file <B>very</B> big, much larger than even the decoded file.
                        </TD>
                </TR>
+               <A NAME="flac_options_residual_gnuplot">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--residual-gnuplot</TT>
                                <A NAME="decoding_options"><FONT SIZE="+1"><B>Decoding Options</B></FONT></A>
                        </TD>
                </TR>
+               <A NAME="flac_options_cue">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--cue=[#.#][-[#.#]]</TT>
                                <TT>--cue=2.1-2.4</TT> : decode from track 2, index 1, up to, but not including, track 2, index 4<P>
                        </TD>
                </TR>
+               <A NAME="flac_options_decode_through_errors">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-F</TT>,<BR><TT>--decode-through-errors</TT>
                                By default <B><TT>flac</TT></B> stops decoding with an error and removes the partially decoded file if it encounters a bitstream error.  With <TT>-F</TT>, errors are still printed but <B><TT>flac</TT></B> will continue decoding to completion.  Note that errors may cause the decoded audio to be missing some samples or have silent sections.
                        </TD>
                </TR>
+               <!-- @@@ undocumented, also not in the man page yet
+               <A NAME="flac_options_apply_replaygain_which_is_not_lossless">
+               <TR>
+                       <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
+                               <TT>--apply-replaygain_which_is_not_lossless[=&lt;specification&gt;]</TT>
+                       </TD>
+                       <TD>
+                               Applies ReplayGain values while decoding.
+                               <P>
+                               <B>WARNING: THIS IS NOT LOSSLESS.  DECODED AUDIO WILL NOT BE IDENTICAL TO THE ORIGINAL WITH THIS OPTION</B>.
+                               <P>
+                               The equals sign and &lt;specification&gt; is optional.  If omitted, the default is <TT>0aLn1</TT>.
+                               <P>
+                               The <TT>&lt;specification&gt;</TT> is a shorthand notation for describing how to apply ReplayGain.  All components are optional but order is important.  '<TT>[]</TT>' means 'optional'.  '<TT>|</TT>' means 'or'.  '<TT>{}</TT>' means required.  The format is:<P>
+                               &nbsp;&nbsp;<TT>[&lt;preamp&gt;][a|t][l|L][n{0|1|2|3}]</TT>
+                               <P>
+                               <UL>
+                                       <LI>
+                                               <TT>&lt;preamp&gt;</TT><P>
+                                                       &nbsp;&nbsp;A floating point number in dB.  This is added to the existing gain value.
+                                       </LI>
+                                       <LI>
+                                               <TT>a|t</TT><P>
+                                                       &nbsp;&nbsp;Specify '<TT>a</TT>' to use the album gain, or '<TT>t</TT>' to use the track gain
+                                       </LI>
+                                       <LI>
+                                               <TT>l|L</TT><P>
+                                                       &nbsp;&nbsp;Specify '<TT>l</TT>' to peak-limit the output, so that the ReplayGain peak value is full-scale.  Specify '<TT>L</TT>' to use a 6dB hard limiter that kicks in when the signal approaches full-scale.
+                                       </LI>
+                                       <LI>
+                                               <TT>n{0|1|2|3}</TT><P>
+                                                       &nbsp;&nbsp;Specify the amount of noise shaping.  ReplayGain synthesis happens in floating point; the result is dithered before converting back to integer.  This quantization adds noise.  Noise shaping tries to move the noise where you won't hear it as much.  <TT>0</TT> means no noise shaping, <TT>1</TT> means 'low', <TT>2</TT> means 'medium', <TT>3</TT> means 'high'.
+                                       </LI>
+                               </UL>
+                               <P>
+                               For example, the default of <TT>0aLn1</TT> means 0dB preamp, use album gain, 6dB hard limit, low noise shaping.
+                               <P>
+                               <TT>--apply-replaygain-which-is-not-lossless=3</TT> means 3dB preamp, use album gain, no limiting, no noise shaping.
+                               <P>
+                               <B><TT>flac</B></TT> uses the ReplayGain tags for the calculation.  If a stream does not have the required tags or they can't be parsed, decoding will continue with a warning, and no ReplayGain is applied to that stream.
+                       </TD>
+               </TR>
+               -->
        </TABLE>
        </TD></TR></TABLE>
        </P>
                                <A NAME="encoding_options"><FONT SIZE="+1"><B>Encoding Options</B></FONT></A>
                        </TD>
                </TR>
+               <A NAME="flac_options_verify">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-V</TT>, <TT>--verify</TT>
                                Verify the encoding process.  With this option, <B><TT>flac</TT></B> will create a parallel decoder that decodes the output of the encoder and compares the result against the original.  It will abort immediately with an error if a mismatch occurs.  <B><TT>-V</TT></B> increases the total encoding time but is guaranteed to catch any unforseen bug in the encoding process.
                        </TD>
                </TR>
+               <A NAME="flac_options_lax">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--lax</TT>
                                Allow encoder to generate non-<A HREF="format.html#subset">Subset</A> files.  The resulting FLAC file may not be streamable, so you should only use this option in combination with custom encoding options meant for archival.  File decoders will still be able play (and seek in) such files.
                        </TD>
                </TR>
+               <A NAME="flac_options_replay_gain">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--replay-gain</TT>
                                Note that this option cannot be used when encoding to standard output (stdout).
                        </TD>
                </TR>
+               <A NAME="flac_options_cuesheet">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--cuesheet=FILENAME</TT>
                                The cuesheet file must be of the sort written by <A HREF="http://www.goldenhawk.com/cdrwin.htm">CDRwin</A>, <A HREF="http://www.dcsoft.com/prod03.htm">CDRcue</A>, <A HREF="http://www.exactaudiocopy.de/">EAC</A>, et al.
                        </TD>
                </TR>
+               <A NAME="flac_options_sector_align">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--sector-align</TT>
                                <B>WARNING:</B> The ordering of files is important!  If you give a command like '<TT>flac --sector-align *.wav</TT>' the shell may not expand the wildcard to the order you expect.  To be safe you should '<TT>echo *.wav</TT>' first to confirm the order, or be explicit like '<TT>flac --sector-align 8.wav 9.wav 10.wav</TT>'.
                        </TD>
                </TR>
+               <A NAME="flac_options_seekpoint">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-S {#|X|#x|#s}</TT>,<BR><TT>--seekpoint={#|X|#x|#s}</TT>
                                <B>NOTE:</B> if you use -S # and # is &gt;= samples in the input, there will be either no seek point entered (if the input size is determinable before encoding starts) or a placeholder point (if input size is not determinable).<BR>
                        </TD>
                </TR>
+               <A NAME="flac_options_padding">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-P #</TT>, <TT>--padding=#</TT>
                                Tell the encoder to write a <TT>PADDING</TT> metadata block of the given length (in bytes) after the <TT>STREAMINFO</TT> block.  This is useful if you plan to tag the file later with an <TT>APPLICATION</TT> block; instead of having to rewrite the entire file later just to insert your block, you can write directly over the <TT>PADDING</TT> block.  Note that the total length of the <TT>PADDING</TT> block will be 4 bytes longer than the length given because of the 4 metadata block header bytes.  You can force no <TT>PADDING</TT> block at all to be written with <TT>--no-padding</TT>.  The encoder writes a PADDING block of 4096 bytes by default.
                        </TD>
                </TR>
+               <A NAME="flac_options_tag">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-T FIELD=VALUE</TT>, <TT>--tag=FIELD=VALUE</TT>
                                Add a Vorbis comment.  The comment must adhere to the Vorbis comment spec; i.e. the FIELD must contain only legal characters, terminated by an 'equals' sign.  Make sure to quote the comment if necessary.  This option may appear more than once to add several comments.  NOTE: all tags will be added to all encoded files.
                        </TD>
                </TR>
+               <A NAME="flac_options_blocksize">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-b #</TT>, <TT>--blocksize=#</TT>
                                Specify the block size in samples.  The default is 1152 for -l 0, otherwise 4608.  Subset streams must use one of 192/576/1152/2304/4608/256/512/1024/2048/4096/8192/16384/32768.  The reference encoder uses the same block size for the entire stream.
                        </TD>
                </TR>
+               <A NAME="flac_options_mid_side">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-m</TT>, <TT>--mid-side</TT>
                                Enable mid-side coding (only for stereo streams).  Tends to increase compression by a few percent on average.  For each block both the stereo pair and mid-side versions of the block will be encoded, and smallest resulting frame will be stored.  Currently mid-side encoding is only available when bits-per-sample &lt;= 16.
                        </TD>
                </TR>
+               <A NAME="flac_options_adaptive_mid_side">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-M</TT>, <TT>--adaptive-mid-side</TT>
                                Enable adaptive mid-side coding (only for stereo streams).  Like <TT>-m</TT> but the encoder adaptively switches between independent and mid-side coding, which is faster but yields less compression than <TT>-m</TT> (which does an exhaustive search).
                        </TD>
                </TR>
+               <A NAME="flac_options_levels">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-0 .. -8</TT>
                                Fastest compression .. highest compression.  The default is <TT>-5</TT>.
                        </TD>
                </TR>
+               <A NAME="flac_options_level_0">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-0</TT>, <TT>--compression-level-0</TT>
                                Synonymous with <TT>-l 0 -b 1152 -r 2,2</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_level_1">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-1</TT>, <TT>--compression-level-1</TT>
                                Synonymous with <TT>-l 0 -b 1152 -M -r 2,2</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_level_2">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-2</TT>, <TT>--compression-level-2</TT>
                                Synonymous with <TT>-l 0 -b 1152 -m -r 3</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_level_3">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-3</TT>, <TT>--compression-level-3</TT>
                                Synonymous with <TT>-l 6 -b 4608 -r 3,3</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_level_4">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-4</TT>, <TT>--compression-level-4</TT>
                                Synonymous with <TT>-l 8 -b 4608 -M -r 3,3</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_level_5">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-5</TT>, <TT>--compression-level-5</TT>
                                Synonymous with <TT>-l 8 -b 4608 -m -r 3,3</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_level_6">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-6</TT>, <TT>--compression-level-6</TT>
                                Synonymous with <TT>-l 8 -b 4608 -m -r 4</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_level_7">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-7</TT>, <TT>--compression-level-7</TT>
                                Synonymous with <TT>-l 8 -b 4608 -m -e -r 6</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_level_8">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-8</TT>, <TT>--compression-level-8</TT>
                                Synonymous with <TT>-l 12 -b 4608 -m -e -r 6</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_fast">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--fast</TT>
                                Fastest compression.  Currently synonymous with <TT>-0</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_best">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--best</TT>
                                Highest compression.  Currently synonymous with <TT>-8</TT>
                        </TD>
                </TR>
+               <A NAME="flac_options_exhaustive_model_search">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-e</TT>,<BR><TT>--exhaustive-model-search</TT>
                                Exhaustive model search (expensive!).  Normally the encoder estimates the best model to use and encodes once based on the estimate.  With an exhaustive model search, the encoder will generate subframes for every order and use the smallest.  If the max LPC order is high this can significantly increase the encode time but can shave off another 0.5%.
                        </TD>
                </TR>
+               <A NAME="flac_options_max_lpc_order">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-l #</TT>, <TT>--max-lpc-order=#</TT>
                                Specifies the maximum LPC order.  This number must be &lt;= 32.  If 0, the encoder will not attempt generic linear prediction, and use only fixed predictors.  Using fixed predictors is faster but usually results in files being 5-10% larger.
                        </TD>
                </TR>
+               <A NAME="flac_options_qlp_coeff_precision">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-q #</TT>,<BR><TT>--qlp-coeff-precision=#</TT>
                                Specifies the precision of the quantized LP coefficients, in bits.  The default is <B><TT>-q 0</TT></B>, which means let the encoder decide based on the signal.  Unless you really know your input file it's best to leave this up to the encoder.
                        </TD>
                </TR>
+               <A NAME="flac_options_qlp_coeff_precision_search">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-p</TT>,<BR><TT>--qlp-coeff-precision-search</TT>
                                Do exhaustive LP coefficient quantization optimization.  This option overrides any <B><TT>-q</TT></B> option.  It is expensive and typically will only improve the compression a tiny fraction of a percent.  <B><TT>-q</TT></B> has no effect when <B><TT>-l 0</TT></B> is used.
                        </TD>
                </TR>
+               <A NAME="flac_options_rice_partition_order">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>-r [#,]#</TT>,<BR><TT>--rice-partition-order=[#,]#</TT>
                                <A NAME="format_options"><FONT SIZE="+1"><B>Format Options</B></FONT></A>
                        </TD>
                </TR>
+               <A NAME="flac_options_endian">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--endian={big|little}</TT>
                                Specify big-endian or little-endian byte order in the raw file.
                        </TD>
                </TR>
+               <A NAME="flac_options_channels">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--channels=#</TT>
                                Specify the number of channels in the raw file.
                        </TD>
                </TR>
+               <A NAME="flac_options_bps">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--bps=#</TT>
                                Specify the number of bits per sample in the raw file.
                        </TD>
                </TR>
+               <A NAME="flac_options_sample_rate">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--sample-rate=#</TT>
                                Specify the sample rate of the raw file.
                        </TD>
                </TR>
+               <A NAME="flac_options_sign">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--sign={signed|unsigned}</TT>
                                Specify that the samples in the raw file are signed or unsigned (the default is signed).
                        </TD>
                </TR>
+               <A NAME="flac_options_force_aiff_format">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--force-aiff-format</TT>
                                Force the decoder to output AIFF format.  This option is not needed if the output filename (as set by -o) ends with .aiff.  Also, this option has no effect when encoding since input AIFF is auto-detected.
                        </TD>
                </TR>
+               <A NAME="flac_options_force_raw_format">
                <TR>
                        <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
                                <TT>--force-raw-format</TT>
        <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
                <TR>
                        <TD COLSPAN="2" BGCOLOR="#D3D4C5">
-                               <A NAME="format_options"><FONT SIZE="+1"><B>Negative Options</B></FONT></A>
+                               <A NAME="negative_options"><FONT SIZE="+1"><B>Negative Options</B></FONT></A>
                        </TD>
                </TR>
                <TR>