443
edits
-
Changes
Created page with " If using the compiler on a hard disk system you will need to install the compiler before using it. See the "Installation" chapter for more details. If using a flo..."
If using the compiler on a hard disk system you will
need to install the compiler before using it. See the
"Installation" chapter for more details. If using a floppy
disk based system, in general you should have a copy of the
distribution disk #1 in drive A: and maintain your files on
a disk in the B: drive. Again see the "Installation" chapter
for more information.
main()
{
printf("Hello, world\n");
}
Fig. 1. Sample C Program
Before compiling your program it must be contained in a
file with an extension (or file type, i.e. that part of the
name after the '.') of .C. For example you may type the
program shown in fig. 1 into a file called HELLO.C. You will
need a text editor to do this. Generally any text editor
that can create a straight ASCII file (i.e. not a "word pro-
cessor" type file) will be suitable. If using editors such
as Wordstar, you should use the "non-document mode". Once
you have the program in such a file all that is required to
compile it is to issue the C command, e.g. to compile
HELLO.C simply type the command
C -V HELLO.C
Cross compilers (i.e. compilers that operate on one system
but produce code for a separate target system) will have a
compiler driver named slightly differently, e.g. the 68HC11
cross compiler driver is called C68.
If you are using a floppy disk based system (or a CP/M
system) it may be necessary to specify where to find the C
command, e.g. if the C command is on a disk in drive A: and
you are working on B:, type the command
A:C -V HELLO.C
The compiler will issue a sign on message, then proceed
to execute the various passes of the compiler in sequence to
compile the program. If you are using a floppy disk based
system where the compiler will not fit on a single disk you
will be prompted to change disks whenever the compiler can-
not find a pass. In this case you should insert a copy of
the next distribution disk in drive A: and press RETURN.
As each pass of the compiler is about to be executed, a
command line to that pass will be displayed on the screen.
This is because the -V option has been used. This stands for
Verbose, and had it not been given the compilation would
have been silent except for the sign on message. Error mes-
sages can be redirected to a file by using the standard out-
put redirection notation, e.g. > _�s_�o_�m_�e_�f_�i_�l_�e.
After completion of compilation, the compiler will exit
to command level. You will notice that several temporary
files created during compilation will have been deleted, and
all that will be left on the disk (apart from the original
source file HELLO.C) will be an executable file. The name of
this executable file will be HELLO.EXE for MS-DOS, HELLO.PRG
for the Atari ST, HELLO.COM for CP/M-80 and HELLO.CMD for
CP/M-86. For cross compilers it will be called HELLO.HEX or
HELLO.BIN depending on the default output format for the
particular compiler. To execute this program, simply type
HELLO
and you should be rewarded with the message "Hello, world!"
on your screen. If you are using a cross compiler you will
need to put the program into EPROM or download to the target
system to execute it. Cross compilers do not produce pro-
grams executable on the host system.
There are other options that may be used with the C
command, but you will not need to use them unless you wish
to do so. If you are new to the C language it will be advis-
able to enter and compile a few simple programs (e.g. drawn
from one of the C reference texts mentioned above) before
exploring other capabilities of the HI-TECH C compiler.
There is one exception to the above; if you compile a
program which uses floating point arithmetic (i.e. real
numbers) you MUST specify to the compiler that the floating
point library should be searched. This is done with a -LF
option at the END of the command line, e.g.
C -V FLOAT.C -LF
