home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Gold Fish 2
/
goldfish_vol2_cd1.bin
/
files
/
comm
/
mail
/
spluu
/
spluu.doc
< prev
next >
Wrap
Text File
|
1993-12-21
|
6KB
|
168 lines
Document SplUU - by wyrd@ministry.demon.co.uk
******************************************************
* *
* ////// ////// // // // // // *
* /// /// // /// // // // // // *
* //// // /// // // // // // *
* //// ///// // // // // // *
* //// // // /// // /// // *
* /// /// // // /// // /// // *
* ////// // ///// //// //// *
* *
******************************************************
VERSION V01.16ß
"SplUU", a File Email System.
(c)1993 Psilocybe Systems Inc.
email: wyrd@ministry.demon.co.uk
SplUU has been voted "Best software ever written, and I think we'll
recursively delete our entire UNIX system today and use SplUU as our
operating system instead..." by the magazine "Little White Mushroom
User" in the August 2021 edition.
0. About the Author
~~~~~~~~~~~~~~~~
Oh, I don't believe you really read this stuff anyway. If you're bored
and really want to know, email me. Better yet, I'm on IRC as "Midnight"
and may even talk to you. (Wow)
This is a beta Aminet release of SplUU. It has been tested and seems
to work fine, but there _may_ still be bugs. Also I wish to improve
the documentation - but have very little time as I'm studying Music
Tech at the London Guildhall University at present. If anyone wants
to write some decent docs (in text and AmigaGuide format) then feel
free to do so. If they're any good, I'll use them in the next release.
1. What is SplUU?
~~~~~~~~~~~~~~
SplUU is used to prepare a file for emailing by splitting it into
several files in UUEncode format. If the file has been UUEncoded
previously, the UUEncoding function can be switched off.
Remember that SplUU will try to UUEncode by default...
Oh, and SplUU is a Command Line Interface utility! Yes, that's right,
good ol' CLI. I had written a GUI version of SplUU, but I have such
a deep loathing for graphical interfaces that I deleted it. Bwahaha!
2. Syntax for use
~~~~~~~~~~~~~~
spluu [-?]
or
<[UUEncoded]file> <output_file> [-a] [-r] [-e] [-l] [-u] [-n<no_of_lines>]
[-s<user@site>]
or
<input_batch> <output_unbatched> <-x> [-d]
Arguments
~~~~~~~~~
2.1. -a - Overwrite.
The -a flag will, if set, make SplUU overwrite any existing files which
share the same filename as <output_file>.
2.2. -r - Remove.
The -r flag will, if set, make SplUU delete the <[UUEncoded]file> after
the output files have been written.
2.3. -e - Encoding off.
The -e flag will, if set, make SplUU assume that the <[UUEncoded]file>
has been previously UUEncoded, and will try to split it without attempting
to UUEncode.
2.4. -l - LhA.
The -l flag will, if set, cause the output files to be LhAed before
they are UUEncoded. You must have LhA in your system path for this to work.
Note: this option is only allowed if the -e flag has _not_ been set. Pre-
UUEncoded files should not need to be LhAed.
2.5. -u - UNIX filemode.
The -u flag will, if set, make SplUU calculate the file mode for the
UUEncoded file. This may cause problems on an Amiga-only platform, but
has been included for the sake of completeness.
2.6. -n - Number of lines.
The -n flag, if used with a number following it directly, sets the number
of lines of each UUEncoded block. This number defaults to 2000. Example
use:
spluu infile outfile -n700
This will create several 700 line files - which equates to about 43K per
outfile.
3. Extracting
~~~~~~~~~~
If the -x flag has been set, all flags other than -d are ignored. This
will cause SplUU to act as a DeSplUUer. :) It will read the input file,
looking for SplUU-type blocks, and will try to concatenate them in the
correct order for use - the output is written to <output_file>.
When the -x flag has been set, the -d flag can also be set. This will
make SplUU attempt to UUDecode the unbatched UUEncoded file. Note that
the file/path of the UUDecoded file is taken from the coded file's begin
line...
Note: The format of batch file that SplUU is able to extract from must
be similar to the username.txt folder used by mailreaders such as Elm.
4. Sendmail
~~~~~~~~
The -s flag is used in conjunction with SENDMAIL to directly post the
split output files as email. Specify the user you're mailing to after
the -s, i.e.
spluu in out -a -r -swyrd@ministry.demon.co.uk
You must have SENDMAIL in your path, and a UUCP config file in either
your s: or your uulib: assignment. That is to say, you must have at
least a minimum UUCP setup installed on your system.
Note: SplUU looks for the key words "NodeName", "UserName", "RealName"
"Organization" and "DomainName" in the UUCP config file, and is case-
sensitive, so those words must be entered exactly as listed.
5. Example use
~~~~~~~~~~~
Given a pre-UUEncoded file called "testfile.uue", we could:
spluu testfile.uue outfile -a -r -e
This would create NN number of files, depending on the length of the
input file, in the format:
outfile.NN
Note that "testfile.uue" will have been deleted, due to the "-r" flag
being set. Also, if there were any existing files with filenames such
as "outfile.01" they will have been overwritten without any warning
messages given, due to the "-a" flag being set. The "-e" flag is set to
prevent SplUU from trying to UUEncode the input file, which had already
been UUEncoded.
6. Whatware?
~~~~~~~~~
Hope you find this useful. (c)1993 Psilocybe Systems Inc.
wyrd@ministry.demon.co.uk -- IRC:Midnight
This software is #wiccaware - if you like it, /msg me! :)
p.s. That means it's *free!* By all means send me a nice new A4000T-UNIX,
but you haven't got to. Just don't screw with the code and re-release it.