- FLAC defines several types of metadata blocks (see the format page for the complete list. Metadata blocks can be any length and new ones can be defined. A decoder is allowed to skip any metadata types it does not understand. Only one is mandatory: the STREAMINFO block. This block has information like the sample rate, number of channels, etc., and data that can help the decoder manage its buffers, like the minimum and maximum data rate and minimum and maximum block size. Also included in the STREAMINFO block is the MD5 signature of the unencoded audio data. This is useful for checking an entire stream for transmission errors.
+ FLAC defines several types of metadata blocks (see the format page for the complete list). Metadata blocks can be any length and new ones can be defined. A decoder is allowed to skip any metadata types it does not understand. Only one is mandatory: the STREAMINFO block. This block has information like the sample rate, number of channels, etc., and data that can help the decoder manage its buffers, like the minimum and maximum data rate and minimum and maximum block size. Also included in the STREAMINFO block is the MD5 signature of the unencoded audio data. This is useful for checking an entire stream for transmission errors.
Other blocks allow for padding, seek tables, and application-specific data. You can see flac options below for adding PADDING blocks or specifying seek points. FLAC does not require seek points for seeking but they can speed up seeks, or be used for cueing in editing applications.
@@ -223,16 +223,16 @@
flac will be invoked one of four ways, depending on whether you are encoding, decoding, testing, or analyzing:
- Skip over the first # of samples of the input. This works for both encoding and decoding, but not testing.
+ Skip over the first # 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.
+ Examples:
+ --skip=123 : skip the first 123 samples of the input
+ --skip=1:23.45 : skip the first 1 minute and 23.45 samples of the input
+
+
+
+
+ --until={#|[+|-]mm:ss.ss}
+
+
+ Stop at the given sample number for each input file. This works for both encoding and decoding, but not testing. The given sample number is not included in the decoded output. The alternative form mm:ss.ss can be used to specify minutes, seconds, and fractions of a second. If a + sign is at the beginning, the --until point is relative to the --skip point. If a - sign is at the beginning, the --until point is relative to end of the audio.
+ Examples:
+ --until=123 : decode only the first 123 samples of the input (samples 0-122, stopping at 123)
+ --until=1:23.45 : decode only the first 1 minute and 23.45 seconds of the input
+ --skip=1:00 --until=+1:23.45 : decode 1:00 to 2:23.45
+ --until=-1:23.45 : decode everything except the last 1 minute and 23.45 seconds
+ --until=-0:00 : decode until the end of the input (the same as not specifying --until)
@@ -471,6 +488,15 @@
Note that this option cannot be used when encoding to standard output (stdout).
+
+
+ --cuesheet=FILENAME
+
+
+ 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.
+ The cuesheet file must be of the sort written by CDRwin, CDRcue, EAC, et al.
+
+
--sector-align
@@ -735,6 +761,14 @@
Specify that the samples in the raw file are signed or unsigned (the default is signed).
+
+
+ --force-aiff-format
+
+
+ Force the decoder to output AIFF format. This option is not needed if the output filename (as set by -o) ends with .aiff. Also, this option has no effect when encoding since input AIFF is auto-detected.
+
+
--force-raw-format
@@ -803,7 +837,7 @@
metaflac is the command-line .flac file metadata editor. You can use it to list the contents of blocks, delete or insert blocks, and manage padding.
- The documentation for metaflac is currently being rewritten, but the usage screen should explain it pretty well. Do metaflac --help to see the full usage.
+ The HTML documentation for metaflac is currently being rewritten, but the usage screen should explain it pretty well, and there is a man page. Do metaflac --help to see the full usage.
diff --git a/man/flac.1 b/man/flac.1
index aa626085..7db83a7a 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" "02 December 2002" "" ""
+.TH "FLAC" "1" "20 December 2002" "" ""
.SH NAME
flac \- Free Lossless Audio Codec
.SH SYNOPSIS
@@ -23,7 +23,7 @@ format; see below.
.PP
A summary of options is included below. For a complete
description, see the HTML documentation.
-.SS "GENERIC OPTIONS"
+.SS "GENERAL OPTIONS"
.TP
\fB-v, --version \fR
Show the flac version number
@@ -71,10 +71,23 @@ successful encode or decode. If there was an
error (including a verify error) the input file
is left intact.
.TP
-\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)
+\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.
+.TP
+\fB--until={\fI#\fB|[\fI+\fB|\fI-\fB]\fImm:ss.ss\fB}\fR
+Stop at the given sample number for each input file.
+This works for both encoding and decoding, but not testing.
+The given sample number is not included in the decoded
+output. The alternative form mm:ss.ss can be used to
+specify minutes, seconds, and fractions of a second. If a
+`+' (plus) sign is at the beginning, the --until point is
+relative to the --skip point. If a `-' (minus) sign is at
+the beginning, the --until point is relative to end of the
+audio.
.TP
\fB--ogg\fR
When encoding, generate Ogg-FLAC output instead
@@ -142,6 +155,13 @@ size of the tags is not known until all files
are processed. Note that this option cannot be
used when encoding to standard output (stdout).
.TP
+\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--sector-align\fR
Align encoding of multiple CD format WAVE
files on sector boundaries. See the HTML
@@ -284,6 +304,12 @@ Set sample rate (in Hz).
\fB--sign={\fIsigned\fB|\fIunsigned\fB}\fR
Set the sign of samples (the default is signed).
.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
@@ -325,6 +351,8 @@ These flags can be used to invert the sense
of the corresponding normal option.
.SH "SEE ALSO"
.PP
+metaflac(1).
+.PP
The programs are documented fully by HTML format
documentation, available in
\fI/usr/share/doc/flac/html\fR on
diff --git a/man/flac.sgml b/man/flac.sgml
index 35013a8e..d3bdb327 100644
--- a/man/flac.sgml
+++ b/man/flac.sgml
@@ -4,7 +4,7 @@
Matt">
Zimmerman">
- November 6, 2002">
+ December 18, 2002">
1">
@@ -70,7 +70,7 @@
description, see the HTML documentation.
- Generic Options
+ General Options
@@ -173,11 +173,28 @@
- =#
+ ={#|mm:ss.ss}
- Skip the specified number of samples at the
- beginning of the input file (can be used for both
- encoding and decoding)
+ 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.
+
+
+
+
+ ={#|[+|-]mm:ss.ss}
+
+ Stop at the given sample number for each input file.
+ This works for both encoding and decoding, but not testing.
+ The given sample number is not included in the decoded
+ output. The alternative form mm:ss.ss can be used to
+ specify minutes, seconds, and fractions of a second. If a
+ `+' (plus) sign is at the beginning, the --until point is
+ relative to the --skip point. If a `-' (minus) sign is at
+ the beginning, the --until point is relative to end of the
+ audio.
@@ -305,6 +322,18 @@
+
+ =filename
+
+
+ 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.
+
+
+
@@ -610,6 +639,17 @@
+
+
+
+
+ Force the decoder to output AIFF format. This option
+ is not needed if the output filename (as set by -o) ends
+ with .aiff. Also, this option has no
+ effect when encoding since input AIFF is auto-detected.
+
+
+
@@ -657,6 +697,8 @@
SEE ALSO
+ metaflac(1).
+
The programs are documented fully by HTML format
documentation, available in
/usr/share/doc/flac/html on