From 9c17e6e5187376415bb5c123533faeb0099cb0ba Mon Sep 17 00:00:00 2001 From: Josh Coalson Date: Wed, 14 Feb 2007 01:28:01 +0000 Subject: [PATCH] sync with sgml --- man/flac.1 | 33 +++++++++++++++++++-------------- man/metaflac.1 | 10 +++++----- 2 files changed, 24 insertions(+), 19 deletions(-) diff --git a/man/flac.1 b/man/flac.1 index 7b0a545..5dbe8ae 100644 --- a/man/flac.1 +++ b/man/flac.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "FLAC" "1" "17 November 2006" "" "" +.TH "FLAC" "1" "12 February 2007" "" "" .SH NAME flac \- Free Lossless Audio Codec @@ -50,6 +50,9 @@ Silent mode (do not write runtime encode/decode statistics to stderr) \fB--totally-silent \fR Do not print anything of any kind, including warnings or errors. The exit code will be the only way to determine successful completion. .TP +\fB-w, --warnings-as-errors \fR +Treat all warnings as errors (which cause flac to terminate with a non-zero exit code). +.TP \fB-f, --force \fR Force overwriting of output files. By default, flac warns that the output file already exists and continues to the next file. .TP @@ -103,10 +106,10 @@ Calculate ReplayGain values and store them as FLAC tags, similar to vorbisgain. \fB--cuesheet=\fIfilename\fB\fR Import the given cuesheet file and store it in a CUESHEET metadata block. This option may only be used when encoding a single file. A seekpoint will be added for each index point in the cuesheet to the SEEKTABLE unless --no-cued-seekpoints is specified. .TP -\fB--picture=\fISPECIFICATION\fB\fR -Import a picture and store it in a PICTURE metadata block. More than one --picture command can be specified. The SPECIFICATION is a string whose parts are separated by | (pipe) characters. Some parts may be left empty to invoke default values. The format of SPECIFICATION is +\fB--picture={\fIFILENAME\fB|\fISPECIFICATION\fB}\fR +Import a picture and store it in a PICTURE metadata block. More than one --picture command can be specified. Either a filename for the picture file or a more complete specification form can be used. The SPECIFICATION is a string whose parts are separated by | (pipe) characters. Some parts may be left empty to invoke default values. FILENAME is just shorthand for "||||FILENAME". The format of SPECIFICATION is -[TYPE]|MIME-TYPE|[DESCRIPTION]|[WIDTHxHEIGHTxDEPTH[/COLORS]]|FILE +[TYPE]|[MIME-TYPE]|[DESCRIPTION]|[WIDTHxHEIGHTxDEPTH[/COLORS]]|FILE TYPE is optional; it is a number from one of: @@ -154,7 +157,7 @@ TYPE is optional; it is a number from one of: The default is 3 (front cover). There may only be one picture each of type 1 and 2 in a file. -MIME-TYPE is mandatory; for best compatibility with players, use pictures with MIME type image/jpeg or image/png. The MIME type can also be --> to mean that FILE is actually a URL to an image, though this use is discouraged. +MIME-TYPE is optional; if left blank, it will be detected from the file. For best compatibility with players, use pictures with MIME type image/jpeg or image/png. The MIME type can also be --> to mean that FILE is actually a URL to an image, though this use is discouraged. DESCRIPTION is optional; the default is an empty string. @@ -195,31 +198,31 @@ Fastest compression..highest compression (default is -5). These are synonyms fo .RS .TP \fB-0, --compression-level-0\fR -Synonymous with -l 0 -b 1152 -r 2,2 +Synonymous with -l 0 -b 1152 -r 3 .TP \fB-1, --compression-level-1\fR -Synonymous with -l 0 -b 1152 -M -r 2,2 +Synonymous with -l 0 -b 1152 -M -r 3 .TP \fB-2, --compression-level-2\fR Synonymous with -l 0 -b 1152 -m -r 3 .TP \fB-3, --compression-level-3\fR -Synonymous with -l 6 -b 4608 -r 3,3 +Synonymous with -l 6 -b 4096 -r 4 .TP \fB-4, --compression-level-4\fR -Synonymous with -l 8 -b 4608 -M -r 3,3 +Synonymous with -l 8 -b 4096 -M -r 4 .TP \fB-5, --compression-level-5\fR -Synonymous with -l 8 -b 4608 -m -r 3,3 +Synonymous with -l 8 -b 4096 -m -r 5 .TP \fB-6, --compression-level-6\fR -Synonymous with -l 8 -b 4608 -m -r 4 +Synonymous with -l 8 -b 4096 -m -r 6 .TP \fB-7, --compression-level-7\fR -Synonymous with -l 8 -b 4608 -m -e -r 6 +Synonymous with -l 8 -b 4096 -m -e -r 6 .TP \fB-8, --compression-level-8\fR -Synonymous with -l 12 -b 4608 -m -e -r 6 +Synonymous with -l 12 -b 4096 -m -e -r 6 .RE .TP \fB--fast\fR @@ -252,7 +255,7 @@ Do exhaustive search of LP coefficient quantization (expensive!). Overrides -q; Precision of the quantized linear-predictor coefficients, 0 => let encoder decide (min is 5, default is 0) .TP \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. +Set the [min,]max residual partition order (0..16). min defaults to 0 if unspecified. Default is -r 5. .SS "FORMAT OPTIONS" .TP \fB--endian={\fIbig\fB|\fIlittle\fB}\fR @@ -309,6 +312,8 @@ Force input (when encoding) or output (when decoding) to be treated as raw sampl \fB--no-silent\fR .TP \fB--no-verify\fR +.TP +\fB--no-warnings-as-errors\fR These flags can be used to invert the sense of the corresponding normal option. .SH "SEE ALSO" .PP diff --git a/man/metaflac.1 b/man/metaflac.1 index 6346f35..d4b4616 100644 --- a/man/metaflac.1 +++ b/man/metaflac.1 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "METAFLAC" "1" "17 November 2006" "" "" +.TH "METAFLAC" "1" "12 February 2007" "" "" .SH NAME metaflac \- program to list, add, remove, or edit metadata in one or more FLAC files. @@ -119,10 +119,10 @@ Export CUESHEET block to a cuesheet file, suitable for use by CD authoring software. Use '-' for stdout. Only one FLAC file may be specified on the command line. .TP -\fB--import-picture-from=\fISPECIFICATION\fB\fR -Import a picture and store it in a PICTURE metadata block. More than one --import-picture-from command can be specified. The SPECIFICATION is a string whose parts are separated by | (pipe) characters. Some parts may be left empty to invoke default values. The format of SPECIFICATION is +\fB--import-picture-from={\fIFILENAME\fB|\fISPECIFICATION\fB}\fR +Import a picture and store it in a PICTURE metadata block. More than one --import-picture-from command can be specified. Either a filename for the picture file or a more complete specification form can be used. The SPECIFICATION is a string whose parts are separated by | (pipe) characters. Some parts may be left empty to invoke default values. FILENAME is just shorthand for "||||FILENAME". The format of SPECIFICATION is -[TYPE]|MIME-TYPE|[DESCRIPTION]|[WIDTHxHEIGHTxDEPTH[/COLORS]]|FILE +[TYPE]|[MIME-TYPE]|[DESCRIPTION]|[WIDTHxHEIGHTxDEPTH[/COLORS]]|FILE TYPE is optional; it is a number from one of: @@ -170,7 +170,7 @@ TYPE is optional; it is a number from one of: The default is 3 (front cover). There may only be one picture each of type 1 and 2 in a file. -MIME-TYPE is mandatory; for best compatibility with players, use pictures with MIME type image/jpeg or image/png. The MIME type can also be --> to mean that FILE is actually a URL to an image, though this use is discouraged. +MIME-TYPE is optional; if left blank, it will be detected from the file. For best compatibility with players, use pictures with MIME type image/jpeg or image/png. The MIME type can also be --> to mean that FILE is actually a URL to an image, though this use is discouraged. DESCRIPTION is optional; the default is an empty string. -- 2.7.4