audio/mp3gain: Update man page.

Signed-off-by: B. Watson <yalhcru@gmail.com>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
This commit is contained in:
B. Watson 2021-11-21 16:48:48 -05:00 committed by Willy Sudiarto Raharjo
parent 0e2ddd1b3c
commit 08c93ef22e
No known key found for this signature in database
GPG key ID: 3F617144D7238786
5 changed files with 55 additions and 60 deletions

View file

@ -2,7 +2,7 @@ mp3gain (adjusts mp3 files so they have the same volume)
MP3Gain does not just do peak normalization, as many normalizers
do. Instead, it does some statistical analysis to determine how loud
the file actually sounds to the human ear. Also, the changes MP3Gain
the file actually sounds to the human ear. Also, the changes MP3Gain
makes are completely lossless. There is no quality lost in the change
because the program adjusts the mp3 file directly, without decoding
and re-encoding.

View file

@ -1,4 +1,4 @@
.TH MP3GAIN "1" "Jan 2018" "mp3gain version 1.6.1" "SlackBuilds.org"
.TH MP3GAIN "1" "Nov 2021" "mp3gain-1.6.2" "SlackBuilds.org"
.SH NAME
mp3gain \- analyzes and adjusts mp3 files so that they have the same volume
.SH SYNOPSIS
@ -10,97 +10,97 @@ MP3Gain analyzes and adjusts mp3 files so that they have the same volume.
.PP
MP3Gain does not just do peak normalization, as many normalizers do. Instead, it does some statistical analysis to determine how loud the file actually sounds to the human ear.
.PP
Also, the changes MP3Gain makes are completely lossless. There is no quality lost in the change because the program adjusts the mp3 file directly, without decoding and re-encoding.
Also, the changes MP3Gain makes are completely lossless. There is no quality lost in the change because the program adjusts the mp3 file directly, without decoding and re\-encoding.
.SH OPTIONS
.TP
\fB\-v\fR
show version number
.TP
\fB\-g\fR <i>
apply gain i to mp3 without doing any analysis
\fB\-g\fR \fIgain\fR
apply \fIgain\fR to mp3 without doing any analysis.
.TP
\fB\-l\fR 0 <i>
apply gain i to channel 0 (left channel) of mp3
\fB\-l\fR 0 \fIgain\fR
apply \fIgain\fR to channel 0 (left channel) of mp3
without doing any analysis (ONLY works for STEREO mp3s,
not Joint Stereo mp3s)
not Joint Stereo mp3s).
.TP
\fB\-l\fR 1 <i>
apply gain i to channel 1 (right channel) of mp3
\fB\-l\fR 1 \fIgain\fR
apply \fIgain\fR to channel 1 (right channel) of mp3.
.TP
\fB\-e\fR 1 <i>
skip Album analysis, even if multiple files listed
\fB\-e\fR
skip album analysis, even if multiple files listed.
.TP
\fB\-r\fR
apply Track gain automatically (all files set to equal loudness)
apply track gain automatically (all files set to equal loudness).
.TP
\fB\-k\fR
automatically lower Track/Album gain to not clip audio
automatically lower track/album gain to not clip audio.
.TP
\fB\-a\fR
apply Album gain automatically (files are all from the same
apply album gain automatically (files are all from the same
album: a single gain change is applied to all files, so
their loudness relative to each other remains unchanged,
but the average album loudness is normalized)
but the average album loudness is normalized).
.TP
\fB\-m\fR <i>
modify suggested MP3 gain by integer i
\fB\-m\fR \fIgain\fR
modify suggested MP3 gain by integer \fIgain\fR.
.TP
\fB\-d\fR <n>
modify suggested dB gain by floating\-point n
\fB\-d\fR \fIdbgain\fR
modify suggested dB gain by floating\-point \fIdbgain\fR.
.TP
\fB\-c\fR
ignore clipping warning when applying gain
ignore clipping warning when applying gain.
.TP
\fB\-o\fR
output is a database\-friendly tab\-delimited list
output is a database\-friendly tab\-delimited list.
.TP
\fB\-t\fR
mp3gain writes modified mp3 to temp file, then deletes original
instead of modifying bytes in original file
instead of modifying bytes in original file (default).
.TP
\fB\-T\fR
Assume input file is an MPEG 2 Layer III file (i.e. don't check for mis-named Layer I or Layer II files)
mp3gain directly modifies mp3 file (opposite of \-t).
.TP
\fB\-q\fR
Quiet mode: no status messages
quiet mode: no status messages.
.TP
\fB\-p\fR
Preserve original file timestamp
preserve original file timestamp.
.TP
\fB\-x\fR
Only find max. amplitude of mp3
only find max. amplitude of mp3.
.TP
\fB\-f\fR
Force mp3gain to assume input file is an MPEG 2 Layer III file
(i.e. don't check for mis\-named Layer I or Layer II files)
force mp3gain to assume input file is an MPEG 2 Layer III file
(i.e. don't check for mis\-named Layer I or Layer II files).
.TP
\-? or \fB\-h\fR
show built-in help message
show built\-in help message.
.TP
\fB\-s\fR c
only check stored tag info (no other processing)
\fB\-s c\fR
only check stored tag info (no other processing).
.TP
\fB\-s\fR d
delete stored tag info (no other processing)
\fB\-s d\fR
delete stored tag info (no other processing).
.TP
\fB\-s\fR s
skip (ignore) stored tag info (do not read or write tags)
\fB\-s s\fR
skip (ignore) stored tag info (do not read or write tags).
.TP
\fB\-s\fR r
force re\-calculation (do not read tag info)
\fB\-s r\fR
force re\-calculation (do not read tag info).
.TP
\fB\-s\fR i
use ID3v2 tag for MP3 gain info
\fB\-s i\fR
use ID3v2 tag for MP3 gain info.
.TP
\fB\-s\fR a
use APE tag for MP3 gain info (default)
\fB\-s a\fR
use APE tag for MP3 gain info (default).
.TP
\fB\-u\fR
undo changes made by mp3gain (based on stored tag info)
undo changes made by mp3gain (based on stored tag info).
.TP
\fB\-w\fR
"wrap" gain change if gain+change > 255 or gain+change < 0
(use "\-? wrap" switch for a complete explanation)
(use "\-h wrap" switch for a complete explanation).
.PP
If you specify \fB\-r\fR and \fB\-a\fR, only the second one will work.
If you do not specify \fB\-c\fR, the program will stop and ask before
@ -108,16 +108,16 @@ applying gain change to a file that might clip.
.SH AUTHORS
Coding by Glen Sawyer
.br
Unix-ification by Stefan Partheymüller
Unix\-ification by Stefan Partheymüller
.br
DLL-ification by John Zitterkopf
DLL\-ification by John Zitterkopf
.br
Additional tweaks by Artur Polaczynski, Mark Armbrust, and others
.PP
Man page created by B. Watson for the SlackBuilds.org project, but may
be used by others.
.SH COPYRIGHT
Copyright(c) 2001-2004 by Glen Sawyer.
Copyright(c) 2001\-2004 by Glen Sawyer.
.PP
mp3gain uses mpglib, which can be found at \fIhttp://www.mpg123.de\fR.
.PP

View file

@ -6,11 +6,13 @@
# Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details.
# 20211121 bkw: BUILD=2, fix a few issues with the man page.
cd $(dirname $0) ; CWD=$(pwd)
PRGNAM=mp3gain
VERSION=${VERSION:-1.6.2}
BUILD=${BUILD:-1}
BUILD=${BUILD:-2}
TAG=${TAG:-_SBo}
PKGTYPE=${PKGTYPE:-tgz}
@ -24,9 +26,6 @@ if [ -z "$ARCH" ]; then
esac
fi
# If the variable PRINT_PACKAGE_NAME is set, then this script will report what
# the name of the created package would be, and then exit. This information
# could be useful to other scripts.
if [ ! -z "${PRINT_PACKAGE_NAME}" ]; then
echo "$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE"
exit 0
@ -60,18 +59,14 @@ mkdir -p $PRGNAM
cd $PRGNAM
unzip $CWD/$PRGNAM-$SRCVER-src.zip
chown -R root:root .
find -L . \
\( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 \
-o -perm 511 \) -exec chmod 755 {} \; -o \
\( -perm 666 -o -perm 664 -o -perm 640 -o -perm 600 -o -perm 444 \
-o -perm 440 -o -perm 400 \) -exec chmod 644 {} \;
find -L . -perm /111 -a \! -perm 755 -a -exec chmod 755 {} \+ -o \
\! -perm /111 -a \! -perm 644 -a -exec chmod 644 {} \+
sed -i -e "s/^\(CFLAGS.*\)/\1 $SLKCFLAGS/" Makefile
make
strip $PRGNAM
mkdir -p $PKG/usr/bin
install -m0755 -o root -g root $PRGNAM $PKG/usr/bin
install -s -m0755 -o root -g root $PRGNAM $PKG/usr/bin
mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
cp lgpl.txt $PKG/usr/doc/$PRGNAM-$VERSION

View file

@ -1,7 +1,7 @@
PRGNAM="mp3gain"
VERSION="1.6.2"
HOMEPAGE="http://mp3gain.sourceforge.net/"
DOWNLOAD="http://downloads.sourceforge.net/mp3gain/mp3gain-1_6_2-src.zip"
DOWNLOAD="https://downloads.sourceforge.net/mp3gain/mp3gain-1_6_2-src.zip"
MD5SUM="013551d985f517d9f0d767ee51366f1b"
DOWNLOAD_x86_64=""
MD5SUM_x86_64=""

View file

@ -10,7 +10,7 @@ mp3gain: mp3gain (adjusts mp3 files so they have the same volume)
mp3gain:
mp3gain: MP3Gain does not just do peak normalization, as many normalizers
mp3gain: do. Instead, it does some statistical analysis to determine how loud
mp3gain: the file actually sounds to the human ear. Also, the changes MP3Gain
mp3gain: the file actually sounds to the human ear. Also, the changes MP3Gain
mp3gain: makes are completely lossless. There is no quality lost in the change
mp3gain: because the program adjusts the mp3 file directly, without decoding
mp3gain: and re-encoding.