Created manpages mpeg_musicin.1 and mpeg_musicout.1

Expect not too much ... but if somebody is very experienced
in using these tools, then please feel free to add some
,,flesh´´ to these manpages. Now you have a good starting
point.
PR:	closes PR 1518

4 files changed, 225 insertions, 1 deletions

diff --git a/audio/mpegaudio/Makefile b/audio/mpegaudio/Makefile
index ea0085378b36..f7664bc80bc4 100644
--- a/audio/mpegaudio/Makefile
+++ b/audio/mpegaudio/Makefile
@@ -2,7 +2,7 @@
 # Date created:		1 July 1996
 # Whom:			torstenb
 #
-# $Id: Makefile,v 1.1.1.1 1996/07/06 09:27:10 gpalmer Exp $
+# $Id: Makefile,v 1.2 1996/11/15 23:13:52 obrien Exp $
 #
 
 DISTNAME=	mpegaudio
@@ -13,4 +13,10 @@ EXTRACT_SUFX=	.tar.Z
 
 MAINTAINER=	torstenb@FreeBSD.ORG
 
+MAN1=		mpeg_musicin.1 mpeg_musicout.1
+
+post-install:
+	${INSTALL_MAN} ${FILESDIR}/mpeg_musicin.1 ${PREFIX}/man/man1
+	${INSTALL_MAN} ${FILESDIR}/mpeg_musicout.1 ${PREFIX}/man/man1
+
 .include <bsd.port.mk>
diff --git a/audio/mpegaudio/files/mpeg_musicin.1 b/audio/mpegaudio/files/mpeg_musicin.1
new file mode 100644
index 000000000000..dbdd28030471
--- /dev/null
+++ b/audio/mpegaudio/files/mpeg_musicin.1
@@ -0,0 +1,122 @@
+.\" Copyright (c) 1997 Andreas Klemm <andreas@FreeBSD.org>. Neuss.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" $Id:$
+.Dd August 17, 1997
+.Dt MPEG_MUSICIN 1
+.Os FreeBSD
+.Sh NAME
+.Nm mpeg_musicin
+.Nd MPEG/audio Layer 1 and Layer 2 decoder
+.Sh SYNOPSIS
+.Nm mpeg_musicin
+queries for all arguments, or
+.br
+.Nm mpeg_musicin
+.Op Fl l Ar lay
+.br
+.Op Fl m Ar mode
+.br
+.Op Fl p Ar psy
+.br
+.Op Fl s Ar sfrq
+.br
+.Op Fl b Ar br
+.br
+.Op Fl d Ar emp
+.br
+.Op Fl c
+.br
+.Op Fl o
+.br
+.Op Fl e
+.br
+inputCM
+.br
+.Op Ar outBS
+.br
+.Sh DESCRIPTION
+The encoder and decoder software are configured to output
+the coded audio bitstreams as a string of hexadecimal ascii
+characters. For greater compression efficiency, compile flag,
+BS_FORMAT, in common.h can be switched to configure the bitstream 
+reading and writing routines to process raw binary bitstreams.
+.br
+The decoder program has a very crude implementation of bitstream
+synchword detection. It may not be able to correctly decode valid
+bitstreams which have false synchword patterns in the ancillary data
+portion of the bitstream.
+.Sh RESTRICTIONS
+The software implements levels I and II and psychophysical auditory
+models I and II as described in the ISO 3-11171 rev 1 standard.
+There are future plans to implement level III.
+.br
+The input/output audio data may either be headerless raw 16 bit data
+or alternatively an AIFF formatted file (Audio Interchange File Format)
+with certain limitations.
+.br 
+For more information on the AIFF format see the postscript file
+/sgi/aiff-c.9.26.91.ps at the anonymous ftp site FTP.SGI.COM
+(192.48.153.1).
+.br
+The AIFF formatted file is a convenient way for storing sampling rate
+of the audio file.
+.br
+The encoder and decoder software are configured to output the coded
+audio bitstreams as a string of hexadecimal ascii characters.
+For greater compression efficiency, compile flag, BS_FORMAT, 
+in common.h can be switched to configure the bitstream reading 
+and writing routines to process raw binary bitstreams.
+.br
+This software has been run and verified on a large variety of
+computers and operating systems. In particular UNIX, MS_DOS (with
+MicroSoft C version 6), Macintosh, AIX Platform (RS6000) and Convex.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Sy -l lay
+use layer <lay> coding (default: 2)
+.It Sy -m mode
+channel mode : s/d/j/m (default: s)
+.It Sy -p psy
+psychoacoustic model 1/2 (default: 2)
+.It Sy -s sfrq
+input smpl rate in kHz (default: 44.1)
+.It Sy -b br
+total bitrate in kbps (default: 384)
+.It Sy -d emp
+de-emphasis n/5/c (default: n)
+.It Sy -c
+mark as copyright
+.It Sy -o
+mark as original
+.It Sy -e
+add error protection
+.It Sy inputPCM
+input PCM sound file (standard or AIFF)
+.It Sy outBS
+output bit stream of encoded audio (dflt inName+.mpg)
+.Sh SEE ALSO
+.Xr mpeg_musicout 1
+.Sh HISTORY
+Written by Andreas Klemm, August 17, 1997
diff --git a/audio/mpegaudio/files/mpeg_musicout.1 b/audio/mpegaudio/files/mpeg_musicout.1
new file mode 100644
index 000000000000..7dc76eade226
--- /dev/null
+++ b/audio/mpegaudio/files/mpeg_musicout.1
@@ -0,0 +1,94 @@
+.\" Copyright (c) 1997 Andreas Klemm <andreas@FreeBSD.org>. Neuss.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" $Id:$
+.Dd August 17, 1997
+.Dt MPEG_MUSICOUT 1
+.Os FreeBSD
+.Sh NAME
+.Nm mpeg_musicout
+.Nd MPEG/audio Layer 1 and Layer 2 encoder
+.Sh SYNOPSIS
+.Nm mpeg_musicout
+queries for all arguments, or
+.br
+.Nm mpeg_musicout
+.Op Fl A
+.br
+.Op Fl s Ar sb
+.br
+inputBS
+.br
+.Op Ar outPCM
+.br
+.Sh DESCRIPTION
+The encoder and decoder software are configured to output
+the coded audio bitstreams as a string of hexadecimal ascii
+characters. For greater compression efficiency, compile flag,
+BS_FORMAT, in common.h can be switched to configure the bitstream 
+reading and writing routines to process raw binary bitstreams.
+.br
+The decoder program has a very crude implementation of bitstream
+synchword detection. It may not be able to correctly decode valid
+bitstreams which have false synchword patterns in the ancillary data
+portion of the bitstream.
+.Sh RESTRICTIONS
+The software implements levels I and II and psychophysical auditory
+models I and II as described in the ISO 3-11171 rev 1 standard.
+There are future plans to implement level III.
+.br
+The input/output audio data may either be headerless raw 16 bit data
+or alternatively an AIFF formatted file (Audio Interchange File Format)
+with certain limitations.
+.br 
+For more information on the AIFF format see the postscript file
+/sgi/aiff-c.9.26.91.ps at the anonymous ftp site FTP.SGI.COM
+(192.48.153.1).
+.br
+The AIFF formatted file is a convenient way for storing sampling rate
+of the audio file.
+.br
+The encoder and decoder software are configured to output the coded
+audio bitstreams as a string of hexadecimal ascii characters.
+For greater compression efficiency, compile flag, BS_FORMAT, 
+in common.h can be switched to configure the bitstream reading 
+and writing routines to process raw binary bitstreams.
+.br
+This software has been run and verified on a large variety of
+computers and operating systems. In particular UNIX, MS_DOS (with
+MicroSoft C version 6), Macintosh, AIX Platform (RS6000) and Convex.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Sy -A
+write an AIFF output PCM sound file
+.It Sy -s sb
+resynth only up to this sb (debugging only)
+.It Sy inputBS
+input bit stream of encoded audio
+.It Sy outPCM
+output PCM sound file (dflt inName+.dec)
+.Sh SEE ALSO
+.Xr mpeg_musicin 1
+.Sh HISTORY
+Written by Andreas Klemm, August 17, 1997
diff --git a/audio/mpegaudio/pkg-plist b/audio/mpegaudio/pkg-plist
index 8525a9efa3af..c718915a5c3f 100644
--- a/audio/mpegaudio/pkg-plist
+++ b/audio/mpegaudio/pkg-plist
@@ -21,3 +21,5 @@ lib/mpegaudio/tables/alloc_2
 lib/mpegaudio/tables/alloc_3
 lib/mpegaudio/tables/dewindow
 lib/mpegaudio/tables/enwindow
+man/man1/mpeg_musicin.1.gz
+man/man1/mpeg_musicout.1.gz