ReadMe for AngSound (Release 4)
~~~~~~~~~~~~~~~~~~~

This is a shared resource for my various Angband ports.  Basically
it's just a central location for sound files to live and a convenient
way of making sure that PlayIt is loaded.


My Angband ports use the PlayIt module by Rick Hudson to actually play
the sounds and two versions of this are included in !AngSound.  (Two
versions are supplied since, during testing, I had trouble with each
of them under different versions of RISC OS.  !AngSound will pick the
appropriate one for your OS if double-clicked on).


Please read the !AngSound.!Help file for more details on how to use
!AngSound and its licence, etc.

Please see !AngSound.PlayIt.Docs for PlayIt's licence and documentation.

The !RamSound obey file is a shortcut to create a RAM disc, copy !AngSound
into it and then run !AngSound in the RAM disc.  NB: you'll need at least
1Mb (1024K) free memory (on top of the memory required by the game) to do
this with AngSound as supplied.


IMPORTANT:

The game uses a lot of files whose names (in the UNIX world)
have 'dot extensions', eg. "news.txt".  Under RISC OS, these
names are translated by subsituting a '/' for the '.', so when
the game wants to use the file "news.txt" the actual file
used will be "news/txt".

Early-ish versions of SparkPlug (2.23 and earlier, possibly also
2.24 - I'm not sure) can unfortunately extract these files with
the wrong names: where "news.txt" should be extracted as "news/txt"
they will extract it as "news_txt".  This will stop the sound from
working.

Despair not:  In the archive there should be two obey files, !DeMunge
and !DeMunge10.  One of these should fix the filenames.  Which one
you should use depends on the filing system you are using:

If you're using a filing system that supports filenames longer than 10
letters (eg. NFS, RISC OS 4, raFS, etc), then you should use the !DeMunge
file. This file is also suitable for RISC OS 3 machines that have
"Truncate" configured on (ie. almost all of them :)

On the other hand, !DeMunge10 is suitable for any system that has a limit
of 10 characters of filenames, eg. RISC OS 2, RISC OS 3 using ADFS, etc.



Future plans
~~~~~~~~~~~~
Hopefully the next release will include an easy to use configuration program
to set up the sound/cfg file(s).



History
~~~~~~~
        Release 1 (12 Sep 1998)
            Initial release.
            Explicit support for Angband, Kamband, Sangband and Zangband.

        Release 2 (30 Sep 1998)
            Added support for Cthangband
            Changed sprites for some much nicer ones :)
            Upgraded PlayIt 1.38 to 1.39 (fixes a stereo positioning bug).

        Release 3 (01 Nov 1998)
            Added support for Oangband.
            Added DeMunge obey files.

        Release 4 (07 May 1999)
            Added support for all known variants.
            Added support for port front-end 1.23 which allows it to
            automatically load PlayIt and also allows new variants to
            use the default sounds without any extra work.

Musus Umbra, 1998/9.