ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
                      ³           S3MRip           ³
                      ³ (c) James Holderness 1993  ³
                      ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

Introduction
ÄÄÄÄÄÄÄÄÄÄÄÄ
S3MRIP is a simple utility for ripping S3M files from demos. It will only
work if the executable file does not use any compression (e.g. PKLITE). If
you use it to try and rip an S2M file, it will probably just hang your
machine.

Usage
ÄÄÄÄÄ
S3MRIP filename

where filename is the name of the demo's executable file which may contain
some S3M files. If any of the modules in the demo contain more than one
song, each song will be extracted as a seperate file.

Nameing conventions
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
The files extracted are named in the following manner: The name of the
executable is truncated to 6 characters. Then each module is assigned a
letter consecutively which is appended to that name (the first module gets
the letter 'A', the second, the letter 'B', etc.). Then each song in a
particular module is also assigned a letter, which is also appended to the
name.

For example, if you are ripping from a demo called EXAMPLE.EXE, which
contained 3 modules, and the second module was made up of 2 seperate
songs, the files extracted would be named: EXAMPLAA.S3M (the first module),
EXAMPLBA.S3M (the first song in the second module), EXAMPLBB.S3M (the second
song in the second module), and EXAMPLCA.S3M (the third module).

Disclaimer
ÄÄÄÄÄÄÄÄÄÄ
Please note that this is not meant to be used for any illegal purposes. It
was written so that people that enjoy the S3M music found in demos could
listen to it without having to watch the whole demo. It is also useful in
cases where someone's machine may not be powerful enough to run the demo
with sound. It may or may not be legal for you to distribute any mods you
may have ripped from a demo, so do not do so unless you have permission
from the author(s).

Technical notes
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
Any module ripped using this utility will not necessarily be the same as
the module in the demo, since the program attempts to remove any unused
samples (this is especially necessary when splitting up multiple songs in
one module). This has the advantage of possibly making the modules a
little smaller, but there is also a chance that a module may be ripped
incorrectly.

What demos use S3M files
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
The only demos that I know of that use S3M files are made by the PC group
"Future Crew". The following demos by them are known to contain S3M files:
Fishtro, Unreal, The Party, and Panic.

Note that when ripping files from the Unreal demo, there is one file that
will be created that is not really a song and can be deleted. It is the
second song in the third module (the filename should be UNREALCB.S3M).

Contacting me
ÄÄÄÄÄÄÄÄÄÄÄÄÄ
Don't know why anyone would want to do this, but I can be reached at the
following addresses:

Internet: holderne@beastie.cs.und.ac.za
  (This is the best one to try, but it may not last that long)
Fido: James Holderness @ 5:7103/7
  (I'm quite slow replying here, and FIDO often looses stuff)
Snailmail: P.O.Box 1235, Westville, 3630 South Africa
  (I hardly ever reply, and when I do, it takes years)