audio/mac: Man page, other enhancements.

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

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

1 files changed, 169 insertions, 0 deletions

diff --git a/audio/mac/mac.1 b/audio/mac/mac.1
new file mode 100644
index 0000000000000..baaf4b0c58bbd
--- /dev/null
+++ b/audio/mac/mac.1
@@ -0,0 +1,169 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.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
+..
+.TH "MAC" 1 "2021-11-25" "3.99_u4_b5_s7" "SlackBuilds.org"
+.SH NAME
+mac \- decode/encode Monkey's Audio codec files
+.\" RST source for mac(1) man page. Convert with:
+.
+.\" rst2man.py mac.rst > mac.1
+.
+.\" rst2man.py comes from the SBo development/docutils package.
+.
+.SH SYNOPSIS
+.sp
+\fBmac\fP [\fIinput\-file\fP] [\fIoutput\-file\fP] [ [\fB\-c\fP | \fB\-n\fP ] \fIlevel\fP ]
+.sp
+\fBmac\fP [\fIinput\-file\fP] [ \fB\-d\fP | \fB\-v\fP | \fB\-q\fP ]
+.SH DESCRIPTION
+.sp
+Monkey\(aqs Audio (aka APE) is a lossless audio compression format,
+similar to FLAC. mac is a console frontend to Monkey\(aqs Audio, able to
+encode and decode APE audio files.
+.sp
+If you encode a WAV file to APE, then decode it back to WAV, the
+audio in the decoded WAV file will be byte\-for\-byte identical to the
+original (although any extra data such as tags/comments in the RIFF
+header will not be preserved).
+.SH OPTIONS
+.sp
+Note: Only one of the options below can be given, and it must occur
+last on the command line (after the filename(s)). Spaces are not
+allowed between the \fB\-c\fP or \fB\-n\fP option and its \fIlevel\fP argument.
+.INDENT 0.0
+.TP
+.B \fB\-c[level]\fP
+Compress (encode). \fIinput\-file\fP must be a WAV file with 16\-bit samples.
+\fIoutput\-file\fP will be an APE audio file. Higher \fIlevel\fPs result
+in better compression, at the expense of longer encoding time. The
+supported levels are:
+.INDENT 7.0
+.INDENT 3.5
+.INDENT 0.0
+.TP
+.B 1000
+\fI(fast)\fP, usually around 45%\-50% compression ratio.
+.TP
+.B 2000
+\fI(normal)\fP, usually around 40%\-45% compression ratio.
+.TP
+.B 3000
+\fI(high)\fP, only slightly better than 2000 (usually by 1% or so).
+.TP
+.B 4000
+\fI(very high)\fP, probably the point of diminishing returns.
+.TP
+.B 5000
+\fI(insane)\fP, takes around 3x as long as 4000, may not compress any better.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.TP
+.B \fB\-n[level]\fP
+Convert (recompress). As \fB\-c\fP, but \fBinput\-file\fP must be an APE audio
+file.
+.TP
+.B \fB\-d\fP
+Decompress (decode). \fIinput\-file\fP must be an APE audio file.
+\fIoutput\-file\fP will be a WAV file.
+.TP
+.B \fB\-v\fP
+Verify. \fIinput\-file\fP must be an APE audio file. It will be decoded, and
+any errors will be displayed, but the decoded audio won\(aqt be saved.
+.TP
+.B \fB\-q\fP
+Quick verify. Just checks that \fIinput\-file\fP has a valid APE header.
+.TP
+.B \fB\-\-help\fP
+Show built\-in usage message (same as running \fBmac\fP with no arguments).
+.UNINDENT
+.SH EXAMPLES
+.INDENT 0.0
+.TP
+.B Compress
+mac "Metallica \- One.wav" "Metallica \- One.ape" \-c2000
+.TP
+.B Decompress
+mac "Metallica \- One.ape" "Metallica \- One.wav" \-d
+.TP
+.B Verify
+mac "Metallica \- One.ape" \-v
+.TP
+.B Quick verify
+mac "Metallica \- One.ape" \-q
+.UNINDENT
+.sp
+Note that filenames with spaces and punctuation should be put inside
+quote, as usual.
+.SH NOTES
+.sp
+\fBmac\fP can only handle WAV files with 8\- or 16\-bit samples, not
+e.g. 24\-bit or floating point. If needed, you can convert to 16\-bit
+with a command like:
+.INDENT 0.0
+.INDENT 3.5
+$ sox \-G input.wav \-b16 output.wav
+.UNINDENT
+.UNINDENT
+.sp
+WAV files must have 1 or 2 channels (mono or stereo;
+quad/surround/5.1/etc are not supported). Any sampling rate is
+supported.
+.sp
+\fBffmpeg\fP(1) can decode and convert APE files, though it cannot encode
+to APE.
+.sp
+\fBmplayer\fP(1) and \fBaudacious\fP(1) can play APE files.
+.sp
+\fBfile\fP(1) knows about APE files. Example:
+.INDENT 0.0
+.INDENT 3.5
+$ file test.ape
+.sp
+test.ape: Monkey\(aqs Audio compressed format version 3990 with normal compression, stereo, sample rate 48000
+.UNINDENT
+.UNINDENT
+.SH COPYRIGHT
+.sp
+See the file /usr/doc/mac\-3.99_u4_b5_s7/License.htm for license information.
+.SH AUTHORS
+.sp
+The original Monkey\(aqs Audio Codec was written by Matthew
+T. Ashland. It was ported to Linux by Frank Klemm and SuperMMX, then
+enhanced and bugfixed by Jason Jordan.
+.sp
+This man page written for the SlackBuilds.org project
+by B. Watson, and is licensed under the WTFPL.
+.SH SEE ALSO
+.sp
+\fBffmpeg\fP(1), \fBmplayer\fP(1), \fBaudacious\fP(1), \fBflac\fP(1), \fBshorten\fP(1), \fBsox\fP(1)
+.sp
+The Monkey\(aqs Audio Codec homepage: \fI\%http://www.monkeysaudio.com/\fP
+.\" Generated by docutils manpage writer.
+.