From dfad4613008e9a148f4c57d887decb8bd4b17be1 Mon Sep 17 00:00:00 2001 From: Josh Coalson Date: Sat, 13 Jan 2001 00:32:32 +0000 Subject: [PATCH] add info about MD5 and test mode --- doc/documentation.html | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/doc/documentation.html b/doc/documentation.html index 7d12ee3..880a221 100644 --- a/doc/documentation.html +++ b/doc/documentation.html @@ -111,7 +111,7 @@ Before going into the full command-line description, two other things help to sort it out: 1) flac encodes by default, so you must use -d to decode; 2) the options -0 .. -9 that control the compression level actually are just synonyms for different groups of specific coding options (described later). You can get the same effect by using the same options.

- flac will be invoked one of two ways, depending on whether you are encoding or decoding: + flac will be invoked one of three ways, depending on whether you are encoding, decoding, or testing:

- In either case, inputfile may be "-" for stdin, and "-" for stdout. The encoding options affect the compression ratio and encoding speed. The format options are used to tell flac the arrangement of samples if the input file (or output file when decoding) is a raw file. If it is a RIFF WAVE file the format options are not needed since they are read from the WAVE header. + In either case, inputfile may be "-" for stdin, and the outputfile "-" for stdout. The encoding options affect the compression ratio and encoding speed. The format options are used to tell flac the arrangement of samples if the input file (or output file when decoding) is a raw file. If it is a RIFF WAVE file the format options are not needed since they are read from the WAVE header. +

+

+ In test mode, flac acts just like in decode mode, except no output file is written. Both decode and test modes detect errors in the stream, but they also detect when the MD5 signature of the decoded audio does not match the stored MD5 signature, even when the bitstream is valid.

+ + + + @@ -153,7 +167,7 @@ --skip #
@@ -137,7 +143,15 @@ -d - Decode (flac encodes by default). + Decode (flac encodes by default). flac will exit with an exit code of 1 (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 0. +
+ -t + + Test (same as -d except no decoded file is written). The exit codes are the same as in decode mode.
- Skip over the first # of samples of the input. This works for both encoding and decoding. + Skip over the first # of samples of the input. This works for both encoding and decoding, but not testing.
-- 2.7.4