move some global variables into TCCState
[tinycc.git] / README
blobbfaab3989e156871a38bd86e0c673b274be94592
1 Tiny C Compiler - C Scripting Everywhere - The Smallest ANSI C compiler
2 -----------------------------------------------------------------------
4 Features:
5 --------
7 - SMALL! You can compile and execute C code everywhere, for example on
8   rescue disks.
10 - FAST! tcc generates optimized x86 code. No byte code
11   overhead. Compile, assemble and link about 7 times faster than 'gcc
12   -O0'.
14 - UNLIMITED! Any C dynamic library can be used directly. TCC is
15   heading torward full ISOC99 compliance. TCC can of course compile
16   itself.
18 - SAFE! tcc includes an optional memory and bound checker. Bound
19   checked code can be mixed freely with standard code.
21 - Compile and execute C source directly. No linking or assembly
22   necessary. Full C preprocessor included. 
24 - C script supported : just add '#!/usr/local/bin/tcc -run' at the first
25   line of your C source, and execute it directly from the command
26   line.
28 Documentation:
29 -------------
31 1) Installation on a i386 Linux host (for Windows read tcc-win32.txt)
33    ./configure
34    make
35    make test
36    make install
38 By default, tcc is installed in /usr/local/bin.
39 ./configure --help  shows configuration options.
42 2) Introduction
44 We assume here that you know ANSI C. Look at the example ex1.c to know
45 what the programs look like.
47 The include file <tcclib.h> can be used if you want a small basic libc
48 include support (especially useful for floppy disks). Of course, you
49 can also use standard headers, although they are slower to compile.
51 You can begin your C script with '#!/usr/local/bin/tcc -run' on the first
52 line and set its execute bits (chmod a+x your_script). Then, you can
53 launch the C code as a shell or perl script :-) The command line
54 arguments are put in 'argc' and 'argv' of the main functions, as in
55 ANSI C.
57 3) Examples
59 ex1.c: simplest example (hello world). Can also be launched directly
60 as a script: './ex1.c'.
62 ex2.c: more complicated example: find a number with the four
63 operations given a list of numbers (benchmark).
65 ex3.c: compute fibonacci numbers (benchmark).
67 ex4.c: more complicated: X11 program. Very complicated test in fact
68 because standard headers are being used !
70 ex5.c: 'hello world' with standard glibc headers.
72 tcc.c: TCC can of course compile itself. Used to check the code
73 generator.
75 tcctest.c: auto test for TCC which tests many subtle possible bugs. Used
76 when doing 'make test'.
78 4) Full Documentation
80 Please read tcc-doc.html to have all the features of TCC.
82 Additional information is available for the Windows port in tcc-win32.txt.
84 License:
85 -------
87 TCC is distributed under the GNU Lesser General Public License (see
88 COPYING file).
90 Fabrice Bellard.