- In any case, if no inputfile is specified, stdin is assumed. If only one inputfile is specified, it may be "-" for stdin. When stdin is used as input, flac will write to stdout. Otherwise flac will perform the desired operation on each input file to similarly named output files (meaning for encoding, the extension will be replaced with ".flac", or appended with ".flac" if the input file has no extension, and for decoding, the extension will be ".wav" for WAVE output and ".raw" for raw output). The original file is not deleted.
+ In any case, if no inputfile is specified, stdin is assumed. If only one inputfile is specified, it may be "-" for stdin. When stdin is used as input, flac will write to stdout. Otherwise flac will perform the desired operation on each input file to similarly named output files (meaning for encoding, the extension will be replaced with ".flac", or appended with ".flac" if the input file has no extension, and for decoding, the extension will be ".wav" for WAVE output and ".raw" for raw output). The original file is not deleted unless --delete-input-file is specified.
- There are special forms for encoding/decoding from stdin to a file:
+ If you are encoding/decoding from stdin to a file, you should use the -o option like so:
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.
@@ -178,7 +178,7 @@
- -t
+ -t
Test (same as -d except no decoded file is written). The exit codes are the same as in decode mode.
@@ -186,7 +186,7 @@
- -a
+ -a
Analyze (same as -d 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.
@@ -194,7 +194,7 @@
- -c
+ -c
Write output to stdout
@@ -202,7 +202,7 @@
- -s
+ -s
Silent: do not show encoding/decoding statistics.
@@ -210,7 +210,23 @@
- --skip #
+ -o filename
+
+
+ Force the output file name (usually flac just changes the extension).
+
+
+
+
+ --delete-input-file
+
+
+ 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.
+
+
+
+
+ --skip #
Skip over the first # of samples of the input. This works for both encoding and decoding, but not testing.
@@ -466,7 +482,7 @@
- -S-, -m-, -e-, -p-, -V-, --lax- can all be used to turn off a particular option.
+ -S-, -m-, -e-, -p-, -V-, --delete-input-file-, --lax- can all be used to turn off a particular option.
flac now has a command-line usage similar to 'gzip'; make sure to see the latest documentation for the new usage. It also attempts to preserve the input file's timestamp and permissions.
The -# options in flac have been tweaked to yield the best compression-to-encode-time ratios. The new default is -5.
The WAVE reader in flac now just ignores (with a warning) unsupported sub-chunks instead of aborting with an error.
+
Added an option '--delete-input-file' to flac which automatically deletes the input after a successful encode/decode.
+
Added an option '-o' to flac to force the output file name (the old usage of "flac - outputfilename" is no longer supported).
Changed the XMMS plugin to send smaller chunks of samples (now 512) so that visualization is not slow.
Fixed a bug in the stream decoder where the decoded samples counter got corrupted after a seek.
diff --git a/man/flac.sgml b/man/flac.sgml
index 013de4b0..8b19fe4e 100644
--- a/man/flac.sgml
+++ b/man/flac.sgml
@@ -48,7 +48,7 @@
infile
- outfile
+ ...
@@ -108,6 +108,25 @@
+
+ filename
+
+ Force the output file name (usually flac just
+ changes the extension).
+
+
+
+
+
+
+
+ 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.
+
+
+
samples
@@ -399,7 +418,7 @@
-
+