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