audio/mktoc: New maintainer, add man page.

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

7 files changed, 523 insertions, 29 deletions

diff --git a/audio/mktoc/README b/audio/mktoc/README
index 721110c063f8..c0075b4bc715 100644
--- a/audio/mktoc/README
+++ b/audio/mktoc/README
@@ -1,3 +1,5 @@
+mktoc (create TOC files for audio CDs)
+
 mktoc simplifies the steps needed to create audio CD TOC files for the
 cdrdao CD burning program. For users familiar with ExactAudioCopy or
 CdrWin, TOC files are synonymous with CUE sheets. The primary goal of
diff --git a/audio/mktoc/lose_not_loose.diff b/audio/mktoc/lose_not_loose.diff
new file mode 100644
index 000000000000..6cb416e78d55
--- /dev/null
+++ b/audio/mktoc/lose_not_loose.diff
@@ -0,0 +1,48 @@
+diff -Naur mktoc-1.3/PKG-INFO mktoc-1.3.patched/PKG-INFO
+--- mktoc-1.3/PKG-INFO	2012-02-15 03:17:11.000000000 -0500
++++ mktoc-1.3.patched/PKG-INFO	2018-01-11 16:08:24.427887735 -0500
+@@ -132,7 +132,7 @@
+               mktoc -f cue_file.cue -o toc_file.toc
+         
+         5. Tell mktoc to ignore missing WAV file errors. There is a potential that
+-           the result TOC file will cause cdrdao to loose pregap information during
++           the result TOC file will cause cdrdao to lose pregap information during
+            the burn process (see above)::
+         
+               mktoc -a cue_file.cue
+diff -Naur mktoc-1.3/README mktoc-1.3.patched/README
+--- mktoc-1.3/README	2012-02-15 03:17:11.000000000 -0500
++++ mktoc-1.3.patched/README	2018-01-11 16:08:16.662887722 -0500
+@@ -123,7 +123,7 @@
+       mktoc -f cue_file.cue -o toc_file.toc
+ 
+ 5. Tell mktoc to ignore missing WAV file errors. There is a potential that
+-   the result TOC file will cause cdrdao to loose pregap information during
++   the result TOC file will cause cdrdao to lose pregap information during
+    the burn process (see above)::
+ 
+       mktoc -a cue_file.cue
+diff -Naur mktoc-1.3/mktoc/__init__.py mktoc-1.3.patched/mktoc/__init__.py
+--- mktoc-1.3/mktoc/__init__.py	2011-08-02 05:25:42.000000000 -0400
++++ mktoc-1.3.patched/mktoc/__init__.py	2018-01-11 16:08:14.032887717 -0500
+@@ -129,7 +129,7 @@
+          mktoc -f cue_file.cue -o toc_file.toc
+ 
+    5. Tell mktoc to ignore missing WAV file errors. There is a potential that
+-      the result TOC file will cause cdrdao to loose pregap information during
++      the result TOC file will cause cdrdao to lose pregap information during
+       the burn process (see above)::
+ 
+          mktoc -a cue_file.cue
+diff -Naur mktoc-1.3/mktoc.egg-info/PKG-INFO mktoc-1.3.patched/mktoc.egg-info/PKG-INFO
+--- mktoc-1.3/mktoc.egg-info/PKG-INFO	2012-02-15 03:17:11.000000000 -0500
++++ mktoc-1.3.patched/mktoc.egg-info/PKG-INFO	2018-01-11 16:08:20.536887728 -0500
+@@ -132,7 +132,7 @@
+               mktoc -f cue_file.cue -o toc_file.toc
+         
+         5. Tell mktoc to ignore missing WAV file errors. There is a potential that
+-           the result TOC file will cause cdrdao to loose pregap information during
++           the result TOC file will cause cdrdao to lose pregap information during
+            the burn process (see above)::
+         
+               mktoc -a cue_file.cue
diff --git a/audio/mktoc/mktoc.1 b/audio/mktoc/mktoc.1
new file mode 100644
index 000000000000..1da933e1703d
--- /dev/null
+++ b/audio/mktoc/mktoc.1
@@ -0,0 +1,257 @@
+.\" Man page generated from reStructuredText.
+.
+.TH MKTOC 1 "2018-01-11" "1.3" "SlackBuilds.org"
+.SH NAME
+mktoc \- create TOC files for audio CDs
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.\" RST source for mktoc(1) man page. Convert with:
+.
+.\" rst2man.py mktoc.rst > mktoc.1
+.
+.\" rst2man.py comes from the SBo development/docutils package.
+.
+.\" Upstream's README is already RST, I just added some stuff to make
+.
+.\" it format in man page style.
+.
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+mktoc [OPTIONS] < CUE_FILE
+mktoc [OPTIONS] [[\-f] CUE_FILE] [[\-o] TOC_FILE]
+mktoc [OPTIONS] \-w WAV_FILES [[\-o] TOC_FILE]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.\" Mktoc // (c) 2011, Patrick C. McGinty
+.
+.\" mktoc[@]tuxcoder[dot]com
+.
+.sp
+Mktoc simplifies the steps needed to create audio CD TOC files for the
+cdrdao CD burning program. For users familiar with ExactAudioCopy or CdrWin,
+TOC files are synonymous with CUE sheets. The primary goal of mktoc is to
+create TOC files using a previously generated CUE sheet.
+.SH FEATURES
+.INDENT 0.0
+.IP \(bu 2
+Create a TOC file from a list of WAV files.
+.IP \(bu 2
+Convert an ExactAudioCopy (EAC) CUE file to the TOC format that
+is usable by cdrdao.
+.IP \(bu 2
+Multi\-session aware CUE parsing, necessary for making CDDB and
+AccurateRip matchable discs.
+.IP \(bu 2
+Non\-compliant CUE sheet support.
+.IP \(bu 2
+Support for various pregap methods.
+.IP \(bu 2
+Can create offset corrected WAV files for true \(aqbit\-for\-bit\(aq
+accurate copies.
+.IP \(bu 2
+Fuzzy file name logic can correct common file name spelling
+variations.
+.IP \(bu 2
+Workaround known TOC file parsing bugs in cdrdao.
+.UNINDENT
+.SH USAGE
+.sp
+\fBCUE_FILE\fP must contain a valid CUE format. When \fB*_FILE\fP is not
+provided, the program will read from \fBSTDIN\fP\&. All output will be sent to
+\fBSTDOUT\fP\&.
+.sp
+All attempts will be made to preserve any and all information from the input
+file. For any case where the CUE file contains unknown or bad values, the
+user will be notified on \fBSTDERR\fP\&.
+.SH OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-version
+show program\(aqs version number and exit
+.TP
+.B \-h
+show help message and exit
+.TP
+.B \-\-help
+show detailed usage instructions and exit
+.TP
+.B \-a\fP,\fB  \-\-allow\-missing\-wav
+do not abort when WAV file(s) are missing, (experts only). It is possible
+when using this option that a bug in cdrdao will create a CD that ignores
+the pregap definitions in the TOC file.  Only use this option if the CUE
+file does not contain pregaps, or if you do not wish to retain the pregap
+information.
+.TP
+.BI \-c \ <WAV_OFFSET>\fP,\fB \ \-\-offset\-correction\fB= <WAV_OFFSET>
+correct reader/writer offset by creating WAV file(s) shifted by
+WAV_OFFSET samples (original data is not modified)
+.TP
+.B \-d\fP,\fB  \-\-debug
+enable debugging statements
+.TP
+.BI \-f \ <CUE_FILE>\fP,\fB \ \-\-file\fB= <CUE_FILE>
+specify the input CUE file to read
+.TP
+.B \-m\fP,\fB  \-\-multi
+for safety, this option must be set when creating a mulit\-session TOC
+file
+.TP
+.BI \-o \ <TOC_FILE>\fP,\fB \ \-\-output\fB= <TOC_FILE>
+specify the output TOC file to write
+.TP
+.B \-t\fP,\fB  \-\-use\-temp
+write offset corrected WAV files to /tmp directory
+.TP
+.B \-w\fP,\fB  \-\-wave
+write a TOC file using list of WAV files
+.TP
+.B \-z\fP,\fB  \-\-no\-multi
+disable multi\-session support; program assumes TOC will be written in
+single\-session mode
+.UNINDENT
+.SH EXAMPLES
+.INDENT 0.0
+.IP 1. 3
+Create a TOC file from a set of WAV files:
+.INDENT 3.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+mktoc \-w *.wav
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.IP 2. 3
+Write a TOC file to \fBtoc_file.toc\fP, from a set of WAV files:
+.INDENT 3.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+mktoc \-w *.wav toc_file.toc
+mktoc \-w *.wav > toc_file.toc
+mktoc \-w *.wav \-o toc_file.toc
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.IP 3. 3
+Create a TOC file from a valid CUE file:
+.INDENT 3.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+mktoc cue_file.cue
+mktoc < cue_file.cue
+mktoc \-f cue_file.cue
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.IP 4. 3
+Write a TOC file to \fBtoc_file.toc\fP, given an input CUE file:
+.INDENT 3.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+mktoc cue_file.cue toc_file.toc
+mktoc < cue_file.cue > toc_file.toc
+mktoc \-f cue_file.cue \-o toc_file.toc
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.IP 5. 3
+Tell mktoc to ignore missing WAV file errors. There is a potential that
+the result TOC file will cause cdrdao to lose pregap information during
+the burn process (see above):
+.INDENT 3.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+mktoc \-a cue_file.cue
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.IP 6. 3
+Adjust WAV files for a CD writer offset value. For example, if your CD
+writer has a \-30 sample write offset, it can be corrected by offsetting
+the input WAV files by +30 samples. New WAV files will be placed in the
+working directory in a new dir called \fBwav+30\fP:
+.INDENT 3.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+mktoc \-c 30 < cue_file.cue
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.IP 7. 3
+Adjust WAV files for a CD writer offset value, but create new files in
+the \fB/tmp\fP directory:
+.INDENT 3.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+mktoc \-c 30 \-t < cue_file.cue
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SH CONTACT
+.SS E\-mail
+.nf
+mktoc[@]tuxcoder[dot]com
+.fi
+.sp
+.SS Info
+.nf
+\fI\%http://packages.python.org/mktoc/\fP
+\fI\%https://github.com/cmcginty/mktoc\fP
+\fI\%http://blog.tuxcoder.com\fP
+.fi
+.sp
+.\" Generated by docutils manpage writer.
+.
diff --git a/audio/mktoc/mktoc.SlackBuild b/audio/mktoc/mktoc.SlackBuild
index 957cd26686a0..d6694b7362af 100644
--- a/audio/mktoc/mktoc.SlackBuild
+++ b/audio/mktoc/mktoc.SlackBuild
@@ -2,16 +2,29 @@
 
 # Slackware build script for mktoc
 
-# Written by Luis Henrique <lmello.009@gmail.com>
+# Written by Luis Henrique <email removed>
+# Now maintained by B. Watson <yalhcru@gmail.com>
+
+# Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details.
+
+# 20180111 bkw:
+# - take over maintenance
+# - BUILD=2
+# - i486 => i586
+# - don't include the install instructions in the package
+# - get rid of some useless boilerplate
+# - fix upstream typo/illiteracy: you LOSE information, you don't LOOSE it!
+#   (sorry, this is a pet peeve, I can't not fix it)
+# - add man page, basically upstream's README
 
 PRGNAM=mktoc
 VERSION=${VERSION:-1.3}
-BUILD=${BUILD:-1}
+BUILD=${BUILD:-2}
 TAG=${TAG:-_SBo}
 
 if [ -z "$ARCH" ]; then
   case "$( uname -m )" in
-    i?86) ARCH=i486 ;;
+    i?86) ARCH=i586 ;;
     arm*) ARCH=arm ;;
        *) ARCH=$( uname -m ) ;;
   esac
@@ -22,19 +35,8 @@ TMP=${TMP:-/tmp/SBo}
 PKG=$TMP/package-$PRGNAM
 OUTPUT=${OUTPUT:-/tmp}
 
-if [ "$ARCH" = "i486" ]; then
-  SLKCFLAGS="-O2 -march=i486 -mtune=i686"
-  LIBDIRSUFFIX=""
-elif [ "$ARCH" = "i686" ]; then
-  SLKCFLAGS="-O2 -march=i686 -mtune=i686"
-  LIBDIRSUFFIX=""
-elif [ "$ARCH" = "x86_64" ]; then
-  SLKCFLAGS="-O2 -fPIC"
-  LIBDIRSUFFIX="64"
-else
-  SLKCFLAGS="-O2"
-  LIBDIRSUFFIX=""
-fi
+# 20180111 bkw: No CFLAGS here, this is pure Python code. Would be noarch,
+# except for the lib vs lib64 thing.
 
 set -e
 
@@ -45,21 +47,20 @@ rm -rf $PRGNAM-$VERSION
 tar xvf $CWD/$PRGNAM-$VERSION.tar.gz
 cd $PRGNAM-$VERSION
 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 600 -o -perm 444 -o -perm 440 -o -perm 400 \) \
- -exec chmod 644 {} \;
+find . -type d -print0 | xargs -0 chmod 755
+find . -type f -print0 | xargs -0 chmod 644
+
+# You know, I never saw the "loose" for "lose" typo until the internet
+# age. Does that mean computers make people illiterate?
+patch -p1 < $CWD/lose_not_loose.diff
 
 python setup.py install --root=$PKG
 
-find $PKG | xargs file | grep -e "executable" -e "shared object" | grep ELF \
-  | cut -f 1 -d : | xargs strip --strip-unneeded 2> /dev/null || true
+mkdir -p $PKG/usr/man/man1
+gzip -9c $CWD/$PRGNAM.1 > $PKG/usr/man/man1/$PRGNAM.1.gz
 
 mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
-cp -a \
-  CHANGELOG.rst LICENSE INSTALL.rst PKG-INFO README \
-  $PKG/usr/doc/$PRGNAM-$VERSION
+cp -a CHANGELOG.rst LICENSE PKG-INFO README $PKG/usr/doc/$PRGNAM-$VERSION
 cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild
 
 mkdir -p $PKG/install
diff --git a/audio/mktoc/mktoc.info b/audio/mktoc/mktoc.info
index 6ba7157edbc5..7f733d298098 100644
--- a/audio/mktoc/mktoc.info
+++ b/audio/mktoc/mktoc.info
@@ -6,5 +6,5 @@ MD5SUM="2eabcdc8c9433d1a398e113b8a8299b4"
 DOWNLOAD_x86_64=""
 MD5SUM_x86_64=""
 REQUIRES="python-chardet"
-MAINTAINER="Luis Henrique"
-EMAIL="lmello.009@gmail.com"
+MAINTAINER="B. Watson"
+EMAIL="yalhcru@gmail.com"
diff --git a/audio/mktoc/mktoc.rst b/audio/mktoc/mktoc.rst
new file mode 100644
index 000000000000..3a5414aa285d
--- /dev/null
+++ b/audio/mktoc/mktoc.rst
@@ -0,0 +1,186 @@
+.. RST source for mktoc(1) man page. Convert with:
+..   rst2man.py mktoc.rst > mktoc.1
+.. rst2man.py comes from the SBo development/docutils package.
+
+.. Upstream's README is already RST, I just added some stuff to make
+.. it format in man page style.
+
+.. |version| replace:: 1.3
+.. |date| date::
+
+=====
+mktoc
+=====
+
+------------------------------
+create TOC files for audio CDs
+------------------------------
+
+:Manual section: 1
+:Manual group: SlackBuilds.org
+:Date: |date|
+:Version: |version|
+
+SYNOPSIS
+========
+::
+
+   mktoc [OPTIONS] < CUE_FILE
+   mktoc [OPTIONS] [[-f] CUE_FILE] [[-o] TOC_FILE]
+   mktoc [OPTIONS] -w WAV_FILES [[-o] TOC_FILE]
+
+
+DESCRIPTION
+===========
+
+.. Mktoc // (c) 2011, Patrick C. McGinty
+.. mktoc[@]tuxcoder[dot]com
+
+Mktoc simplifies the steps needed to create audio CD TOC files for the
+cdrdao CD burning program. For users familiar with ExactAudioCopy or CdrWin,
+TOC files are synonymous with CUE sheets. The primary goal of mktoc is to
+create TOC files using a previously generated CUE sheet.
+
+Features
+========
+
+* Create a TOC file from a list of WAV files.
+* Convert an ExactAudioCopy (EAC) CUE file to the TOC format that
+  is usable by cdrdao.
+* Multi-session aware CUE parsing, necessary for making CDDB and
+  AccurateRip matchable discs.
+* Non-compliant CUE sheet support.
+* Support for various pregap methods.
+* Can create offset corrected WAV files for true 'bit-for-bit'
+  accurate copies.
+* Fuzzy file name logic can correct common file name spelling
+  variations.
+* Workaround known TOC file parsing bugs in cdrdao.
+
+Usage
+=====
+
+``CUE_FILE`` must contain a valid CUE format. When ``*_FILE`` is not
+provided, the program will read from ``STDIN``. All output will be sent to
+``STDOUT``.
+
+All attempts will be made to preserve any and all information from the input
+file. For any case where the CUE file contains unknown or bad values, the
+user will be notified on ``STDERR``.
+
+Options
+=======
+
+--version
+
+   show program's version number and exit
+
+-h
+
+   show help message and exit
+
+--help
+
+   show detailed usage instructions and exit
+
+-a, --allow-missing-wav
+
+   do not abort when WAV file(s) are missing, (experts only). It is possible
+   when using this option that a bug in cdrdao will create a CD that ignores
+   the pregap definitions in the TOC file.  Only use this option if the CUE
+   file does not contain pregaps, or if you do not wish to retain the pregap
+   information.
+
+-c <WAV_OFFSET>, --offset-correction=<WAV_OFFSET>
+
+   correct reader/writer offset by creating WAV file(s) shifted by
+   WAV_OFFSET samples (original data is not modified)
+
+-d, --debug
+
+   enable debugging statements
+
+-f <CUE_FILE>, --file=<CUE_FILE>
+
+   specify the input CUE file to read
+
+-m, --multi
+
+   for safety, this option must be set when creating a mulit-session TOC
+   file
+
+-o <TOC_FILE>, --output=<TOC_FILE>
+
+   specify the output TOC file to write
+
+-t, --use-temp
+
+   write offset corrected WAV files to /tmp directory
+
+-w, --wave
+
+   write a TOC file using list of WAV files
+
+-z, --no-multi
+
+   disable multi-session support; program assumes TOC will be written in
+   single-session mode
+
+Examples
+========
+
+1. Create a TOC file from a set of WAV files::
+
+      mktoc -w *.wav
+
+2. Write a TOC file to ``toc_file.toc``, from a set of WAV files::
+
+      mktoc -w *.wav toc_file.toc
+      mktoc -w *.wav > toc_file.toc
+      mktoc -w *.wav -o toc_file.toc
+
+3. Create a TOC file from a valid CUE file::
+
+      mktoc cue_file.cue
+      mktoc < cue_file.cue
+      mktoc -f cue_file.cue
+
+4. Write a TOC file to ``toc_file.toc``, given an input CUE file::
+
+      mktoc cue_file.cue toc_file.toc
+      mktoc < cue_file.cue > toc_file.toc
+      mktoc -f cue_file.cue -o toc_file.toc
+
+5. Tell mktoc to ignore missing WAV file errors. There is a potential that
+   the result TOC file will cause cdrdao to lose pregap information during
+   the burn process (see above)::
+
+      mktoc -a cue_file.cue
+
+6. Adjust WAV files for a CD writer offset value. For example, if your CD
+   writer has a -30 sample write offset, it can be corrected by offsetting
+   the input WAV files by +30 samples. New WAV files will be placed in the
+   working directory in a new dir called ``wav+30``::
+
+      mktoc -c 30 < cue_file.cue
+
+7. Adjust WAV files for a CD writer offset value, but create new files in
+   the ``/tmp`` directory::
+
+      mktoc -c 30 -t < cue_file.cue
+
+Contact
+=======
+
+E-mail
+------
+
+|  mktoc[@]tuxcoder[dot]com
+
+Info
+----
+
+|  http://packages.python.org/mktoc/
+|  https://github.com/cmcginty/mktoc
+|  http://blog.tuxcoder.com
+
diff --git a/audio/mktoc/slack-desc b/audio/mktoc/slack-desc
index 5ad9c0f74f9b..6bef9b178e1f 100644
--- a/audio/mktoc/slack-desc
+++ b/audio/mktoc/slack-desc
@@ -6,7 +6,7 @@
 # customary to leave one space after the ':' except on otherwise blank lines.
 
      |-----handy-ruler------------------------------------------------------|
-mktoc: mktoc (Simple tool to create TOC files)
+mktoc: mktoc (create TOC files for audio CDs)
 mktoc:
 mktoc: mktoc simplifies the steps needed to create audio CD TOC files for
 mktoc: the cdrdao CD burning program.