added -f[no-]leading-underscore - '@' symbol for asm
[tinycc/daniel.git] / win32 / readme.txt
blobe4db70b2ad696b21ac1e3a3441ece1de7ccffcb4
2         TinyCC-PE
3         ---------
5         TinyCC (aka TCC) is a small but hyperfast C compiler,
6         written by Fabrice Bellard,
9         TinyCC-PE is the TinyCC compiler with an extension to
10         write PE executables for MS-Windows.
13         Features:
14         ---------
16         TinyCC-PE can produce console applications, native windows
17         GUI programs and DLL's.
19         Most of the features pointed out by Fabrice Bellard for the
20         original version are still valid, i.e:
22         - SMALL! The package with ~400kb includes a complete C-compiler
23           with header files for console and GUI applications.
25         - With the -run switch you can run C-sources without any
26           linking directly from the command line.
28         - TCC can of course compile itself.
31         Installation:
32         -------------
34         Just unzip the package to a directory anywhere on your computer.
37         Examples:
38         ---------
40         For the 'Fibonacci' console example type from the command line:
42                 tcc examples\fib.c
45         For the 'Hello Windows' GUI example:
47                 tcc examples\hello_win.c
50         For the 'Hello DLL' example:
52                 tcc -shared examples\dll.c
53                 tcc examples\hello_dll.c examples\dll.def
56         Import Definitions:
57         -------------------
59         TinyCC-PE searches and reads import definition files similar
60         to libraries.
62         The included 'tiny_impdef' program may be used to make .def files
63         for any DLL, e.g for an 'opengl32.def':
65                 tiny_impdef.exe opengl32.dll
67         or to the same effect:
69                 tcc -lkernel32 -run tiny_impdef.c opengl32.dll
72         Header Files:
73         -------------
75         The system header files, except '_mingw.h', are from the
76         2.0 mingw distribution. See also: http://www.mingw.org/
79         Compile TCC:
80         ------------
82         With TCC itself just say:
84                 tcc src\tcc.c -lkernel32 -o tcc.new.exe
86         Other compilers like mingw-gcc or msvc work as well.
87         To make libtcc1.a, you need 'ar' from the mingw binutils.
90         Documentation and License:
91         --------------------------
93         TCC is distributed under the GNU Lesser General Public License
94         (see COPYING file).
96         Please read the original tcc-doc.html to have all the features
97         of TCC. Also visit: http://fabrice.bellard.free.fr/tcc/
100         --------------------------------------------
101         09.Apr.2005 - grischka@users.sourceforge.net