summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorErik de Castro Lopo <erikd@mega-nerd.com>2012-09-19 18:06:49 +1000
committerErik de Castro Lopo <erikd@mega-nerd.com>2012-09-19 18:06:49 +1000
commita2923e64c0c1db21134f0e9a143fe0ac5597fa19 (patch)
treed74804b60cf2485402e0cbc0f9facbf23ab05ed5 /man
parent6f3f7f06c86386ec7b77cab0f5d1134b9760b52e (diff)
downloadflac-a2923e64c0c1db21134f0e9a143fe0ac5597fa19.tar.gz
Regenerate manpages.
Diffstat (limited to 'man')
-rw-r--r--man/flac.127
-rw-r--r--man/metaflac.19
2 files changed, 25 insertions, 11 deletions
diff --git a/man/flac.1 b/man/flac.1
index fef4dedd..eaeb0284 100644
--- a/man/flac.1
+++ b/man/flac.1
@@ -3,13 +3,13 @@
.\" <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" "14 September 2007" "" ""
+.TH "FLAC" "1" "Nov 4, 2006" "" ""
.SH NAME
flac \- Free Lossless Audio Codec
.SH SYNOPSIS
-\fBflac\fR [ \fB\fIOPTIONS\fB\fR ] [ \fB\fIinfile.wav\fB\fR | \fB\fIinfile.aiff\fB\fR | \fB\fIinfile.raw\fB\fR | \fB\fIinfile.flac\fB\fR | \fB\fIinfile.oga\fB\fR | \fB\fIinfile.ogg\fB\fR | \fB-\fR\fI ...\fR ]
+\fBflac\fR [ \fB\fIOPTIONS\fB\fR ] [ \fB\fIinfile.wav\fB\fR | \fB\fIinfile.rf64\fB\fR | \fB\fIinfile.aiff\fB\fR | \fB\fIinfile.raw\fB\fR | \fB\fIinfile.flac\fB\fR | \fB\fIinfile.oga\fB\fR | \fB\fIinfile.ogg\fB\fR | \fB-\fR\fI ...\fR ]
\fBflac\fR [ \fB-d\fR | \fB--decode\fR | \fB-t\fR | \fB--test\fR | \fB-a\fR | \fB--analyze\fR ] [ \fB\fIOPTIONS\fB\fR ] [ \fB\fIinfile.flac\fB\fR | \fB\fIinfile.oga\fB\fR | \fB\fIinfile.ogg\fB\fR | \fB-\fR\fI ...\fR ]
@@ -68,8 +68,11 @@ Prefix each output file name with the given string. This can be useful for enco
\fB--delete-input-file \fR
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.
.TP
+\fB--preserve-modtime \fR
+Output files have their timestamps/permissions set to match those of their inputs (this is default). Use --no-preserve-modtime to make output files have the current time and default permissions.
+.TP
\fB--keep-foreign-metadata \fR
-If encoding, save WAVE or AIFF non-audio chunks in FLAC metadata. If decoding, restore any saved non-audio chunks from FLAC metadata when writing the decoded file. Foreign metadata cannot be transcoded, e.g. WAVE chunks saved in a FLAC file cannot be restored when decoding to AIFF. Input and output must be regular files (not stdin or stdout).
+If encoding, save WAVE, RF64, or AIFF non-audio chunks in FLAC metadata. If decoding, restore any saved non-audio chunks from FLAC metadata when writing the decoded file. Foreign metadata cannot be transcoded, e.g. WAVE chunks saved in a FLAC file cannot be restored when decoding to AIFF. Input and output must be regular files (not stdin or stdout).
.TP
\fB--skip={\fI#\fB|\fImm:ss.ss\fB}\fR
Skip over the first number of samples of the input. This works for both encoding and decoding, but not testing. The alternative form mm:ss.ss can be used to specify minutes, seconds, and fractions of a second.
@@ -176,7 +179,7 @@ For example, "|image/jpeg|||../cover.jpg" will embed the JPEG file at ../cover.j
The specification "4|-->|CD|320x300x24/173|http://blah.blah/backcover.tiff" will embed the given URL, with type 4 (back cover), description "CD", and a manually specified resolution of 320x300, 24 bits-per-pixel, and 173 colors. The file at the URL will not be fetched; the URL itself is stored in the PICTURE metadata block.
.TP
\fB--sector-align\fR
-Align encoding of multiple CD format files on sector boundaries. See the HTML documentation for more information.
+Align encoding of multiple CD format files on sector boundaries. See the HTML documentation for more information. This option is DEPRECATED and may not exist in future versions of flac.
.TP
\fB-S {\fI#\fB|\fIX\fB|\fI#x\fB|\fI#s\fB}, --seekpoint={\fI#\fB|\fIX\fB|\fI#x\fB|\fI#s\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 table. Using #x, # evenly spaced seek points will be added, the first being at sample 0. Using #s, a seekpoint will be added every # seconds (# does not have to be a whole number; it can be, for example, 9.5, meaning a seekpoint every 9.5 seconds). You may use many -S options; the resulting SEEKTABLE will be the unique-ified union of all such values. With no -S options, flac defaults to '-S 10s'. Use --no-seektable for no SEEKTABLE. Note: '-S #x' and '-S #s' will not work if the encoder can't determine the input size before starting. Note: if you use '-S #' and # is >= samples in the input, there will be either no seek point entered (if the input size is determinable before encoding starts) or a placeholder point (if input size is not determinable).
@@ -282,11 +285,17 @@ Set the sign of samples (the default is signed).
\fB--input-size=\fI#\fB\fR
Specify the size of the raw input in bytes. If you are encoding raw samples from stdin, you must set this option in order to be able to use --skip, --until, --cue-sheet, or other options that need to know the size of the input beforehand. If the size given is greater than what is found in the input stream, the encoder will complain about an unexpected end-of-file. If the size given is less, samples will be truncated.
.TP
-\fB--force-aiff-format\fR
-Force the decoder to output AIFF format. This option is not needed if the output filename (as set by -o) ends with \fI\&.aiff\fR\&. Also, this option has no effect when encoding since input AIFF is auto-detected.
-.TP
\fB--force-raw-format\fR
Force input (when encoding) or output (when decoding) to be treated as raw samples (even if filename ends in \fI\&.wav\fR).
+.TP
+\fB--force-aiff-format\fR
+Force the decoder to output AIFF format. This option is not needed if the output filename (as set by -o) ends with \fI\&.aif\fR or \fI\&.aiff\fR\&. Also, this option has no effect when encoding since input AIFF is auto-detected.
+.TP
+\fB--force-rf64-format\fR
+Force the decoder to output RF64 format. This option is not needed if the output filename (as set by -o) ends with \fI\&.rf64\fR\&. Also, this option has no effect when encoding since input RF64 is auto-detected.
+.TP
+\fB--force-wave64-format\fR
+Force the decoder to output Wave64 format. This option is not needed if the output filename (as set by -o) ends with \fI\&.w64\fR\&. Also, this option has no effect when encoding since input Wave64 is auto-detected.
.SS "NEGATIVE OPTIONS"
.TP
\fB--no-adaptive-mid-side\fR
@@ -295,6 +304,10 @@ Force input (when encoding) or output (when decoding) to be treated as raw sampl
.TP
\fB--no-delete-input-file\fR
.TP
+\fB--no-preserve-modtime\fR
+.TP
+\fB--no-keep-foreign-metadata\fR
+.TP
\fB--no-exhaustive-model-search\fR
.TP
\fB--no-lax\fR
diff --git a/man/metaflac.1 b/man/metaflac.1
index 9cc593d1..f55a1d1f 100644
--- a/man/metaflac.1
+++ b/man/metaflac.1
@@ -3,7 +3,7 @@
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
-.TH "METAFLAC" "1" "14 September 2007" "" ""
+.TH "METAFLAC" "1" "2006-11-14" "" ""
.SH NAME
metaflac \- program to list, add, remove, or edit metadata in one or more FLAC files.
@@ -196,7 +196,8 @@ passes, it is always executed last, after all other operations
have been completed and written to disk. All FLAC files
specified must have the same resolution, sample rate, and
number of channels. The sample rate must be one of 8, 11.025,
-12, 16, 22.05, 24, 32, 44.1, or 48 kHz.
+12, 16, 18.9, 22.05, 24, 28, 32, 37.8, 44.1, 48, 56, 64, 88.2,
+96, 112, 128, 144, 176.4, or 192kHz.
.TP
\fB--remove-replay-gain\fR
Removes the ReplayGain tags.
@@ -238,8 +239,8 @@ The first block, the STREAMINFO block, is block 0.
An optional comma-separated list of block types to be included
or ignored with this option. Use only one of --block-type or
--except-block-type. The valid block types are: STREAMINFO,
-PADDING, APPLICATION, SEEKTABLE, VORBIS_COMMENT. You may
-narrow down the types of APPLICATION blocks displayed as
+PADDING, APPLICATION, SEEKTABLE, VORBIS_COMMENT, PICTURE. You
+may narrow down the types of APPLICATION blocks displayed as
follows:
APPLICATION:abcd The APPLICATION block(s) whose textual repre-