summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorMartijn van Beurden <mvanb1@gmail.com>2022-06-24 22:09:09 +0200
committerMartijn van Beurden <mvanb1@gmail.com>2022-06-28 07:11:16 +0200
commitb3c6fc2a04cdd9b912be0ba5c6500931e0961448 (patch)
treec928f7b8dd6c78170d650282c50ef772e3af95fb /man
parente6ff8b035a0f4e0e7b96adf10ae061dafa900229 (diff)
downloadflac-b3c6fc2a04cdd9b912be0ba5c6500931e0961448.tar.gz
Improve foreign metadata handling
Add options --keep-foreign-metadata-if-present and improve error messages when on decoding the wrong type of foreign metadata is found.
Diffstat (limited to 'man')
-rw-r--r--man/flac.13
-rw-r--r--man/flac.sgml8
-rw-r--r--man/metaflac.14
3 files changed, 13 insertions, 2 deletions
diff --git a/man/flac.1 b/man/flac.1
index 0d130526..100274d9 100644
--- a/man/flac.1
+++ b/man/flac.1
@@ -74,6 +74,9 @@ Output files have their timestamps/permissions set to match those of their input
\fB--keep-foreign-metadata \fR
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--keep-foreign-metadata-if-present \fR
+Like --keep-foreign-metadata, but without throwing an error if foreign metadata cannot be found or restored, instead printing a warning.
+.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.
.TP
diff --git a/man/flac.sgml b/man/flac.sgml
index d1edf3a2..4aa0f094 100644
--- a/man/flac.sgml
+++ b/man/flac.sgml
@@ -223,6 +223,14 @@
</varlistentry>
<varlistentry>
+ <term><option>--keep-foreign-metadata-if-present</option>
+ </term>
+ <listitem>
+ <para>Like --keep-foreign-metadata, but without throwing an error if foreign metadata cannot be found or restored, instead printing a warning.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--skip</option>={<replaceable>#</replaceable>|<replaceable>mm:ss.ss</replaceable>}</term>
<listitem>
<para>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.</para>
diff --git a/man/metaflac.1 b/man/metaflac.1
index 0c1c66bc..1490dffe 100644
--- a/man/metaflac.1
+++ b/man/metaflac.1
@@ -200,8 +200,8 @@ number of channels. The sample rate must be one of 8, 11.025,
96, 112, 128, 144, 176.4, or 192kHz.
.TP
\fB--scan-replay-gain\fR
-Like --add-replay-gain, but only analyzes the files rather than
-writing them to the tags.
+Like --add-replay-gain, but only analyzes the files rather
+than writing them to the tags.
.TP
\fB--remove-replay-gain\fR
Removes the ReplayGain tags.