This pkg/DESCR was a verbatim copy of the README file and, aside from being

entirely inappropriate, was _way_ too long.  Fix: install the README file into
share/doc/maplay and clip DESCR.

3 files changed, 11 insertions, 175 deletions

diff --git a/audio/maplay/Makefile b/audio/maplay/Makefile
index 0eb938eb979..2b38926c49f 100644
--- a/audio/maplay/Makefile
+++ b/audio/maplay/Makefile
@@ -3,7 +3,7 @@
 # Date created:         Feb 13 1995
 # Whom:                 jkh
 #
-# $Id: Makefile,v 1.6 1997/01/07 14:58:04 torstenb Exp $
+# $Id: Makefile,v 1.7 1998/01/25 20:44:10 torstenb Exp $
 #
 
 DISTNAME=       maplay1_2
@@ -20,4 +20,8 @@ PATCH_STRIP=	-p2
 pre-configure:
 	@(cd ${WRKSRC}; make pre-install)
 
+post-install:
+	@${MKDIR} ${PREFIX}/share/doc/maplay
+	@${INSTALL_DATA} ${WRKSRC}/README ${PREFIX}/share/doc/maplay
+
 .include <bsd.port.mk>
diff --git a/audio/maplay/pkg-descr b/audio/maplay/pkg-descr
index 5eb691764c0..2381ad3998d 100644
--- a/audio/maplay/pkg-descr
+++ b/audio/maplay/pkg-descr
@@ -1,58 +1,3 @@
-/*
- *  @(#) MPEG Audio Player maplay 1.2, last edit of this file: 6/23/94 13:02:49
- *  @(#) Copyright (C) 1993, 1994 Tobias Bading (bading@cs.tu-berlin.de)
- *  @(#) Berlin University of Technology
- *
- *  This program is free software; you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation; either version 2 of the License, or
- *  (at your option) any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program; if not, write to the Free Software
- *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- */
-
-
-This is the README file of the MPEG Audio Player maplay, Version 1.2.
-Besides this file, you should now own a copy of the following files:
-
-  ANNOUNCEMENT		the announcement for this release
-  INSTALL		infos about compiling and installing the program
-  COPYING		the GNU General Public License
-  Makefile		a makefile
-  configuration.sh	a shell script used by the makefile
-
-and the source files
-
-  all.h			maplay.cc		subband_layer_1.h
-  crc.cc		obuffer.cc		subband_layer_2.cc
-  crc.h			obuffer.h		subband_layer_2.h
-  header.cc		scalefactors.cc		synthesis_filter.cc
-  header.h		scalefactors.h		synthesis_filter.h
-  ibitstream.cc		subband.h		ulaw.cc
-  ibitstream.h		subband_layer_1.cc	ulaw.h
-
--------------------------------------------------------------------------------
-
-0) Introduction
-
-MPEG is a standard created by the ISO (International Organization for
-Standardization) and the IEC (International Electrotechnical Commission).
-The full name of this standard is "ISO/IEC DIS 11172: Information
-Technology - Coding of moving pictures and associated audio for digital
-storage media ut to about 1.5 Mbit/s". As the name already states,
-it deals with digital video and audio. The video part of this standard has
-inspired many people to write decoders and a few encoders for it.
-Best known should be the Berkeley player. Players for the audio part on
-the other hand are very rare. The ones I know are the XING player for Windoze
-and a sample implementation of the ISO, which also includes an encoder.
-
 The audio part of the MPEG standard specifies three layers, whereat each
 layer specifies its own file format. All three layers are using similar
 audio coding techniques, but they vary in efficiency and complexity.
@@ -61,126 +6,11 @@ the most. But a layer I MPEG audio stream is bigger than a layer III stream
 at the same quality. This program is able to decode and play only layer I
 and II streams, layer III is not supported (yet?!?).
 
-Like the MPEG video standard, the audio part also uses a lossy compression
-algorithm, which means that you can't get back 100% the original from a
-MPEG audio stream. Layer II MPEG audio streams are compressed by ratios
-from 1:3 up to 1:24 compared to raw PCM data, like on an audio CD.
-But the quality is still very (very) near to the original at ratios between
-1:5 and 1:12. You'll love it... :-)
-
--------------------------------------------------------------------------------
-
-1) What does maplay?
+The maplay decodes layer I and layer II MPEG audio streams and plays them
+using a CD-quality audio device or sends the to stdout normally as 16 bit
+signed PCM values, interleaved for stereo streams.
 
-maplay version 1.2 is the second release of my MPEG audio player/decoder.
-It decodes layer I and layer II MPEG audio streams and plays them
-using a CD-quality audio device. Currently supported devices are the
-dbri device of SPARC 10 computers and the audio ports of Silicon
-Graphics Indigo machines. Thanks to Louis P. Kruger (lpkruger@phoenix.
-Princeton.EDU), maplay 1.2 can also use the /dev/dsp device under Linux.
-Louis has tested it with the Pro Audio Spectrum 16 soundcard. Sound Blaster 16
-and Gravis Ultrasound cards should also work, but a bug in the dsp driver
-prevents stereo playback on Gravis Ultrasound cards. An amd device of a
-SPARC 2/IPX/... machine can be used, too, but this device is only capable of
-producing audio output at 8 kHz in u-law format, which sounds like transmitted
-through a telephone. Other audio device are not supported directly, but can be
-used with the "decode to stdout" option and an audio format converter.
-Besides it shouldn't be a problem to adapt the program to other audio devices.
-
-The player supports all modes, which are single channel, stereo,
+This player supports all modes, which are single channel, stereo,
 joint stereo and dual channel, and all bitrates except free mode.
 The missing free mode support should not be a problem for now,
 because I haven't seen such a stream yet.
-
-maplay needs approximately 46% CPU time on SPARC 10/40 machines and 50%
-on Indigos for realtime stereo playback of a 44.1 kHz 128 kbit/s stream.
-Single channel playback needs about the half CPU time. On a SPARCstation IPX,
-maplay needs about 43% CPU time for realtime mono playback. Stereo playback
-is not possible via an amd device.
-
-Besides realtime playing of audio streams, maplay can decode streams to
-stdout for further conversions. The output consists of 16 bit signed PCM
-values. For stereo streams, the values are interleaved, which means that
-a value for the left channel is followed by a value for the right channel
-and so on. If maplay has been compiled for u-law output, the output consists
-of 8 bit u-law samples at a rate of 8 kHz, no matter what frequency the stream
-uses.
-
--------------------------------------------------------------------------------
-
-2) How to create a maplay binary?
-
-Please read the install file for this topic.
-
--------------------------------------------------------------------------------
-
-3) How to start the program?
-
-For a quick mono test enter "./maplay -v -l filename", where filename is the
-name of an audio stream, like "things.mp2". This stream has been posted along
-with the sources and is the beginning of Roxette's song "Things Will Never Be
-The Same". It is coded in joint stereo mode with 128 kbit/s, which is a
-compression ratio of 1:11. If the output is ok, you can test stereo playback
-by leaving out the -l option. If the stereo output stutters, the problem is
-not enough free CPU time in most cases. Stereo output is not possible when
-using an amd u-law device. If maplay shows error messages like
-"ioctl AUDIO_GETDEV on /dev/audio: ..."
-and maplay was compiled for u-law output, please try out the -amd option.
-This option forces maplay to treat /dev/audio as an amd device and may be
-required on SPARC clones.
-
-To convert a MPEG audio stream into other audio formats, you can use
-"maplay -v -s filename | your_converter". Unfortunately, I can't be of much
-help for you to find such a converter. The only good converter I know is the
-"soundfiler" on Indigos. But if you would have an Indigo, you wouldn't need a
-converter...
-
--------------------------------------------------------------------------------
-
-4) Command line options
-
-maplay [-v] [-s] [-l] [-r] [-us] [-uh] [-ul] [-amd] [-c] [-f ushort] filename
-
-with these options:
-  filename	filename of a MPEG audio stream or - for stdin
-  -h		short help
-  -v		verbose mode
-		You will get information about the stream, like mode, bitrate,
-		copyright etc., if you use this option.
-  -s		stdout mode
-		This option tells the program to decode the stream to stdout.
-		The created output contains 16 bit signed PCM samples. If the
-		binary has been compiled for 8 kHz u-law format usage, the
-		output consists of 8 bit u-law samples at a 8 kHz rate. If the
-		stream is in stereo mode, the samples of both channels are
-		interleaved, the sample for the left channel first.
-  -l		maplay decodes (and plays) the left channel of stereo streams
-		only. This option halves the required CPU time.
-  -r		Same as above, but decodes the right channel only
-  -us, -uh	These options are available on SPARCstations only.
-		They specify where the audio signal should be send to:
-		"-us" means speaker and "-uh" headphone jack.
-  -ul		This option is available on machines with the dbri device
-		and sends the audio output to the line out jack.
-  -amd		This option forces maplay to treat /dev/audio as an amd
-		device. Use it if your SPARC clone has an amd device, but
-		maplay doesn't recognize it. You may also use this option on a
-		machine	with a dbri device, because the dbri device can also
-		produce	u-law output. But I suggest to recompile the program
-		without the ULAW define in this case to get the CD-quality
-		output.
-  -c		This option instructs the program to report filter range
-		violations to stderr. Sometimes PCM values calculated by
-		the synthesis filter exceede the 16 bit boundary and must
-		be mapped to these boundaries. If you can hear this, you
-		may use the next option.
-  -f ushort	maplay uses this scalefactor instead of the default value 32768
-		for the synthesis filter. You can reduce or eliminate range
-		violations with this option, but lower scalefactor values
-		reduce the signal-to-noise ratio, too. I can't remember when
-		I used this option the last time myself.
-
-
-Ok, that's all for now and this release,
-I hope you like it,
-                    Tobias Bading   (bading@cs.tu-berlin.de)
diff --git a/audio/maplay/pkg-plist b/audio/maplay/pkg-plist
index 2135816542b..8f8adc7dbef 100644
--- a/audio/maplay/pkg-plist
+++ b/audio/maplay/pkg-plist
@@ -1 +1,3 @@
 bin/maplay
+share/doc/maplay/README
+@dirrm share/doc/maplay