[PATCH] for flac man page

Urs Thuermann urs at isnogud.escape.de
Tue Feb 21 09:39:27 UTC 2012


The flac manual page documents the option

        --until={#|[+|-]mm:ss.ss}

But a simple test shows that the + and - prefixes do not only work
with the mm:ss.ss notation but also with a simple sample number, i.e.

        flac --skip=5000 --until=+1000

to decode from samples 5000 to 6000.  Assuming this behavior is
intended, please apply the appended patch.

urs


--- flac.1.orig	2012-02-21 10:32:48.728343498 +0100
+++ flac.1	2012-02-21 10:33:33.428863766 +0100
@@ -48,7 +48,7 @@
 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). 
 .IP "\fB\-\-skip\fP={\fI#\fR|\fImm:ss.ss\fR}" 10 
 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. 
-.IP "\fB\-\-until\fP={\fI#\fR|[\fI+\fR|\fI-\fR]\fImm:ss.ss\fR}" 10 
+.IP "\fB\-\-until\fP={[\fI+\fR|\fI-\fR](\fI#\fR|\fImm:ss.ss\fR)}" 10 
 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. 
 .IP "\fB\-\-ogg\fP" 10 
 When encoding, generate Ogg FLAC output instead of native FLAC.  Ogg FLAC streams are FLAC streams wrapped in an Ogg transport layer.  The resulting file should have an '.oga' extension and will still be decodable by flac. 



More information about the pkg-multimedia-maintainers mailing list