pkgsrc-ng/audio/bladeenc/patches/patch-aa

$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>.