[ssr] / dist / README

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
Commit	Line	Data
2ee739cc	1	STRAYLIGHT SOURCE RELEASE
	2	~~~~~~~~~~~~~~~~~~~~~~~~~
	3
	4	This directory contains the Straylight Source Release. The various Zip
	5	files contain sources to distinct pieces of software. Unfortunately,
	6	the code was never written to be distributed, so there's a complex
	7	pattern of interdependency between some of the packages.
	8
	9	`Phase 1' of the Release consists of the following parts:
	10
	11	Core Contains standard libraries and build tools required for
	12	building everything else.
	13
	14	Dynamite Straylight's dynamic area management module. Requires
	15	Core.
	16
	17	MiscToys Some fairly silly utilities. Requires Core.
	18
	19	Sapphire A large library for writing applications in ARM
	20	assembler. There's a `README' file providing a brief
	21	overview, documented header files and a few examples.
	22	Requires Core, SDLS, and Sculptrix
	23
	24	Sculptrix A module for drawing 3D buttons. Requires Sapphire for
	25	the configuration program.
	26
	27	SDLS Straylight's dynamic linking system. Requires Sculptrix.
	28
	29	Phase 2 will contain some more toys, the Steel C library, and the Glass
	30	template editor. I'm not making any promises with regard to release
	31	times for phase 2.
	32
	33	Building the SSR should be fairly straightforward. First, unpack the
	34	sections you want. They all share the same build root directory
	35	`StraySrc'.
	36
	37	Now, make sure that the environment is set up properly. I tested the
	38	Release using a minimal toolset consisting of:
	39
	40	* The following programs available in Run$Path:
	41
	42	amu Acorn's Make Utility version 5.02
	43	cc The Acorn C compiler version 5.06
	44