audio/mp3gain: Update man page.

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

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

5 files changed, 55 insertions, 60 deletions

diff --git a/audio/mp3gain/README b/audio/mp3gain/README
index 7702e1a6db..c54a51af7c 100644
--- a/audio/mp3gain/README
+++ b/audio/mp3gain/README
@@ -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.
diff --git a/audio/mp3gain/mp3gain.1 b/audio/mp3gain/mp3gain.1
index a4aa917eeb..f971cf9402 100644
--- a/audio/mp3gain/mp3gain.1
+++ b/audio/mp3gain/mp3gain.1
@@ -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
diff --git a/audio/mp3gain/mp3gain.SlackBuild b/audio/mp3gain/mp3gain.SlackBuild
index d9bbe7b837..e768fea4b2 100644
--- a/audio/mp3gain/mp3gain.SlackBuild
+++ b/audio/mp3gain/mp3gain.SlackBuild
@@ -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
diff --git a/audio/mp3gain/mp3gain.info b/audio/mp3gain/mp3gain.info
index 8d92d4817d..97f1fe254e 100644
--- a/audio/mp3gain/mp3gain.info
+++ b/audio/mp3gain/mp3gain.info
@@ -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=""
diff --git a/audio/mp3gain/slack-desc b/audio/mp3gain/slack-desc
index 9214f6bac3..54d1c1c115 100644
--- a/audio/mp3gain/slack-desc
+++ b/audio/mp3gain/slack-desc
@@ -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.