home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ARM Club 3
/
TheARMClub_PDCD3.iso
/
hensa
/
languages
/
icon_1
/
!Help
< prev
next >
Wrap
Text File
|
1991-05-01
|
5KB
|
133 lines
CCompile: Acorn ANSI C Compiler Desktop Front-End
=================================================
This application is a desktop front-end for Acorn's ANSI C
compiler.
Usage
-----
Drag a source from a directory 'c' to the icon bar icon of
!CCompile. The application calls the C compiler and optionally
also the linker.
Important: the system variable CC$Dir is used to locate the
C compiler directories Library (with the compiler and linker),
RISC_OSLib (with the RISC OS library headers and code) and
CLib (with the C library headers and code). Default this is
the application directory of !CCompile. This means you must
place the C compiler directories into the !CCompile directory.
If you do not want this, you must change the !Run obey file
of !CCompile. As an alternative you can use explicit directory
paths in the Options dialogue window of !CCompile.
If you drag a C source file to the icon bar icon the
application performs the following list of actions and
commands:
- Check if the file is a text file in a directory 'c'.
- If a directory 'o' does not exist at the same level as 'c'
then it is created.
- If the List file icon of the Options window is selected a
directory 'l' is created at the same level as 'c' and 'o'
directories if it does not exist.
- The current directory is set to the parent directory of
these directories 'c' and 'o'.
- Set C$LibRoot to the contents of the Options window
C$LibRoot icon, only if something is specified in this icon.
- Call the C compiler with the following command:
[<ccdir>.]CC <prefix>.c.<file> -c [-i <include>] [-list]
where: ccdir: the contents of the Compiler icon of the
Options window (if empty not included),
file: the name of the dragged file,
prefix: the parent directory of the 'c' directory
from which 'file' is dragged,
include: the contents of the Include icon of the
Options window (if empty not included),
while the '-list' part is only included when the List file
button of the Options window is selected.
- Write the output of the compiler to a report file if the
Report on file button in the Options window is selected AND
a file name for this report file is entered in the Report
icon of this Options window (in all other cases a command
window is used), but only if errors are detected.
- If the Link button of the Options window is selected AND
no errors are detected, call the linker with the following
command:
[<ccdir>.]LINK -o <image> <prefix>.o.<file> [<library>]
[-via <via>] [-verbose]
where: image: the contents of the Image icon of the
Options window,
library: the contents of the Library icon of the
Options window
via: the contents of the Via icon of the
Options window (if empty not included).
while the '-verbose' part is only included when the Verbose
icon of the Options window is selected.
- Remove the object file in the 'o' directory if the Remove
object button of the Options window is selected.
- Call the squeezer if the Squeeze image icon of the Options
window is selected with the following command:
[<ccdir>.]SQUEEZE <image>
Please note that you can specify more than one include
directory (in the Include icon) by using the , character, but
you can specify more than one library file (in the Library
icon) by using the space character! This is a peculiarity
of the CC and LINK commands.
Note also that if you do not specify paths in the Image and
Report icons the image and report files are written in the
current directory, i.e. the parent directory of directory
'c' from which the source is dragged. Especially for the
report file it is recommended to use a RAM disk, for
instance: RAM:$.Bugs
Versions
--------
1.20 -via option included
options window restructured
Conditions of Use
-----------------
This application is supplied free to everyone 'as is', I
do not give any guarantee that it is free of bugs, or
supply any warranty about it's suitabliliy for use. However
if there are any problems with it and you notify me of them
then I probably will do my best to recify them.
You are may give this application to anyone, via any
medium, so long as:
1) It is delivered with ALL the supplied files and
unaltered
2) It is not supplied on a disc you are charging for.
You have permission to use any part or the whole
application in a project you intend to place in the public
domain, as long as I am fully credited. If you wish to use
these routines in a program that is for sale (for however
much and for whatever reasons) or released as copyright
material then my express permission in writing must be
obtained. I maintain copyright on all the material
supplied and reserve the right to amend these conditions in
case where I deem misuse.
Contacts
--------
My address:
Brouwersgracht 190 C
1013 HC Amsterdam
The Netherlands
You can also contact me via:
Acorn BBS, Amsterdam tel. (0)20-6631849
Usenet/Eunet EMAIL walther@econ.vu.nl
Walther Schoonenberg