Initial revision

[ssr] / StraySrc / BuildTools

Build tools
~~~~~~~~~~~

Apart from the tools provided, you'll need the following programs to
build the Straylight Source Release:

cc		Acorn's C compiler
objasm		Acorn's ARM assembler
link		Acorn's linker
libfile		Acorn's archiver
squeeze		Acorn's executable compresser
amu		Acorn's rather nasty make utility
ccrunch		A BASIC cruncher
sed		GNU's stream editor

I recommend using the C5 versions of these tools; some of the source
files may require C5 versions, but I'm not sure.

A few pieces of code were deliberately built using the C4 versions of
various tools, to ensure compatibility with people developing for RISC
OS 2.  For this reason, some of the Makefiles assume the presence of
programs `o-cc', `o-objasm', `o-link' and `o-libfile'; these are assumed
to be the earlier versions.  If you only have one version of the
compiler, assembler and tools, you can set aliases to make the
`o-'-prefixed versions run the non-prefixed ones.

The STEEL library may require bits of RISC_OSLib.  You won't be able to
build STEEL or the programs which use it without RISC_OSLib.

Everything else ought to be provided in the package.  There are a
collection of strange tools we've created to help build our programs,
and a few more written specially for this source release:

buildstub	Builds Sapphire extension stubs
enumerate	Run a *command for each file in a directory
fixlink		Patches partially linked AOF files because link 4.00 is
			buggy
hour		Hourglass control from Obey files
inst		Install programs once they've been built
msgaof		Compile a message file to linkable AOF
pathutil	Manipulate path variables properly
resgen		Tool for building DLLs containing shared resources
setdate		Stamp the current date into an AOF file
setslot		A replacement for *WimpSlot which understands flex
ssrclean	Delete a lot of files at once
submake		Tool for making recursive makes work
templaof	Convert a template file into an embedded templates
test		Test conditions in Obey files