claunia/flac
1
0
Fork 0
mirror of https://github.com/claunia/flac.git synced 2025-12-16 18:54:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

update to match new getopt-based options in flac

Browse Source
This commit is contained in:
Josh Coalson
2002-08-13 21:18:27 +00:00
parent bf3713ab12
commit e6eff867de
2 changed files with 208 additions and 160 deletions
Download Patch File Download Diff File Expand all files Collapse all files

167
man/flac.1
View File

@@ -3,7 +3,7 @@
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches, .\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>. .\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "FLAC" "1" "02 July 2002" "" "" .TH "FLAC" "1" "13 August 2002" "" ""
.SH NAME .SH NAME
flac \- Free Lossless Audio Codec flac \- Free Lossless Audio Codec
.SH SYNOPSIS .SH SYNOPSIS
@@ -25,37 +25,39 @@ A summary of options is included below. For a complete
description, see the HTML documentation. description, see the HTML documentation.
.SS "GENERIC OPTIONS" .SS "GENERIC OPTIONS"
.TP .TP
\fB-H \fR \fB-h, --help \fR
Show detailed help screen Show basic usage and a list of all options
.TP .TP
\fB-d \fR \fB-H, --explain \fR
Decode (default behavior is encode) Show detailed explanation of usage and all options
.TP .TP
\fB-c \fR \fB-d, --decode \fR
Encode from standard input, or decode to Decode (the default behavior is to encode)
standard output
.TP .TP
\fB-t \fR \fB-t, --test \fR
Test a flac encoded file (same as -d Test a flac encoded file (same as -d
except no decoded file is written) except no decoded file is written)
.TP .TP
\fB-a \fR \fB-a, --analyze \fR
Analyze a flac encoded file (same as -d Analyze a flac encoded file (same as -d
except an analysis file is written) except an analysis file is written)
.TP .TP
\fB-s \fR \fB-c, --stdout \fR
Silent mode (do not write runtime Write output to stdout
encode/decode statistics to stdout)
.TP .TP
\fB-o \fIfilename\fB\fR \fB-s, --silent \fR
Silent mode (do not write runtime
encode/decode statistics to stderr)
.TP
\fB-o \fIfilename\fB, --output-name=\fIfilename\fB\fR
Force the output file name (usually flac just Force the output file name (usually flac just
changes the extension). May only be used when changes the extension). May only be used when
encoding a single file. May not be used in encoding a single file. May not be used in
conjunction with --output-prefix. conjunction with --output-prefix.
.TP .TP
\fB--output-prefix \fIstring\fB\fR \fB--output-prefix=\fIstring\fB\fR
Prefix each output file name with the given Prefix each output file name with the given
string. This can be useful for encoding/decoding string. This can be useful for encoding or decoding
files to a different directory. Make sure if your files to a different directory. Make sure if your
string is a path name that it ends with a trailing string is a path name that it ends with a trailing
`/' (slash). `/' (slash).
@@ -66,25 +68,25 @@ successful encode or decode. If there was an
error (including a verify error) the input file error (including a verify error) the input file
is left intact. is left intact.
.TP .TP
\fB--skip \fIsamples\fB\fR \fB--skip=\fI#\fB\fR
Skip the specified number of samples at the Skip the specified number of samples at the
beginning of the input file (can be used for both beginning of the input file (can be used for both
encoding and decoding) encoding and decoding)
.SS "ANALYSIS OPTIONS" .SS "ANALYSIS OPTIONS"
.TP .TP
\fB--a-rtext \fR \fB--residual-text \fR
Includes the residual signal in the analysis Includes the residual signal in the analysis
file. This will make the file very big, much file. This will make the file very big, much
larger than even the decoded file. larger than even the decoded file.
.TP .TP
\fB--a-rgp \fR \fB--residual-gnuplot \fR
Generates a gnuplot file for every subframe; Generates a gnuplot file for every subframe;
each file will contain the residual distribution each file will contain the residual distribution
of the subframe. This will create a lot of of the subframe. This will create a lot of
files. files.
.SS "DECODING OPTIONS" .SS "DECODING OPTIONS"
.TP .TP
\fB-F \fR \fB-F, --decode-through-errors \fR
By default flac stops decoding with an error By default flac stops decoding with an error
and removes the partially decoded file if it and removes the partially decoded file if it
encounters a bitstream error. With -F, errors are encounters a bitstream error. With -F, errors are
@@ -94,6 +96,11 @@ audio to be missing some samples or have silent
sections. sections.
.SS "ENCODING OPTIONS" .SS "ENCODING OPTIONS"
.TP .TP
\fB-V, --verify\fR
Verify a correct encoding by decoding the
output in parallel and comparing to the
original
.TP
\fB--ogg\fR \fB--ogg\fR
When encoding, generate Ogg-FLAC output instead When encoding, generate Ogg-FLAC output instead
of native-FLAC. Ogg-FLAC streams are FLAC streams of native-FLAC. Ogg-FLAC streams are FLAC streams
@@ -114,7 +121,7 @@ Align encoding of multiple CD format WAVE
files on sector boundaries. See the HTML files on sector boundaries. See the HTML
documentation for more information. documentation for more information.
.TP .TP
\fB-S \fI{ # | X | #x }\fB\fR \fB-S {\fI#\fB|\fIX\fB|\fI#x\fB}, --seekpoint={\fI#\fB|\fIX\fB|\fI#x\fB}\fR
Include a point or points in a SEEKTABLE. Using #, Include a point or points in a SEEKTABLE. Using #,
a seek point at that sample number is added. Using a seek point at that sample number is added. Using
X, a placeholder point is added at the end of a the X, a placeholder point is added at the end of a the
@@ -131,7 +138,7 @@ point entered (if the input size is determinable
before encoding starts) or a placeholder point (if before encoding starts) or a placeholder point (if
input size is not determinable). input size is not determinable).
.TP .TP
\fB-P \fIbytes\fB\fR \fB-P \fI#\fB, --padding=\fI#\fB\fR
Tell the encoder to write a PADDING metadata Tell the encoder to write a PADDING metadata
block of the given length (in bytes) after the block of the given length (in bytes) after the
STREAMINFO block. This is useful if you plan to STREAMINFO block. This is useful if you plan to
@@ -144,50 +151,51 @@ the length given because of the 4 metadata block
header bytes. You can force no PADDING block at header bytes. You can force no PADDING block at
all to be written with -P-, which is the default. all to be written with -P-, which is the default.
.TP .TP
\fB-b \fIblocksize\fB\fR \fB-b \fI#\fB, --blocksize=\fI#\fB\fR
Default is 1152 for -l 0, else 4608; must be Specify the block size in samples. The
192/576/1152/2304/4608/256/512/1024/2048/4096/8192/16384/32768 default is 1152 for -l 0, else 4608; must be one of
(unless --lax is used) 192, 576, 1152, 2304, 4608, 256, 512, 1024, 2048,
4096, 8192, 16384, or 32768 (unless --lax is used)
.TP .TP
\fB-m\fR \fB-m, --mid-side\fR
Try mid-side coding for each frame (stereo Try mid-side coding for each frame (stereo
input only) input only)
.TP .TP
\fB-M\fR \fB-M, --adaptive-mid-side\fR
Loose mid-side coding for all frames (stereo Adaptive mid-side coding for all frames (stereo
input only) input only)
.TP .TP
\fB-0..-8\fR \fB-0..-8, --compression-level-0..--compression-level-8\fR
Fastest compression..highest compression Fastest compression..highest compression
(default is -5). These are synonyms for other (default is -5). These are synonyms for other
options: options:
.RS .RS
.TP .TP
\fB-0\fR \fB-0, --compression-level-0\fR
Synonymous with -l 0 -b 1152 -r 2,2 Synonymous with -l 0 -b 1152 -r 2,2
.TP .TP
\fB-1\fR \fB-1, --compression-level-1\fR
Synonymous with -l 0 -b 1152 -M -r 2,2 Synonymous with -l 0 -b 1152 -M -r 2,2
.TP .TP
\fB-2\fR \fB-2, --compression-level-2\fR
Synonymous with -l 0 -b 1152 -m -r 3 Synonymous with -l 0 -b 1152 -m -r 3
.TP .TP
\fB-3\fR \fB-3, --compression-level-3\fR
Synonymous with -l 6 -b 4608 -r 3,3 Synonymous with -l 6 -b 4608 -r 3,3
.TP .TP
\fB-4\fR \fB-4, --compression-level-4\fR
Synonymous with -l 8 -b 4608 -M -r 3,3 Synonymous with -l 8 -b 4608 -M -r 3,3
.TP .TP
\fB-5\fR \fB-5, --compression-level-5\fR
Synonymous with -l 8 -b 4608 -m -r 3,3 Synonymous with -l 8 -b 4608 -m -r 3,3
.TP .TP
\fB-6\fR \fB-6, --compression-level-6\fR
Synonymous with -l 8 -b 4608 -m -r 4 Synonymous with -l 8 -b 4608 -m -r 4
.TP .TP
\fB-7\fR \fB-7, --compression-level-7\fR
Synonymous with -l 8 -b 4608 -m -e -r 6 Synonymous with -l 8 -b 4608 -m -e -r 6
.TP .TP
\fB-8\fR \fB-8, --compression-level-8\fR
Synonymous with -l 12 -b 4608 -m -e -r 6 Synonymous with -l 12 -b 4608 -m -e -r 6
.RE .RE
.TP .TP
@@ -199,66 +207,89 @@ synonymous with -0.
Highest compression. Currently Highest compression. Currently
synonymous with -8. synonymous with -8.
.TP .TP
\fB-e\fR \fB-e, --exhaustive-model-search\fR
Do exhaustive model search Do exhaustive model search
(expensive!) (expensive!)
.TP .TP
\fB-E\fR \fB-E, --escape-coding\fR
Do escape coding in the entropy coder. This Do escape coding in the entropy coder. This
causes the encoder to use an unencoded representation causes the encoder to use an unencoded representation
of the residual in a partition if it is smaller. It of the residual in a partition if it is smaller. It
increases the runtime and usually results in an increases the runtime and usually results in an
improvement of less than 1%. improvement of less than 1%.
.TP .TP
\fB-l \fImax_lpc_order\fB\fR \fB-l \fI#\fB, --max-lpc-order=\fI#\fB\fR
0 => use only fixed predictors Set the maximum LPC order; 0 means use only the fixed predictors
.TP .TP
\fB-p\fR \fB-p, --qlp-coeff-precision-search\fR
Do exhaustive search of LP coefficient Do exhaustive search of LP coefficient
quantization (expensive!). Overrides -q, quantization (expensive!). Overrides -q;
does nothing if using -l 0 does nothing if using -l 0
.TP .TP
\fB-q \fIbits\fB\fR \fB-q \fI#\fB, --qlp-coeff-precision=\fI#\fB\fR
Precision of the quantized linear-predictor Precision of the quantized linear-predictor
coefficients, 0 => let encoder decide (min is 5, coefficients, 0 => let encoder decide (min is 5,
default is 0) default is 0)
.TP .TP
\fB-r \fI[level,]level\fB\fR \fB-r [\fI#\fB,]\fI#\fB, --rice-partition-order=[\fI#\fB,]\fI#\fB\fR
Set the [min,]max residual partition order Set the [min,]max residual partition order
(0..16). min defaults to 0 if unspecified. Default (0..16). min defaults to 0 if unspecified. Default
is -r 3,3. is -r 3,3.
.TP
\fB-V\fR
Verify a correct encoding by decoding the
output in parallel and comparing to the
original
.TP
\fB-F- -S- -P- -m- -M- -e- -E- -p- -V- --delete-input-file- --lax- --ogg- \fR
These flags can be used to invert the sense
of the corresponding normal option.
.SS "FORMAT OPTIONS" .SS "FORMAT OPTIONS"
.TP .TP
\fB-fb\fR \fB--endian={\fIbig\fB|\fIlittle\fB}\fR
Big-endian byte order Set the byte order for samples
.TP .TP
\fB-fl\fR \fB--channels=\fI#\fB\fR
Little-endian byte order
.TP
\fB-fc \fIchannels\fB\fR
Set number of channels. Set number of channels.
.TP .TP
\fB-fp \fIbits_per_sample\fB\fR \fB--bps=\fI#\fB\fR
Set bits per sample. Set bits per sample.
.TP .TP
\fB-fs \fIsample_rate\fB\fR \fB--sample-rate=\fI#\fB\fR
Set sample rate (in Hz). Set sample rate (in Hz).
.TP .TP
\fB-fu\fR \fB--sign={\fIsigned\fB|\fIunsigned\fB}\fR
Unsigned samples (default is signed) Set the sign of samples (the default is signed).
.TP .TP
\fB-fr\fR \fB--force-raw-input\fR
Force to raw format (even if filename ends Force input to be treated as raw samples (even if filename ends
in \fI.wav\fR). in \fI.wav\fR).
.SS "NEGATIVE OPTIONS"
.TP
\fB--no-adaptive-mid-side\fR
.TP
\fB--no-decode-through-errors\fR
.TP
\fB--no-delete-input-file\fR
.TP
\fB--no-escape-coding\fR
.TP
\fB--no-exhaustive-model-search\fR
.TP
\fB--no-lax\fR
.TP
\fB--no-mid-side\fR
.TP
\fB--no-ogg\fR
.TP
\fB--no-padding\fR
.TP
\fB--no-qlp-coeff-precision-search\fR
.TP
\fB--no-residual-gnuplot\fR
.TP
\fB--no-residual-text\fR
.TP
\fB--no-sector-align\fR
.TP
\fB--no-seektable\fR
.TP
\fB--no-silent\fR
.TP
\fB--no-verify\fR
These flags can be used to invert the sense
of the corresponding normal option.
.SH "SEE ALSO" .SH "SEE ALSO"
.PP .PP
The programs are documented fully by HTML format The programs are documented fully by HTML format

191
man/flac.sgml
View File

@@ -4,7 +4,7 @@
<!ENTITY dhfirstname "<firstname>Matt</firstname>"> <!ENTITY dhfirstname "<firstname>Matt</firstname>">
<!ENTITY dhsurname "<surname>Zimmerman</surname>"> <!ENTITY dhsurname "<surname>Zimmerman</surname>">
<!-- Please adjust the date whenever revising the manpage. --> <!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>June 04, 2002</date>"> <!ENTITY dhdate "<date>August 13, 2002</date>">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1). --> allowed: see man(7), man(1). -->
<!ENTITY dhsection "<manvolnum>1</manvolnum>"> <!ENTITY dhsection "<manvolnum>1</manvolnum>">
@@ -74,32 +74,31 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><option>-H</option> <term><option>-h</option>, <option>--help</option>
</term> </term>
<listitem> <listitem>
<para>Show detailed help screen</para> <para>Show basic usage and a list of all options</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-d</option> <term><option>-H</option>, <option>--explain</option>
</term> </term>
<listitem> <listitem>
<para>Decode (default behavior is encode)</para> <para>Show detailed explanation of usage and all options</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-c</option> <term><option>-d</option>, <option>--decode</option>
</term> </term>
<listitem> <listitem>
<para>Encode from standard input, or decode to <para>Decode (the default behavior is to encode)</para>
standard output</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-t</option> <term><option>-t</option>, <option>--test</option>
</term> </term>
<listitem> <listitem>
<para>Test a flac encoded file (same as -d <para>Test a flac encoded file (same as -d
@@ -108,7 +107,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-a</option> <term><option>-a</option>, <option>--analyze</option>
</term> </term>
<listitem> <listitem>
<para>Analyze a flac encoded file (same as -d <para>Analyze a flac encoded file (same as -d
@@ -117,16 +116,24 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-s</option> <term><option>-c</option>, <option>--stdout</option>
</term> </term>
<listitem> <listitem>
<para>Silent mode (do not write runtime <para>Write output to stdout</para>
encode/decode statistics to stdout)</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-o</option> <replaceable>filename</replaceable></term> <term><option>-s</option>, <option>--silent</option>
</term>
<listitem>
<para>Silent mode (do not write runtime
encode/decode statistics to stderr)</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-o</option> <replaceable>filename</replaceable>, <option>--output-name</option>=<replaceable>filename</replaceable></term>
<listitem> <listitem>
<para>Force the output file name (usually flac just <para>Force the output file name (usually flac just
changes the extension). May only be used when changes the extension). May only be used when
@@ -136,10 +143,10 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--output-prefix</option> <replaceable>string</replaceable></term> <term><option>--output-prefix</option>=<replaceable>string</replaceable></term>
<listitem> <listitem>
<para>Prefix each output file name with the given <para>Prefix each output file name with the given
string. This can be useful for encoding/decoding string. This can be useful for encoding or decoding
files to a different directory. Make sure if your files to a different directory. Make sure if your
string is a path name that it ends with a trailing string is a path name that it ends with a trailing
`/' (slash).</para> `/' (slash).</para>
@@ -158,7 +165,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--skip</option> <replaceable>samples</replaceable></term> <term><option>--skip</option>=<replaceable>#</replaceable></term>
<listitem> <listitem>
<para>Skip the specified number of samples at the <para>Skip the specified number of samples at the
beginning of the input file (can be used for both beginning of the input file (can be used for both
@@ -174,7 +181,7 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><option>--a-rtext</option> <term><option>--residual-text</option>
</term> </term>
<listitem> <listitem>
<para>Includes the residual signal in the analysis <para>Includes the residual signal in the analysis
@@ -184,7 +191,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--a-rgp</option> <term><option>--residual-gnuplot</option>
</term> </term>
<listitem> <listitem>
<para>Generates a gnuplot file for every subframe; <para>Generates a gnuplot file for every subframe;
@@ -202,7 +209,7 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><option>-F</option> <term><option>-F</option>, <option>--decode-through-errors</option>
</term> </term>
<listitem> <listitem>
<para>By default flac stops decoding with an error <para>By default flac stops decoding with an error
@@ -222,6 +229,16 @@
<title>Encoding Options</title> <title>Encoding Options</title>
<variablelist> <variablelist>
<varlistentry>
<term><option>-V</option>, <option>--verify</option></term>
<listitem>
<para>Verify a correct encoding by decoding the
output in parallel and comparing to the
original</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><option>--ogg</option></term> <term><option>--ogg</option></term>
@@ -257,7 +274,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-S</option> <replaceable>{ # | X | #x }</replaceable></term> <term><option>-S</option> {<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>}, <option>--seekpoint</option>={<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>}</term>
<listitem> <listitem>
<para> <para>
@@ -280,7 +297,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-P</option> <replaceable>bytes</replaceable></term> <term><option>-P</option> <replaceable>#</replaceable>, <option>--padding</option>=<replaceable>#</replaceable></term>
<listitem> <listitem>
<para>Tell the encoder to write a PADDING metadata <para>Tell the encoder to write a PADDING metadata
@@ -299,17 +316,18 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-b</option> <replaceable>blocksize</replaceable></term> <term><option>-b</option> <replaceable>#</replaceable>, <option>--blocksize</option>=<replaceable>#</replaceable></term>
<listitem> <listitem>
<para>Default is 1152 for -l 0, else 4608; must be <para>Specify the block size in samples. The
192/576/1152/2304/4608/256/512/1024/2048/4096/8192/16384/32768 default is 1152 for -l 0, else 4608; must be one of
(unless --lax is used)</para> 192, 576, 1152, 2304, 4608, 256, 512, 1024, 2048,
4096, 8192, 16384, or 32768 (unless --lax is used)</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-m</option></term> <term><option>-m</option>, <option>--mid-side</option></term>
<listitem> <listitem>
<para>Try mid-side coding for each frame (stereo <para>Try mid-side coding for each frame (stereo
@@ -318,16 +336,16 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-M</option></term> <term><option>-M</option>, <option>--adaptive-mid-side</option></term>
<listitem> <listitem>
<para>Loose mid-side coding for all frames (stereo <para>Adaptive mid-side coding for all frames (stereo
input only)</para> input only)</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-0</option>..<option>-8</option></term> <term><option>-0</option>..<option>-8</option>, <option>--compression-level-0</option>..<option>--compression-level-8</option></term>
<listitem> <listitem>
<para>Fastest compression..highest compression <para>Fastest compression..highest compression
@@ -336,7 +354,7 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><option>-0</option></term> <term><option>-0</option>, <option>--compression-level-0</option></term>
<listitem> <listitem>
<para>Synonymous with -l 0 -b 1152 -r 2,2 <para>Synonymous with -l 0 -b 1152 -r 2,2
@@ -345,7 +363,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-1</option></term> <term><option>-1</option>, <option>--compression-level-1</option></term>
<listitem> <listitem>
<para>Synonymous with -l 0 -b 1152 -M -r 2,2 <para>Synonymous with -l 0 -b 1152 -M -r 2,2
@@ -354,7 +372,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-2</option></term> <term><option>-2</option>, <option>--compression-level-2</option></term>
<listitem> <listitem>
<para>Synonymous with -l 0 -b 1152 -m -r 3 <para>Synonymous with -l 0 -b 1152 -m -r 3
@@ -363,7 +381,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-3</option></term> <term><option>-3</option>, <option>--compression-level-3</option></term>
<listitem> <listitem>
<para>Synonymous with -l 6 -b 4608 -r 3,3 <para>Synonymous with -l 6 -b 4608 -r 3,3
@@ -372,7 +390,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-4</option></term> <term><option>-4</option>, <option>--compression-level-4</option></term>
<listitem> <listitem>
<para>Synonymous with -l 8 -b 4608 -M -r 3,3 <para>Synonymous with -l 8 -b 4608 -M -r 3,3
@@ -381,7 +399,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-5</option></term> <term><option>-5</option>, <option>--compression-level-5</option></term>
<listitem> <listitem>
<para>Synonymous with -l 8 -b 4608 -m -r 3,3 <para>Synonymous with -l 8 -b 4608 -m -r 3,3
@@ -390,7 +408,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-6</option></term> <term><option>-6</option>, <option>--compression-level-6</option></term>
<listitem> <listitem>
<para>Synonymous with -l 8 -b 4608 -m -r 4 <para>Synonymous with -l 8 -b 4608 -m -r 4
@@ -399,7 +417,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-7</option></term> <term><option>-7</option>, <option>--compression-level-7</option></term>
<listitem> <listitem>
<para>Synonymous with -l 8 -b 4608 -m -e -r 6 <para>Synonymous with -l 8 -b 4608 -m -e -r 6
@@ -408,7 +426,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-8</option></term> <term><option>-8</option>, <option>--compression-level-8</option></term>
<listitem> <listitem>
<para>Synonymous with -l 12 -b 4608 -m -e -r 6 <para>Synonymous with -l 12 -b 4608 -m -e -r 6
@@ -419,7 +437,6 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@@ -441,7 +458,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-e</option></term> <term><option>-e</option>, <option>--exhaustive-model-search</option></term>
<listitem> <listitem>
<para>Do exhaustive model search <para>Do exhaustive model search
@@ -450,7 +467,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-E</option></term> <term><option>-E</option>, <option>--escape-coding</option></term>
<listitem> <listitem>
<para>Do escape coding in the entropy coder. This <para>Do escape coding in the entropy coder. This
@@ -462,25 +479,25 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-l</option> <replaceable>max_lpc_order</replaceable></term> <term><option>-l</option> <replaceable>#</replaceable>, <option>--max-lpc-order</option>=<replaceable>#</replaceable></term>
<listitem> <listitem>
<para>0 => use only fixed predictors</para> <para>Set the maximum LPC order; 0 means use only the fixed predictors</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-p</option></term> <term><option>-p</option>, <option>--qlp-coeff-precision-search</option></term>
<listitem> <listitem>
<para>Do exhaustive search of LP coefficient <para>Do exhaustive search of LP coefficient
quantization (expensive!). Overrides -q, quantization (expensive!). Overrides -q;
does nothing if using -l 0</para> does nothing if using -l 0</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-q</option> <replaceable>bits</replaceable></term> <term><option>-q</option> <replaceable>#</replaceable>, <option>--qlp-coeff-precision</option>=<replaceable>#</replaceable></term>
<listitem> <listitem>
<para>Precision of the quantized linear-predictor <para>Precision of the quantized linear-predictor
@@ -490,7 +507,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-r</option> <replaceable>[level,]level</replaceable></term> <term><option>-r</option> [<replaceable>#</replaceable>,]<replaceable>#</replaceable>, <option>--rice-partition-order</option>=[<replaceable>#</replaceable>,]<replaceable>#</replaceable></term>
<listitem> <listitem>
<para>Set the [min,]max residual partition order <para>Set the [min,]max residual partition order
@@ -499,25 +516,6 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><option>-V</option></term>
<listitem>
<para>Verify a correct encoding by decoding the
output in parallel and comparing to the
original</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-F-</option> <option>-S-</option> <option>-P-</option> <option>-m-</option> <option>-M-</option> <option>-e-</option> <option>-E-</option> <option>-p-</option> <option>-V-</option> <option>--delete-input-file-</option> <option>--lax-</option> <option>--ogg-</option>
</term>
<listitem>
<para>These flags can be used to invert the sense
of the corresponding normal option.</para>
</listitem>
</varlistentry>
</variablelist> </variablelist>
</refsect2> </refsect2>
@@ -526,24 +524,15 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><option>-fb</option></term> <term><option>--endian</option>={<replaceable>big</replaceable>|<replaceable>little</replaceable>}</term>
<listitem> <listitem>
<para>Big-endian byte order</para> <para>Set the byte order for samples</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-fl</option></term> <term><option>--channels</option>=<replaceable>#</replaceable></term>
<listitem>
<para>Little-endian byte order</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-fc</option>
<replaceable>channels</replaceable></term>
<listitem> <listitem>
<para>Set number of channels.</para> <para>Set number of channels.</para>
@@ -551,8 +540,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-fp</option> <term><option>--bps</option>=<replaceable>#</replaceable></term>
<replaceable>bits_per_sample</replaceable></term>
<listitem> <listitem>
<para>Set bits per sample.</para> <para>Set bits per sample.</para>
@@ -560,8 +548,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-fs</option> <term><option>--sample-rate</option>=<replaceable>#</replaceable></term>
<replaceable>sample_rate</replaceable></term>
<listitem> <listitem>
<para>Set sample rate (in Hz).</para> <para>Set sample rate (in Hz).</para>
@@ -569,18 +556,18 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-fu</option></term> <term><option>--sign</option>={<replaceable>signed</replaceable>|<replaceable>unsigned</replaceable>}</term>
<listitem> <listitem>
<para>Unsigned samples (default is signed)</para> <para>Set the sign of samples (the default is signed).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-fr</option></term> <term><option>--force-raw-input</option></term>
<listitem> <listitem>
<para>Force to raw format (even if filename ends <para>Force input to be treated as raw samples (even if filename ends
in <filename>.wav</filename>).</para> in <filename>.wav</filename>).</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@@ -588,6 +575,36 @@
</variablelist> </variablelist>
</refsect2> </refsect2>
<refsect2>
<title>Negative Options</title>
<variablelist>
<varlistentry>
<term><option>--no-adaptive-mid-side</option></term>
<term><option>--no-decode-through-errors</option></term>
<term><option>--no-delete-input-file</option></term>
<term><option>--no-escape-coding</option></term>
<term><option>--no-exhaustive-model-search</option></term>
<term><option>--no-lax</option></term>
<term><option>--no-mid-side</option></term>
<term><option>--no-ogg</option></term>
<term><option>--no-padding</option></term>
<term><option>--no-qlp-coeff-precision-search</option></term>
<term><option>--no-residual-gnuplot</option></term>
<term><option>--no-residual-text</option></term>
<term><option>--no-sector-align</option></term>
<term><option>--no-seektable</option></term>
<term><option>--no-silent</option></term>
<term><option>--no-verify</option></term>
<listitem>
<para>These flags can be used to invert the sense
of the corresponding normal option.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1> </refsect1>
<refsect1> <refsect1>
<title>SEE ALSO</title> <title>SEE ALSO</title>