diff options
| author | Martijn van Beurden <mvanb1@gmail.com> | 2021-08-31 08:55:06 +0200 |
|---|---|---|
| committer | Martijn van Beurden <mvanb1@gmail.com> | 2022-04-26 22:09:05 +0200 |
| commit | a21bdc4a9e0f94abbe2f0a135d2ec16d5b17f5fb (patch) | |
| tree | 935e1283a0f64c42b7ea4ecc2ca0b6b12ebfbbc7 /man | |
| parent | f59cb6f7b4aa5b28de0a00400080f285ffb9f3b2 (diff) | |
| download | flac-a21bdc4a9e0f94abbe2f0a135d2ec16d5b17f5fb.tar.gz | |
Documentation fixes: preset description and subset blocksizes
As described in github issue #236, the description of compression
presets in flac.sgml wasn't updated. Also, the description of which
blocksizes are considered subset has been lagging behind in the
manpages as well as the build-in help of FLAC for years, as this
was changed back in 2007. This commit fixes those issues
Diffstat (limited to 'man')
| -rw-r--r-- | man/flac.1 | 4 | ||||
| -rw-r--r-- | man/flac.sgml | 14 |
2 files changed, 9 insertions, 9 deletions
@@ -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 "FLAC" "1" "2013/09/18" "" "" +.TH "FLAC" "1" "2021/08/31" "" "" .SH NAME flac \- Free Lossless Audio Codec @@ -230,7 +230,7 @@ Add a FLAC tag. The comment must adhere to the Vorbis comment spec; i.e. the FI Like --tag, except FILENAME is a file whose contents will be read verbatim to set the tag value. The contents will be converted to UTF-8 from the local charset. This can be used to store a cuesheet in a tag (e.g. --tag-from-file="CUESHEET=image.cue"). Do not try to store binary data in tag fields! Use APPLICATION blocks for that. .TP \fB-b \fI#\fB, --blocksize=\fI#\fB\fR -Specify the block size in samples. Subset streams must use one of 192, 576, 1152, 2304, 4608, 256, 512, 1024, 2048, 4096 (and 8192 or 16384 if the sample rate is >48kHz). +Specify the blocksize in samples. The default is 1152 for -l 0, else 4096. For subset streams this must be <= 4608 if the samplerate <= 48kHz, for subset streams with higher samplerates it must be <= 16384. .TP \fB-m, --mid-side\fR Try mid-side coding for each frame (stereo input only) diff --git a/man/flac.sgml b/man/flac.sgml index 87a3f238..d1edf3a2 100644 --- a/man/flac.sgml +++ b/man/flac.sgml @@ -4,7 +4,7 @@ <!ENTITY dhfirstname "<firstname>Matt</firstname>"> <!ENTITY dhsurname "<surname>Zimmerman</surname>"> <!-- Please adjust the date whenever revising the manpage. --> - <!ENTITY dhdate "<date>2013/09/18</date>"> + <!ENTITY dhdate "<date>2021/08/31</date>"> <!-- SECTION should be 1-8, maybe w/ subsection other parameters are allowed: see man(7), man(1). --> <!ENTITY dhsection "<manvolnum>1</manvolnum>"> @@ -27,7 +27,7 @@ &dhsurname; </author> <copyright> - <year>2002-2005, 2011-2013</year> + <year>2002-2005, 2011-2021</year> <holder>&dhusername;</holder> </copyright> &dhdate; @@ -480,7 +480,7 @@ <term><option>-b</option> <replaceable>#</replaceable>, <option>--blocksize</option>=<replaceable>#</replaceable></term> <listitem> - <para>Specify the block size in samples. Subset streams must use one of 192, 576, 1152, 2304, 4608, 256, 512, 1024, 2048, 4096 (and 8192 or 16384 if the sample rate is >48kHz).</para> + <para>Specify the blocksize in samples. The default is 1152 for -l 0, else 4096. For subset streams this must be <= 4608 if the samplerate <= 48kHz, for subset streams with higher samplerates it must be <= 16384.</para> </listitem> </varlistentry> @@ -511,7 +511,7 @@ <term><option>-0</option>, <option>--compression-level-0</option></term> <listitem> - <para>Synonymous with -l 0 -b 1152 -r 3</para> + <para>Synonymous with -l 0 -b 1152 -r 3 --no-mid-side</para> </listitem> </varlistentry> @@ -535,7 +535,7 @@ <term><option>-3</option>, <option>--compression-level-3</option></term> <listitem> - <para>Synonymous with -l 6 -b 4096 -r 4</para> + <para>Synonymous with -l 6 -b 4096 -r 4 --no-mid-side</para> </listitem> </varlistentry> @@ -567,7 +567,7 @@ <term><option>-7</option>, <option>--compression-level-7</option></term> <listitem> - <para>Synonymous with -l 8 -b 4096 -m -e -r 6 -A tukey(0.5) -A partial_tukey(2)</para> + <para>Synonymous with -l 12 -b 4096 -m -r 6 -A tukey(0.5) -A partial_tukey(2)</para> </listitem> </varlistentry> @@ -575,7 +575,7 @@ <term><option>-8</option>, <option>--compression-level-8</option></term> <listitem> - <para>Synonymous with -l 12 -b 4096 -m -e -r 6 -A tukey(0.5) -A partial_tukey(2) -A punchout_tukey(3)</para> + <para>Synonymous with -l 12 -b 4096 -m -r 6 -A tukey(0.5) -A partial_tukey(2) -A punchout_tukey(3)</para> </listitem> </varlistentry> </variablelist> |