
README
======

This distribution contains a patched defmod that can be built on UNIX systems
as well as RISC OS systems.

The sources to defmod are in the defmod directory. An example UNIX
environment for building OSLib itself is in unix_eg

Please have a go with this software and see if it works for you.



Stewart Brodie (stewart@eh.org)
October 18th 2001




REQUIREMENTS
============

bison 1.28 must be installed on your UNIX system.
You must have GNU make (gmake on FreeBSD systems).
You must have bash.

To perform the demonstration build, you will need an "armasm" on
your path that is an ARM assembler compatible with RISC OS objasm.
You will also require "armlib" on your path that is compatible
with RISC OS libfile (see note at end too)



HOWTO
=====

Copy all the contents of this archive to a UNIX system.

In defmod/ports/solaris, do:

$ make links
$ make

Construct a build directory from the top-level of the unpacked archive:

$ cd unix_eg
$ mkdir defs          # if it wasn't already there

Copy all the defmod definition files from OSLib into this directory.
There's around 150 in total - just copy them all in here.

Rename the files to have a .swi suffix (example in /bin/sh):

$ for i in defs/*
> do
>   mv $i $i.swi
> done

Then you should be able to build it:

$ make                # or gmake on FreeBSD

This will build all the .h, all the .hdr and the OSLib.a file.  Depending on
your machine, this could take anything from a few seconds to a few minutes
(compared with over an hour on a Risc PC ;-)

Depending on your UNIX, the armlib call may fail with "Too many arguments"
because I'm allowing the shell to expand the parameters instead of OSLib.
If this happens, sorry - you'll need to do:

$ find tmp -name "*.o" > ViaFile
$ armlib -c -o OSLib.a -via ViaFile


NOTES
=====

Please see the CHANGES file for notes on what I've changed for both the
generic defmod software and to support execution on UNIX systems.


#END#
