1 files changed, 94 insertions, 0 deletions
diff --git a/audio/mpegaudio/files/mpeg_musicout.1 b/audio/mpegaudio/files/mpeg_musicout.1
new file mode 100644
index 00000000000..cba817497e6
--- /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.
+.\"
+.\" $FreeBSD: ports/audio/mpegaudio/files/mpeg_musicout.1,v 1.2 1999/08/29 10:56:51 peter Exp $
+.Dd August 17, 1997
+.Dt MPEG_MUSICOUT 1
+.Os
+.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