win32/readme.txt

   1
   2     TinyCC
   3     ======
   4
   5     This file contains some additional information for usage of TinyCC
   6     under MS-Windows:
   7
   8
   9     Overview:
  10     ---------
  11     TinyCC (aka TCC) is a small but hyperfast C compiler, written by
  12     Fabrice Bellard.
  13
  14     TinyCC for MS-Windows can produce console applications, native
  15     windows GUI programs and DLL's.
  16
  17     The package with under 300kb includes a complete C-compiler with
  18     header files and basic system library support.
  19
  20     With the -run switch you can run C-sources without any linking
  21     directly from the command line.
  22
  23     TinyCC can be used as dynamic code generator library in your own
  24     program.
  25
  26     TinyCC can of course compile itself.
  27
  28
  29     Compilation:  (omit that if you use the binary ZIP package)
  30     ------------
  31     You can use the MinGW and MSYS tools available at
  32     http://www.mingw.org to compile TCC for Windows. Untar the TCC
  33     archive and type in the MSYS shell:
  34
  35        ./configure
  36        make
  37        make install
  38
  39        TCC is installed in c:\Program Files\tcc
  40
  41     Alternatively you can use win32\build-tcc.bat to compile TCC
  42     with just gcc and ar from MINGW. To install, copy the entire
  43     contents of the win32 directory to where you want.
  44
  45
  46     Installation: (from the binary ZIP package)
  47     -------------
  48     Just unzip the package to a directory anywhere on your computer.
  49
  50     The binary package does not include libtcc. If you want tcc as
  51     dynamic code generator, please use the source code distribution.
  52
  53
  54     Examples:
  55     ---------
  56     For the 'Fibonacci' console example type from the command line:
  57
  58         tcc examples\fib.c
  59
  60     For the 'Hello Windows' GUI example:
  61
  62         tcc examples\hello_win.c
  63
  64     For the 'Hello DLL' example:
  65
  66         tcc -shared examples\dll.c
  67         tcc examples\hello_dll.c examples\dll.def
  68
  69
  70     Import Definition Files:
  71     ------------------------
  72     To link with Windows system DLLs, TinyCC uses import definition
  73     files (.def) instead of libraries.
  74
  75     The included 'tiny_impdef' program may be used to make additional
  76     .def files for any DLL. For example:
  77
  78         tiny_impdef.exe opengl32.dll
  79
  80     To use it, put the opengl32.def file into the tcc/lib directory,
  81     and specify -lopengl32 at the tcc commandline.
  82
  83
  84     Resource Files:
  85     ---------------
  86     TinyCC-PE can now link windows resources in coff format as generated
  87     by MINGW's windres.exe. For example:
  88
  89         windres -O coff app.rc -o appres.o
  90         tcc app.c appres.o -o app.exe
  91
  92
  93     Tiny Libmaker:
  94     --------------
  95     The included tiny_libmaker tool by Timovj Lahde can be used as
  96     'ar' replacement to make a library from several object files.
  97
  98
  99     Header Files:
 100     -------------
 101     The system header files (except _mingw.h) are from the mingw
 102     distribution (http://www.mingw.org/).
 103
 104
 105     Documentation and License:
 106     --------------------------
 107     TCC is distributed under the GNU Lesser General Public License
 108     (see COPYING file).
 109
 110     Please read tcc-doc.html to have all the features of TCC. Also
 111     visit: http://fabrice.bellard.free.fr/tcc/
 112
 113
 114     -- grischka@users.sourceforge.net