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     Alternatively you can use win32\build-tcc.bat to compile TCC
  45     with just gcc and ar from MINGW. To install, copy the entire
  46     contents of the win32 directory to where you want.
  47
  48
  49     Installation: (from the binary ZIP package)
  50     -------------
  51
  52     Just unzip the package to a directory anywhere on your computer.
  53
  54
  55     Examples:
  56     ---------
  57
  58     For the 'Fibonacci' console example type from the command line:
  59
  60         tcc examples\fib.c
  61
  62     For the 'Hello Windows' GUI example:
  63
  64         tcc examples\hello_win.c
  65
  66     For the 'Hello DLL' example:
  67
  68         tcc -shared examples\dll.c
  69         tcc examples\hello_dll.c examples\dll.def
  70
  71
  72     Import Definitions:
  73     -------------------
  74
  75     TinyCC-PE searches and reads import definition files similar
  76     to libraries.
  77
  78     The included 'tiny_impdef' program may be used to make .def files
  79     for any DLL, e.g for an 'opengl32.def':
  80
  81         tiny_impdef.exe opengl32.dll
  82
  83     or to the same effect:
  84
  85         tcc -run tiny_impdef.c opengl32.dll
  86
  87
  88     Resource Files:
  89     ---------------
  90
  91     TinyCC-PE can now link windows resources in coff format as generated
  92     by MINGW's windres.exe. For example:
  93
  94         windres -O coff app.rc -o appres.o
  95         tcc app.c appres.o -o app.exe
  96
  97
  98     Header Files:
  99     -------------
 100
 101     The system header files, except '_mingw.h', are from the
 102     3.7 mingw distribution. See also: http://www.mingw.org/
 103
 104
 105     Compile TCC:
 106     ------------
 107
 108     With TCC itself just say:
 109
 110         tcc src\tcc.c -o tcc.new.exe
 111
 112     Other compilers like mingw-gcc or msvc work as well.
 113     To make libtcc1.a, you need 'ar' from the mingw binutils.
 114
 115
 116     Documentation and License:
 117     --------------------------
 118
 119     TCC is distributed under the GNU Lesser General Public License
 120     (see COPYING file).
 121
 122     Please read the original tcc-doc.html to have all the features
 123     of TCC. Also visit: http://fabrice.bellard.free.fr/tcc/
 124
 125     --
 126     grischka@users.sourceforge.net