mirror of
https://git.suyu.dev/suyu/flatpak.git
synced 2025-01-06 14:26:07 +00:00
248 lines
6.6 KiB
Diff
248 lines
6.6 KiB
Diff
Description: Man page says --silent, should be --skip
|
|
From: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=355783
|
|
Forwarded: no
|
|
---
|
|
vorbisgain.1 | 60 ++++++++++++-----------------------------------------------
|
|
1 file changed, 13 insertions(+), 47 deletions(-)
|
|
|
|
--- a/vorbisgain.1
|
|
+++ b/vorbisgain.1
|
|
@@ -2,10 +2,8 @@
|
|
.\" groff -man -Tascii vorbisgain.1
|
|
.\"
|
|
.TH vorbisgain 1 "2004 Jan 3" "" "VorbisGain"
|
|
-
|
|
.SH NAME
|
|
vorbisgain \- calculate the replay gain for Ogg Vorbis files
|
|
-
|
|
.SH SYNOPSIS
|
|
.B vorbisgain
|
|
[
|
|
@@ -16,7 +14,6 @@
|
|
.I album gain
|
|
]
|
|
.I input_files \fR...
|
|
-
|
|
.SH DESCRIPTION
|
|
.B vorbisgain
|
|
calculates the ReplayGain values for the named Ogg Vorbis input files and
|
|
@@ -27,7 +24,6 @@
|
|
uses a default target level of 89 dB, rather than the 83 dB recommended by the
|
|
ReplayGain standard, when calculating the gain to apply. (Some players include
|
|
a pre-amplification setting with which the target level can be changed.)
|
|
-
|
|
.PP
|
|
.B vorbisgain
|
|
input files must be Ogg Vorbis I files with 1 or 2 channels and a sample rate
|
|
@@ -35,21 +31,16 @@
|
|
kHz. If an input file contains multiple streams (i.e., it is chained), the
|
|
streams must all have the same format, in terms of sampling frequency and
|
|
number of channels.
|
|
-
|
|
.PP
|
|
All streams in a chained file are processed, but the ReplayGain tags are
|
|
only written to (or removed from) the first stream.
|
|
-
|
|
.SH OPTIONS
|
|
-
|
|
.IP "-h, --help"
|
|
Show command help.
|
|
-
|
|
.IP "-a, --album"
|
|
Activates album mode, in which the album gain (sometimes called the audiophile
|
|
gain) is calculated in addition to the track gain (sometimes called the radio
|
|
gain).
|
|
-
|
|
.IP "-g n, --album-gain=n"
|
|
Sets the album gain value to use. Default is to calculate it, if
|
|
.I -a
|
|
@@ -59,38 +50,31 @@
|
|
dB, specifying the
|
|
.B change
|
|
in volume that should be applied.
|
|
-
|
|
.IP "-c, --clean"
|
|
Remove any ReplayGain tags from the specified files. If a file does not
|
|
contain any ReplayGain tags, the file is not modified.
|
|
-
|
|
.IP "-C, --convert"
|
|
Convert old format ReplayGain tags to a new format (see section TAG FORMAT
|
|
below for details). If a file does not contain all ReplayGain tags that are
|
|
needed for a conversion, the file is not modified. The album peak tag is
|
|
only created if
|
|
.I -a
|
|
-is specified, and the album gain value is then checked for concistency.
|
|
+is specified, and the album gain value is then checked for consistency.
|
|
Otherwise any album gain is converted without any checks.
|
|
-
|
|
.IP "-d, --display-only"
|
|
Display the result only; do not write anything to disk. This applies to all
|
|
options.
|
|
-
|
|
.IP "-f, --fast"
|
|
Only calculate the gain for files that do not contain all replay gain tags
|
|
needed (the album gain and peak tags are only considered if
|
|
.I -a
|
|
has been specified).
|
|
-
|
|
.IP "-n, --no-progress"
|
|
Only display results, but don't show progress in percentages and times. This
|
|
can be useful if the output is piped into other programs.
|
|
-
|
|
.IP "-q, --quiet"
|
|
Do not display any output while processing. Only error and warning messages will
|
|
be printed.
|
|
-
|
|
.IP "-r, --recursive"
|
|
Enter directories (recursively) and search for files, if directories or file
|
|
patterns are specified.
|
|
@@ -98,65 +82,51 @@
|
|
Only available if
|
|
.B vorbisgain
|
|
was configured with --enable-recursive.
|
|
-
|
|
-.IP "-s, --silent"
|
|
-Sliently skip any non-Vorbis files found. Vorbis files that can't be processed
|
|
+.IP "-s, --skip"
|
|
+Silently skip any non-Vorbis files found. Vorbis files that can't be processed
|
|
for some reason are skipped as well, though not silently. Default is to stop
|
|
when such files are encountered.
|
|
-
|
|
.IP "-v, --version"
|
|
Display the version of the program.
|
|
-
|
|
.SH EXAMPLES
|
|
-
|
|
Simplest version. Calculate the track gain and peak only.
|
|
.PP
|
|
.RS
|
|
vorbisgain somefile.ogg
|
|
.RE
|
|
-
|
|
.PP
|
|
Note that the following examples are only possible if
|
|
.B vorbisgain
|
|
was configured with --enable-recursive.
|
|
-
|
|
.PP
|
|
Calculate the album gain and peak, in addition to the track gain and peak, for
|
|
all .ogg files in the directory "music" (and all subdirectories). All files in
|
|
one directory are treated as belonging to the same album. Files that already
|
|
have ReplayGain tags are not re-calculated. Note the quotes, as they cause the
|
|
shell to not do any filename globbing:
|
|
-
|
|
.PP
|
|
.RS
|
|
vorbisgain -a -f -r "music/*.ogg"
|
|
.RE
|
|
-
|
|
.PP
|
|
Calculate the album gain. The files specified before the directory "album"
|
|
are treated as one album, the files in the directory "album" as another
|
|
album and the remaining files as a third album:
|
|
-
|
|
.PP
|
|
.RS
|
|
vorbisgain -a -r a.ogg b.ogg c.ogg album d.ogg e.ogg f.ogg
|
|
.RE
|
|
-
|
|
.PP
|
|
Remove all replaygain tags from a collection of oggs:
|
|
-
|
|
.PP
|
|
.RS
|
|
vorbisgain -c -r "music/*.ogg"
|
|
.RE
|
|
-
|
|
.SH TAG FORMAT
|
|
-
|
|
.B vorbisgain
|
|
creates tags like these (when in
|
|
.I -a
|
|
mode):
|
|
-
|
|
.PP
|
|
.RS
|
|
REPLAYGAIN_TRACK_GAIN=-7.03 dB
|
|
@@ -170,18 +140,15 @@
|
|
.RS
|
|
REPLAYGAIN_ALBUM_PEAK=1.21822226
|
|
.RE
|
|
-
|
|
.PP
|
|
Gain specifies how much the volume should be changed before playback, in dB.
|
|
Peak is the maximum sample value of the file before any gain has been
|
|
applied, where 1.0 means "full sample value" (32,767 when decoding to signed
|
|
16 bit samples).
|
|
-
|
|
.PP
|
|
Earlier versions of
|
|
.B vorbisgain
|
|
(before 0.30) created the following tags:
|
|
-
|
|
.PP
|
|
.RS
|
|
RG_RADIO
|
|
@@ -192,7 +159,6 @@
|
|
.RS
|
|
RG_AUDIOPHILE
|
|
.RE
|
|
-
|
|
.PP
|
|
When
|
|
.I -c
|
|
@@ -200,44 +166,44 @@
|
|
REPLAYGAIN_TRACK_PEAK, RG_AUDIOPHILE to REPLAYGAIN_ALBUM_GAIN and
|
|
REPLAYGAIN_ALBUM_PEAK is calculated as the maximum of all RG_PEAK tags in
|
|
the album.
|
|
-
|
|
.SH AUTHORS
|
|
-
|
|
.TP
|
|
Program Code:
|
|
.br
|
|
Gian-Carlo Pascutto <gcp@sjeng.org>
|
|
.br
|
|
Magnus Holmgren <lear@algonet.se>
|
|
-
|
|
.TP
|
|
ReplayGain Analysis Code:
|
|
.br
|
|
Glen Sawyer <glensawyer@hotmail.com>
|
|
.br
|
|
Frank Klemm (http://www.uni-jena.de/~pfk/)
|
|
-
|
|
.TP
|
|
Man Page:
|
|
.br
|
|
Magnus Holmgren <lear@algonet.se>
|
|
-
|
|
.SH BUGS
|
|
-
|
|
None known.
|
|
-
|
|
.SH SEE ALSO
|
|
-
|
|
.TP
|
|
http://sjeng.org/vorbisgain.html
|
|
Home page for VorbisGain. The latest version, and a Windows executable,
|
|
can be found here.
|
|
-
|
|
.TP
|
|
http://www.replaygain.org/
|
|
Contains detailed information about ReplayGain and how it is calculated.
|
|
-
|
|
.TP
|
|
http://www.hydrogenaudio.org/
|
|
Discussion forum for audio compression and related issues, including Ogg
|
|
Vorbis and VorbisGain.
|
|
+.SH NOTE
|
|
+The version of vorbisgain packaged for Debian differs in two ways from
|
|
+the upstream version. First, it does not retain the modification time
|
|
+of the input file: if tags are changed in a file, the mtime will change.
|
|
+Second, it does not try to process wildcards in filenames. This makes
|
|
+it impossible to say "process all foo*.ogg in all subdirectories", but
|
|
+also avoids problems with filenames that actually contain wildcards.
|
|
+Without this change, "vorbisgain *.ogg" in a directory with a file that
|
|
+contains a question mark would result in that file being treated as
|
|
+being in a different album.
|