
Acorn Front End for GNU GCC  Martin Carradus July 2002
=============================================

In addition to the Acorn application !GCC, you will also need the
zipped files 'clib.zip', 'unixlib.zip' and 'gcc.zip' also available
for download from the site 'www.martinkd.freeuk.com'.

To run this Wimp FrontEnd, you will need to run the application !gcc
within 'gcc.zip' before it will work.

In order to link in C standard functions, you may need to run the
application !clib in 'clib.zip'.

GCC uses UNIX library functions, so run !Boot within !unixlib within
'unixlib.zip' to make them avaialable to GCC.

You may include these actions in your !Boot run upon startup.

NB If you use the version of CLib provided, i.e. not the version
supplied with the Acorn C Compiler, you need to do the following:-

1. If the program you are compiling is not GNU C, you need to Undefine
the system variable __GNUC__ by typing exactly that (with underscores)
into the StartUp menu. This menu is obtained by clicking the mouse
'Menu' key over the first panel you obtain from the bar icon. Move to
the right of 'Undefine' and type: __GNUC__ into the slot provided,
then press the 'Return' key.

2. If you are using the header <stdio.h>, you need to look in the 'h'
directory of the unpacked !clib, look for the file 'stdio' and you
will find a #error statement calling you to define the variable:
__va_list . You need to replace this #error statement with the
following (found in the Acorn 'stdio'):

typedef char *__va_list[1];

Just like that. That should cure a set of
warning messages you might have got otherwise.

Additional Help is available by clicking on 'Help' from the bar icon
menu obtained by clicking 'Menu' over the bar icon, or by using the
Acorn facility !Help in the 'Apps' directory.

A menu with more compiler options can be obtained by clicking 'Menu'
over the 'StartUp' panel obtained by clicking on the bar icon. In
particular you may specify up to 5 library files to be included in the
final linkage. Give the full file name in each case. You may also
specify up to two search paths for Libraries.

Documentation about GCC is in the directory 'docs' in !gcc in
'gcc.zip'.

At least read !Intro within this directory.

Also please read the files COPYING and COPYINGLIB within !GCC which
give terms and conditions of any release of GNU software in the GNU
GENERAL PUBLIC LICENCE. Also note the following:-

DISCLAIMER - AGREEMENT
=======================

Users of !GCC must accept this disclaimer of warranty:
"!GCC is supplied as is.  The author disclaims all
warranties, expressed or implied, including, without limitation,
the warranties of merchantability and of fitness for any purpose.
The author assumes no liability for damages, direct or conse-
quential, which may result from the use of !GCC."

This is, in effect, the GNU application 'gcc' with a WIMP FrontEnd.
For GNU software licence see 'COPYING' within !GCC.

!GCC is a "free program" and is provided at no charge
to the user for evaluation.  Feel free to share it with your
friends, but please do not give it away altered or as part of
another system.

Anyone distributing !GCC for any kind of remuneration must
first contact Martin Carradus at the address below for authorization.

If you have comments, curses or praise write to:-

                       Martin Carradus,
                       Leaf Mindcraft,
                       c/o 27 Wells Road,
                       Ilkley,
                       West Yorkshire.
                       LS29 9JE.
                       U.K.
  (Please enclose s.a.e if you require a reply.)

