Add man-page that I had sitting around. Sent to author, who in February

said he'd include it in the next version, but since the project is,
according to the website, discontinued...

While we're at it, move html documentation where it belongs.
Bump PKGREVISION.

4 files changed, 290 insertions, 8 deletions

diff --git a/audio/bladeenc/Makefile b/audio/bladeenc/Makefile
index d74b985bcf7..ecc833c420d 100644
--- a/audio/bladeenc/Makefile
+++ b/audio/bladeenc/Makefile
@@ -1,9 +1,9 @@
-# $NetBSD: Makefile,v 1.17 2002/03/14 15:42:40 agc Exp $
+# $NetBSD: Makefile,v 1.18 2002/12/14 00:39:58 jschauma Exp $
 #
 
 DISTNAME=		bladeenc-0.94.2-src-stable
 PKGNAME=		bladeenc-0.94.2
-PKGREVISION=		1
+PKGREVISION=		2
 CATEGORIES=		audio
 MASTER_SITES=		http://bladeenc.mp3.no/source/
 
@@ -18,7 +18,8 @@ WRKSRC:=		${WRKDIR}/${PKGNAME}
 GNU_CONFIGURE=		yes
 
 post-install:
-	${INSTALL_DATA_DIR} ${PREFIX}/share/doc/bladeenc
-	${INSTALL_DATA} ${WRKSRC}/bladeenc.html ${PREFIX}/share/doc/bladeenc
+	${INSTALL_DATA_DIR} ${PREFIX}/share/doc/html/bladeenc
+	${INSTALL_DATA} ${WRKSRC}/bladeenc.html ${PREFIX}/share/doc/html/bladeenc
+	${INSTALL_MAN} ${WRKSRC}/bladeenc.1 ${PREFIX}/man/man1/
 
 .include "../../mk/bsd.pkg.mk"
diff --git a/audio/bladeenc/PLIST b/audio/bladeenc/PLIST
index 70192c224f2..995016e62a0 100644
--- a/audio/bladeenc/PLIST
+++ b/audio/bladeenc/PLIST
@@ -1,4 +1,5 @@
-@comment $NetBSD: PLIST,v 1.2 2002/03/13 10:33:44 pooka Exp $
+@comment $NetBSD: PLIST,v 1.3 2002/12/14 00:39:58 jschauma Exp $
 bin/bladeenc
-share/doc/bladeenc/bladeenc.html
-@dirrm share/doc/bladeenc
+man/man1/bladeenc.1
+share/doc/html/bladeenc/bladeenc.html
+@dirrm share/doc/html/bladeenc
diff --git a/audio/bladeenc/distinfo b/audio/bladeenc/distinfo
index 3cb3cabee58..26683a3023e 100644
--- a/audio/bladeenc/distinfo
+++ b/audio/bladeenc/distinfo
@@ -1,4 +1,5 @@
-$NetBSD: distinfo,v 1.3 2001/05/14 13:13:58 zuntum Exp $
+$NetBSD: distinfo,v 1.4 2002/12/14 00:39:58 jschauma Exp $
 
 SHA1 (bladeenc-0.94.2-src-stable.tar.gz) = 72f9b0600cbd2a19175ccb0cd8aa8e9c194bc87c
 Size (bladeenc-0.94.2-src-stable.tar.gz) = 142949 bytes
+SHA1 (patch-aa) = 6560446ae63234ad136ee869f25d0317c88d3e2d
diff --git a/audio/bladeenc/patches/patch-aa b/audio/bladeenc/patches/patch-aa
new file mode 100644
index 00000000000..ae5dd98d379
--- /dev/null
+++ b/audio/bladeenc/patches/patch-aa
@@ -0,0 +1,279 @@
+$NetBSD: patch-aa,v 1.5 2002/12/14 00:39:58 jschauma Exp $
+
+--- /dev/null	Fri Dec 13 19:19:07 2002
++++ bladeenc.1	Fri Dec 13 19:31:00 2002
+@@ -0,0 +1,274 @@
++.TH BLADEENC 1 "November 25th, 2001" "" "MP3 User's Manual" 
++
++.SH NAME
++bladeenc \- LGPL'd MP3 encoder
++
++.SH SYNOPSIS
++\fBbladeenc\fR
++[ \fIOPTION\fR... ] [ \fIWAV\-FILE\fR... ] 
++
++.SH "DESCRIPTION"
++.PP
++\fBbladeenc\fR is a free, cross\-platform,
++console\-based MP3 encoder, based on the ISO reference code. It is mostly
++intended for high quality encoding in high bitrates.
++
++.SH "USAGE"
++.PP
++\fBbladeenc\fR is a console application that takes
++its parameters from the commandline. Any number of WAV/AIFF\-files
++can be specified on the commandline and you can even use wildcards
++to specify more than one file at the same time.
++Long filenames are
++supported when entering them on the commandline, but if they include
++space\-characters you will have to enclose the with quotation\-marks 
++( " ).
++
++.SH "OPTIONS"
++.PP
++Switches can be entered on the commandline together with the filenames.
++In earlier versions of \fBBladeEnc\fR it didn't matter 
++where you put the switches since they always affected all files anyway,
++but from \fBBladeEnc\fR 0.80 this has changed in order
++to give you more flexibility.
++.PP
++You can get a list of all valid arguments by running \fBBladeEnc\fR
++without any commandline arguments.
++A summary of the options
++supported by \fBbladeenc\fR
++is included below.
++.\" Begin List
++.TP
++\fB\-[\fR\fIbitrate\fR], \fB\-br [\fR\fIbitrate\fR]
++Defines the bitrate for the MP3\-file. Higher bitrates gives better quality,
++but also bigger files. Most people prefer to generate 128 kBit MP3s. Please
++note that it's the total bitrate that is specified, so if you're generating a
++stereo MP3\-file at 128 kBit you get 64 kBit for left channel and 64 kBit for
++the right channel. The default setting is 128 kBit for stereo files and 64
++kBit for mono files.
++
++Allowed bitrates are: 32, 40, 48, 56, 64, 80, 96, 112,
++128, 160, 192, 224, 256 and 320.
++.TP
++\fB\-concat\fR
++Concatenates the output generated from this file to the last mp3
++generated, thus making one mp3 file from two or more sample
++files. This option also automatically enables
++\fI\-nogap\fR.
++.TP
++\fB\-crc\fR
++Adds checksum data to each frame in the MP3 file. The checksum
++data is useful for error\-correction when streaming the MP3 in
++realtime over internet (as done by internet radio stations). It
++lowers the quality of the sound slightly since the checksum data
++also needs to fit in the specified bitrate and is not needed for
++normal use.
++.TP
++\fB\-del, \-delete\fR
++The WAV\-file is automatically deleted after having been encoded.
++Be careful with this switch because the WAV\-file is deleted even
++if the encoding process failed (for example due to insufficient
++drive space).
++.TP
++\fB\-dm, \-mono\fR
++Downmixes stereo input files to mono before they are compressed,
++thus generating mono MP3 files. This switch does nothing if the
++input file already is mono.
++.TP
++\fB\-lm, \-leftmono\fR
++Takes only the left channel of the input file and encodes it
++into a mono MP3. If the input file is mono it will be compressed
++as it is.
++.TP
++\fB\-rm, \-rightmono\fR
++Takes only the right channel of the input file and encodes it
++into a mono MP3. If the input file is mono it will be compressed
++as it is.
++.TP
++\fB\-swap\fR
++Swaps the left and right channels of stereo input files before
++encoding them.
++.TP
++\fB\-p, \-private\fR
++Sets the private\-flag in the MP3\-file, specifying that this is a
++private MP3. As far as I know there is no program that treats
++private MP3's differently from normal ones so it is practically
++useless.
++
++Setting this flag doesn't affect the encoding time, file size or
++quality in any way, so set it if it makes you happy.
++.TP
++\fB\-c, \-copyright\fR
++Sets the copyright\-flag in the MP3\-file, specifying that this is
++a copyrighted MP3. As far as I know there is no program that
++treats copyrighted MP3's differently from normal ones so it is
++practically useless.
++
++Setting this flag doesn't affect the encoding time, file size or
++quality in any way, so set it if it makes you happy.
++.TP
++\fB\-copy\fR
++This switch clears the MP3 file's original\-flag that is set by
++default from version 0.50 of \fBbladeenc\fR.
++
++Setting this flag doesn't affect the encoding time, file size or
++quality in any way, so set it if it makes you happy.
++.TP
++\fB\-quiet\fR
++Prevents \fBbladeenc\fR from doing any screen output, except for error
++messages. This is mostly useful if you want to run bladeenc as a
++background process on UNIX systems. The screen output takes
++nearly no time at all, so you won't even save 1% by disabling
++screen output. This switch is global only.
++.TP
++\fB\-q, \-quit\fR
++Makes \fBbladeenc\fR quit automatically when all files have been
++encoded. Normally \fBbladeenc\fR waits for someone to press RETURN
++before quitting. This switch is global only.
++.TP
++\fB\-outdir=\fR\fIPATH\fR
++Specifies an output path for the encoded files. Normally the MP3
++files ends up in the same directory as their corresponding
++WAV\-files resides in, but using this switch you can get them to
++end up wherever you like. This switch is global only.
++.TP
++\fB\-prio=\fR\fISETTING\fR
++Changes the task priority of \fBbladeenc\fR. Valid settings are
++HIGHEST, HIGHER, NORMAL, LOWER, LOWEST and IDLE. \fBbladeenc\fR is by
++default set to LOWEST priority which basically means that
++BladeEnc functions fine in the background without disturbing or
++slowing down any other program. Linux/Unix users can also
++specify prio in the normal unix range of \-20 to +20.This switch
++is global only. This setting is not available in all ports.
++.TP
++\fB\-rawfreq=\fR\fIFREQUENCY\fR
++Specifies the frequency for raw samples in hertz. Default is 44100.
++.TP
++\fB\-rawbits=\fR\fISAMPLEBITS\fR
++Specifies the number of bits for each sample in a raw sample
++file. Allowed values are 8 and 16. Default is 16.
++.TP
++\fB\-rawmono\fR
++Specifies that raw samples are mono, not stereo.
++.TP
++\fB\-rawstereo\fR
++Specifies that raw samples are stereo, not mono. This
++is default, so you won't have to use this switch unless you want to override a
++global \-rawmono switch.
++.TP
++\fB\-rawsigned\fR
++Specifies that raw samples are signed, i.e. contains values in
++the range \-32768 to +32767 (16\-bit samples) or \-128 to +127
++(8\-bit samples). This is default, so you won't have to use this
++switch unless you want to override a global \-rawunsigned switch.
++.TP
++\fB\-rawunsigned\fR
++Specifies that raw samples are unsigned, i.e. contains values in
++the range 0 to 65535 (16\-bit samples) or 0 to 255 (8\-bit samples).
++.TP
++\fB\-rawbyteorder=\fR\fILITTLE|BIG\fR
++Specifies the byteorder of raw samples. LITTLE gives
++LITTLE_ENDIAN (Intel x86 style) and BIG gives BIG_ENDIAN
++(Motorola style). Default is whatever is the native byteorder
++for your system, so hopefully you won't have to use this switch.
++.TP
++\fB\-rawchannels=\fR\fI1|2\fR
++Specifies the number of channels in a raw sample. \-rawchannels=1
++gives the same result as \-rawmono and \-rawchannels=2 give the
++same result as \-rawstereo. Default is 2.
++.TP
++\fB\-nocfg\fR
++Ignore whatever is specified in the config file. This switch is global only.
++.TP
++\fB\-refresh=\fR\fI1+\fR
++This switch is not supported anymore. It became superfluous due
++to internal changes. \fBbladeenc\fR still understands (but ignores) it
++for compatibility reasons.
++.TP
++\fB\-progress=\fR\fI0\-8\fR
++Specifies which of the 7 available progress indicators to use or
++turns the progress indicator off if set to 0. The default
++progress indicator is number 1. Changing the progress indicator
++doesn't affect the encoding in any way it just lets you
++configure the look of \fBbladeenc\fR a little bit according to your
++own taste:
++.IP 0 3
++Percentage and ETA shown for file and batch
++(default).
++.IP 1 3
++Long bar for file progress.
++.IP 2 3
++Long bar for batch progress.
++.IP 3 3
++Short bars for file and batch progress.
++.IP 4 3
++Samples done/total for file and batch.
++.IP 5 3
++ETA shown for file and batch.
++.IP 6 3
++Seconds of MP3 generated from file (default for
++RAW samples).
++.IP 7 3
++Alternative long bar for file progress. Doesn't rewind
++the
++cursor so it produces less output and works well when
++redirecting program output to a file.
++
++If a RAW sample is included in the batch you automatically gets
++progress indicator 7 for technical reasons. This switch is
++global only.
++.TP
++\fB\-nogap\fR
++Specifies that there should be no audiable gap between this and
++the next sample if they are played after each other. Useful when
++encoding records where the tracks blend into each other, but can
++cause unwanted side effects otherwise. Please see the section
++"Gapless encoding" below for more information.
++.TP
++\fB\-sort\fR
++Sorts the specified input files according to filename before
++encoding them. Useful when using the \-nogap switch combined with
++wildcards since it's critical that the tracks are encoded in the
++right order when doing gapless encoding. This switch is global
++only.
++.\" End List
++
++.SH "FILES"
++.\" Begin List
++.TP
++\fI~/.bladeencrc\fR
++The default settings of \fBbladeenc\fR can be changed in the configuration file. 
++The config file contains the same kind of switches as you enter on the commandline, separated by
++one or more spaces, tabs or newlines.
++
++Anything placed after a '#' until the end of the line is believed to be a comment and is ignored.
++
++The switches in the configuration file are simply appended to the beginning of the commandline
++before it is parsed.
++
++Anything typed on the commandline has higher priority than what is in the configuration file, so
++the default settings can easily be overriden from the commandline.
++
++If the \-nocfg switch is entered on the commandline the configuration file will be ignored. The
++\-nocfg switch is not allowed in the configuration file.
++.\" End List
++
++.SH "BUGS"
++.PP
++Please report bugs to the author.
++
++.SH "SEE ALSO"
++.PP
++\fB
++lame(1), grip(1), l3enc(1)
++\fR
++.PP
++This program is documented in greater detail on the projects
++homepage: 
++http://bladeenc.mp3.no/ (Link to \fIhttp://bladeenc.mp3.no/\fR)
++
++.SH "AUTHOR"
++.PP
++Tord Jansson <tord.jansson@swipnet.se>
++.PP
++This man\-page was written by Jan Schaumann <jschauma@netmeister.org>.