diff options
Diffstat (limited to 'win32')
| -rw-r--r-- | win32/readme.txt | 114 | ||||
| -rw-r--r-- | win32/tcc-win32.txt | 158 |
2 files changed, 158 insertions, 114 deletions
diff --git a/win32/readme.txt b/win32/readme.txt deleted file mode 100644 index ee17687..0000000 --- a/win32/readme.txt +++ /dev/null @@ -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 diff --git a/win32/tcc-win32.txt b/win32/tcc-win32.txt new file mode 100644 index 0000000..5b8ddb4 --- /dev/null +++ b/win32/tcc-win32.txt @@ -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 |