win32/readme.txt

   1
   2         TinyCC-PE
   3         ---------
   4
   5         TinyCC (aka TCC) is a small but hyperfast C compiler,
   6         written by Fabrice Bellard,
   7
   8
   9         TinyCC-PE is the TinyCC compiler with an extension to
  10         write PE executables for MS-Windows.
  11
  12
  13         Features:
  14         ---------
  15
  16         TinyCC-PE can produce console applications, native windows
  17         GUI programs and DLL's.
  18
  19         Most of the features pointed out by Fabrice Bellard for the
  20         original version are still valid, i.e:
  21
  22         - SMALL! The package with ~400kb includes a complete C-compiler
  23           with header files for console and GUI applications.
  24
  25         - With the -run switch you can run C-sources without any
  26           linking directly from the command line.
  27
  28         - TCC can of course compile itself.
  29
  30
  31         Compilation:  (omit that if you use the binary ZIP package)
  32         ------------
  33
  34         You must use the MinGW and MSYS tools available at
  35         http://www.mingw.org to compile TCC for Windows. Untar the TCC
  36         archive and type in the MSYS shell:
  37
  38            ./configure
  39            make
  40            make install
  41
  42            TCC is installed in c:\Program Files\tcc
  43
  44         Installation: (from the binary ZIP package)
  45         -------------
  46
  47         Just unzip the package to a directory anywhere on your computer.
  48
  49
  50         Examples:
  51         ---------
  52
  53         For the 'Fibonacci' console example type from the command line:
  54
  55                 tcc examples\fib.c
  56
  57
  58         For the 'Hello Windows' GUI example:
  59
  60                 tcc examples\hello_win.c
  61
  62
  63         For the 'Hello DLL' example:
  64
  65                 tcc -shared examples\dll.c
  66                 tcc examples\hello_dll.c examples\dll.def
  67
  68
  69         Import Definitions:
  70         -------------------
  71
  72         TinyCC-PE searches and reads import definition files similar
  73         to libraries.
  74
  75         The included 'tiny_impdef' program may be used to make .def files
  76         for any DLL, e.g for an 'opengl32.def':
  77
  78                 tiny_impdef.exe opengl32.dll
  79
  80         or to the same effect:
  81
  82                 tcc -lkernel32 -run tiny_impdef.c opengl32.dll
  83
  84
  85         Header Files:
  86         -------------
  87
  88         The system header files, except '_mingw.h', are from the
  89         2.0 mingw distribution. See also: http://www.mingw.org/
  90
  91
  92         Compile TCC:
  93         ------------
  94
  95         With TCC itself just say:
  96
  97                 tcc src\tcc.c -lkernel32 -o tcc.new.exe
  98
  99         Other compilers like mingw-gcc or msvc work as well.
 100         To make libtcc1.a, you need 'ar' from the mingw binutils.
 101
 102
 103         Documentation and License:
 104         --------------------------
 105
 106         TCC is distributed under the GNU Lesser General Public License
 107         (see COPYING file).
 108
 109         Please read the original tcc-doc.html to have all the features
 110         of TCC. Also visit: http://fabrice.bellard.free.fr/tcc/
 111
 112
 113         --------------------------------------------
 114         09.Apr.2005 - grischka@users.sourceforge.net
 115