win32: readme.txt->tcc-win32.txt, update tcc-doc
This commit is contained in:
grischka
114
win32/readme.txt
114
win32/readme.txt
@ -1,114 +0,0 @@
|
||||
|
||||
TinyCC
|
||||
======
|
||||
|
||||
This file contains some additional information for usage of TinyCC
|
||||
under MS-Windows:
|
||||
|
||||
|
||||
Overview:
|
||||
---------
|
||||
TinyCC (aka TCC) is a small but hyperfast C compiler, written by
|
||||
Fabrice Bellard.
|
||||
|
||||
TinyCC for MS-Windows can produce console applications, native
|
||||
windows GUI programs and DLL's.
|
||||
|
||||
The package with under 300kb includes a complete C-compiler with
|
||||
header files and basic system library support.
|
||||
|
||||
With the -run switch you can run C-sources without any linking
|
||||
directly from the command line.
|
||||
|
||||
TinyCC can be used as dynamic code generator library in your own
|
||||
program.
|
||||
|
||||
TinyCC can of course compile itself.
|
||||
|
||||
|
||||
Compilation: (omit that if you use the binary ZIP package)
|
||||
------------
|
||||
You can use the MinGW and MSYS tools available at
|
||||
http://www.mingw.org to compile TCC for Windows. Untar the TCC
|
||||
archive and type in the MSYS shell:
|
||||
|
||||
./configure
|
||||
make
|
||||
make install
|
||||
|
||||
TCC is installed in c:\Program Files\tcc
|
||||
|
||||
Alternatively you can use win32\build-tcc.bat to compile TCC
|
||||
with just gcc and ar from MINGW. To install, copy the entire
|
||||
contents of the win32 directory to where you want.
|
||||
|
||||
|
||||
Installation: (from the binary ZIP package)
|
||||
-------------
|
||||
Just unzip the package to a directory anywhere on your computer.
|
||||
|
||||
The binary package does not include libtcc. If you want tcc as
|
||||
dynamic code generator, please use the source code distribution.
|
||||
|
||||
|
||||
Examples:
|
||||
---------
|
||||
For the 'Fibonacci' console example type from the command line:
|
||||
|
||||
tcc examples\fib.c
|
||||
|
||||
For the 'Hello Windows' GUI example:
|
||||
|
||||
tcc examples\hello_win.c
|
||||
|
||||
For the 'Hello DLL' example:
|
||||
|
||||
tcc -shared examples\dll.c
|
||||
tcc examples\hello_dll.c examples\dll.def
|
||||
|
||||
|
||||
Import Definition Files:
|
||||
------------------------
|
||||
To link with Windows system DLLs, TinyCC uses import definition
|
||||
files (.def) instead of libraries.
|
||||
|
||||
The included 'tiny_impdef' program may be used to make additional
|
||||
.def files for any DLL. For example:
|
||||
|
||||
tiny_impdef.exe opengl32.dll
|
||||
|
||||
To use it, put the opengl32.def file into the tcc/lib directory,
|
||||
and specify -lopengl32 at the tcc commandline.
|
||||
|
||||
|
||||
Resource Files:
|
||||
---------------
|
||||
TinyCC-PE can now link windows resources in coff format as generated
|
||||
by MINGW's windres.exe. For example:
|
||||
|
||||
windres -O coff app.rc -o appres.o
|
||||
tcc app.c appres.o -o app.exe
|
||||
|
||||
|
||||
Tiny Libmaker:
|
||||
--------------
|
||||
The included tiny_libmaker tool by Timovj Lahde can be used as
|
||||
'ar' replacement to make a library from several object files.
|
||||
|
||||
|
||||
Header Files:
|
||||
-------------
|
||||
The system header files (except _mingw.h) are from the mingw
|
||||
distribution (http://www.mingw.org/).
|
||||
|
||||
|
||||
Documentation and License:
|
||||
--------------------------
|
||||
TCC is distributed under the GNU Lesser General Public License
|
||||
(see COPYING file).
|
||||
|
||||
Please read tcc-doc.html to have all the features of TCC. Also
|
||||
visit: http://fabrice.bellard.free.fr/tcc/
|
||||
|
||||
|
||||
-- grischka@users.sourceforge.net
|
||||
158
win32/tcc-win32.txt
Normal file
158
win32/tcc-win32.txt
Normal file
@ -0,0 +1,158 @@
|
||||
|
||||
TinyCC
|
||||
======
|
||||
|
||||
This file contains specific information for usage of TinyCC
|
||||
under MS-Windows. See tcc-doc.html to have all the features.
|
||||
|
||||
|
||||
|
||||
Compilation from source:
|
||||
------------------------
|
||||
* You can use the MinGW and MSYS tools available at
|
||||
|
||||
http://www.mingw.org
|
||||
|
||||
Untar the TCC archive and type in the MSYS shell:
|
||||
|
||||
./configure
|
||||
make
|
||||
make install
|
||||
|
||||
The default install location is c:\Program Files\tcc
|
||||
|
||||
|
||||
* Alternatively you can compile TCC with just GCC from MinGW using
|
||||
|
||||
win32\build-tcc.bat
|
||||
|
||||
To install, copy the entire contents of the win32 directory to
|
||||
where you want.
|
||||
|
||||
|
||||
|
||||
Installation from the binary ZIP package:
|
||||
-----------------------------------------
|
||||
Unzip the package to a directory of your choice.
|
||||
|
||||
(Note that the binary package does not include libtcc. If you
|
||||
want TCC as dynamic code generator, please use the source code
|
||||
distribution.)
|
||||
|
||||
|
||||
|
||||
Set the system PATH:
|
||||
--------------------
|
||||
To be able to invoke the compiler from everywhere on your computer by
|
||||
just typing "tcc", please add the directory containing tcc.exe to your
|
||||
system PATH.
|
||||
|
||||
|
||||
|
||||
Examples:
|
||||
---------
|
||||
Open a console window (DOS box) and 'cd' to the examples directory.
|
||||
|
||||
For the 'Fibonacci' example type:
|
||||
|
||||
tcc fib.c
|
||||
|
||||
For the 'Hello Windows' GUI example type:
|
||||
|
||||
tcc hello_win.c
|
||||
|
||||
for the 'Hello DLL' example type
|
||||
|
||||
tcc -shared dll.c
|
||||
tiny_impdef dll.dll (optional)
|
||||
tcc hello_dll.c dll.def
|
||||
|
||||
|
||||
|
||||
Import Definition Files:
|
||||
------------------------
|
||||
To link with Windows system DLLs, TCC uses import definition
|
||||
files (.def) instead of libraries.
|
||||
|
||||
The included 'tiny_impdef' program may be used to make additional
|
||||
.def files for any DLL. For example:
|
||||
|
||||
tiny_impdef.exe opengl32.dll
|
||||
|
||||
Put opengl32.def into the tcc/lib directory. Specify -lopengl32 at
|
||||
the TCC commandline to link a program that uses opengl32.dll.
|
||||
|
||||
|
||||
|
||||
Header Files:
|
||||
-------------
|
||||
The system header files (except _mingw.h) are from the MinGW
|
||||
distribution:
|
||||
|
||||
http://www.mingw.org/
|
||||
|
||||
From the windows headers, only a minimal set is included. If you need
|
||||
more, get MinGW's "w32api" package.
|
||||
|
||||
|
||||
|
||||
Resource Files:
|
||||
---------------
|
||||
TCC can link windows resources in coff format as generated by MinGW's
|
||||
windres.exe. For example:
|
||||
|
||||
windres -O coff app.rc -o appres.o
|
||||
tcc app.c appres.o -o app.exe
|
||||
|
||||
|
||||
|
||||
Tiny Libmaker:
|
||||
--------------
|
||||
The included tiny_libmaker tool by Timovj Lahde can be used as
|
||||
'ar' replacement to make a library from several object files:
|
||||
|
||||
tiny_libmaker [rcs] library objectfiles ...
|
||||
|
||||
|
||||
|
||||
Limitations:
|
||||
------------
|
||||
- On the object file level, currently TCC supports only the ELF format,
|
||||
not COFF as used by MinGW and MSVC. It is not possible to exchange
|
||||
object files or libraries between TCC and these compilers. However
|
||||
libraries for TCC from objects by TCC can be made using tiny_libmaker
|
||||
or MinGW's ar.
|
||||
|
||||
- No leading underscore is generated in the ELF symbols.
|
||||
|
||||
- With DLLs, only functions (not data) can be im-/exported.
|
||||
|
||||
- Bounds checking (option -b) is not supported currently.
|
||||
|
||||
- 64-bit systems are not (yet) supported.
|
||||
|
||||
|
||||
|
||||
Documentation and License:
|
||||
--------------------------
|
||||
TCC is distributed under the GNU Lesser General Public License. (See
|
||||
COPYING file or http://www.gnu.org/licenses/lgpl-2.1.html)
|
||||
|
||||
TinyCC homepage is at:
|
||||
|
||||
http://fabrice.bellard.free.fr/tcc/
|
||||
|
||||
|
||||
|
||||
WinAPI Help and 3rd-party tools:
|
||||
--------------------------------
|
||||
The Windows API documentation (Win95) in a single .hlp file is
|
||||
available on the lcc-win32 site as "win32hlp.exe" or from other
|
||||
locations as "win32hlp_big.zip".
|
||||
|
||||
A nice RAD tool to create windows resources (dialog boxes etc.) is
|
||||
"ResEd", available at the RadASM website.
|
||||
|
||||
|
||||
|
||||
--- grischka
|
||||
Reference in New Issue
Block a user