STRAYLIGHT SOURCE RELEASE
~~~~~~~~~~~~~~~~~~~~~~~~~

This directory contains the Straylight Source Release.  The various Zip
files contain sources to distinct pieces of software.  Unfortunately, 
the code was never written to be distributed, so there's a complex
pattern of interdependency between some of the packages.

`Phase 1' of the Release consists of the following parts:

Core		Contains standard libraries and build tools required for
		building everything else.

Dynamite	Straylight's dynamic area management module.  Requires
		Core.

MiscToys	Some fairly silly utilities.  Requires Core.

Sapphire	A large library for writing applications in ARM
		assembler.  There's a `README' file providing a brief
		overview, documented header files and a few examples.
		Requires Core, SDLS, and Sculptrix

Sculptrix	A module for drawing 3D buttons.  Requires Sapphire for
		the configuration program.

SDLS		Straylight's dynamic linking system.  Requires Sculptrix.

Phase 2 will contain some more toys, the Steel C library, and the Glass
template editor.  I'm not making any promises with regard to release
times for phase 2.

Building the SSR should be fairly straightforward.  First, unpack the
sections you want.  They all share the same build root directory
`StraySrc'.

Now, make sure that the environment is set up properly.  I tested the
Release using a minimal toolset consisting of:

  * The following programs available in Run$Path:
  
    amu		Acorn's Make Utility version 5.02
    cc		The Acorn C compiler version 5.06
    ccrunch	A BASIC compactor written by Ragnar Hafstaš
    libfile	Acorn's library management tool version 5.00
    link	Acorn's linker version 5.06
    o-cc	An old Acorn C compiler version 4.00
    o-libfile	An old Acorn library management tool version 4.00
    o-link	An old Acorn linker version 4.00
    o-objasm	An old Acorn assembler version 2.00
    objasm	Acorn's ARM assembler version 3.06
    sed		GNU sed version 2.03
    squeeze	Acorn's AIF squeezer version 5.00
    unzip	InfoZIP unarchiver version 5.13c BETA
    zip		InfoZIP archiver version 2.0j

  * The following libraries available in C$Path:

    clib	Acorn's C library headers
    risc_oslib	Acorn's RISC OS library headers and object files

You may be able to get away with different versions of tools.  In
particular, the old versions of Acorn's tools are used to ensure
that AOF2 is generated for compatibility with other people's old tools.

SSR requires its own tools and libraries in addition to those listed
above.  It will create `Libs$Path' pointing at its own libraries, and
add its own tools to `Run$Path' when you run `ssr-init'.

To build everything, run

  amu
  amu install

in the `StraySrc' directory.  This will recursively build and install
everything you've unpacked.  (The Makefiles work out which bits you've
got and build them.)  If this doesn't work, make sure you've got all
the tools you need, and all the paths are set up right.

All the source code may be modified and redistributed under the terms of
the GNU General Public License, which is included in the distribution
archives as `StraySrc.COPYING'.  Special exceptions for distribution of
binaries may be given; please ask me for permission.

Public discussion of the Straylight Source Release, including reporting
of bugs, and requesting new features, will take place on a mailing list. 
To subscribe, send mail to `ssr-subscribe@excessus.demon.co.uk'.  You
will be asked to send a confirmation message to prove that you can
receive mail from the list.  To send a message to the list, mail
`ssr@excessus.demon.co.uk'.

I want to gather a small team of developers to continue maintenance of
SSR.  If you think you could help to maintain and develop parts of SSR,
or write documentation for it, then send me email.


My personal email address is mdw@excessus.demon.co.uk.  Please try to
report problems or requests to the list.  (On the other hand, problems
/about/ the list probably ought to be sent to me!)

I think that about wraps it up for me.