tools.hsc

CC386 is a general-purpose 32-bit C compiler. It is not an optimizing compiler but given that the co

\par of the General Public License from time to time.  Such new versions will
\par be similar in spirit to the present version, but may differ in detail to
\par address new problems or concerns.
\par 
\par Each version is given a distinguishing version number.  If the Program
\par specifies a version number of this License which applies to it and "any
\par later version", you have the option of following the terms and conditions
\par either of that version or of any later version published by the Free
\par Software Foundation.  If the Program does not specify a version number of
\par this License, you may choose any version ever published by the Free Software
\par Foundation.
\par 
\par   10. If you wish to incorporate parts of the Program into other free
\par programs whose distribution conditions are different, write to the author
\par to ask for permission.  For software which is copyrighted by the Free
\par Software Foundation, write to the Free Software Foundation; we sometimes
\par make exceptions for this.  Our decision will be guided by the two goals
\par of preserving the free status of all derivatives of our free software and
\par of promoting the sharing and reuse of software generally.
\par 
\par                             NO WARRANTY
\par 
\par   11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
\par FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
\par OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
\par PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
\par OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
\par MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
\par TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
\par PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
\par REPAIR OR CORRECTION.
\par 
\par   12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
\par WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
\par REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
\par INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
\par OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
\par TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
\par YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
\par PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
\par POSSIBILITY OF SUCH DAMAGES.
\par 
\par                      END OF TERMS AND CONDITIONS
\par \page 
\par             How to Apply These Terms to Your New Programs
\par 
\par   If you develop a new program, and you want it to be of the greatest
\par possible use to the public, the best way to achieve this is to make it
\par free software which everyone can redistribute and change under these terms.
\par 
\par   To do so, attach the following notices to the program.  It is safest
\par to attach them to the start of each source file to most effectively
\par convey the exclusion of warranty; and each file should have at least
\par the "copyright" line and a pointer to where the full notice is found.
\par 
\par     <one line to give the program's name and a brief idea of what it does.>
\par     Copyright (C) 19yy  <name of author>
\par 
\par     This program is free software; you can redistribute it and/or modify
\par     it under the terms of the GNU General Public License as published by
\par     the Free Software Foundation; either version 2 of the License, or
\par     (at your option) any later version.
\par 
\par     This program is distributed in the hope that it will be useful,
\par     but WITHOUT ANY WARRANTY; without even the implied warranty of
\par     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
\par     GNU General Public License for more details.
\par 
\par     You should have received a copy of the GNU General Public License
\par     along with this program; if not, write to the Free Software
\par     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
\par 
\par 
\par Also add information on how to contact you by electronic and paper mail.
\par 
\par If the program is interactive, make it output a short notice like this
\par when it starts in an interactive mode:
\par 
\par     Gnomovision version 69, Copyright (C) 19yy name of author
\par     Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
\par     This is free software, and you are welcome to redistribute it
\par     under certain conditions; type `show c' for details.
\par 
\par The hypothetical commands `show w' and `show c' should show the appropriate
\par parts of the General Public License.  Of course, the commands you use may
\par be called something other than `show w' and `show c'; they could even be
\par mouse-clicks or menu items--whatever suits your program.
\par 
\par You should also get your employer (if you work as a programmer) or your
\par school, if any, to sign a "copyright disclaimer" for the program, if
\par necessary.  Here is a sample; alter the names:
\par 
\par   Yoyodyne, Inc., hereby disclaims all copyright interest in the program
\par   `Gnomovision' (which makes passes at compilers) written by James Hacker.
\par 
\par   <signature of Ty Coon>, 1 April 1989
\par   Ty Coon, President of Vice
\par 
\par This General Public License does not permit incorporating your program into
\par proprietary programs.  If your program is a subroutine library, you may
\par consider it more useful to permit linking proprietary applications with the
\par library.  If this is what you want to do, use the GNU Library General
\par Public License instead of this License.
\par \cf1\b\fs32 
\par }
15
Scribble15
CC386 compiler




Writing



FALSE
15
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1460\cf1\b\fs32 CC386 Compiler
\par 
\par \cf0\b0\fs20 The CC386 C compiler has support for ANSI C, and supports a small subset of C++ functionality.
\par Some of the newer features of ANSI-99 still are not supported however.  This is a fully functional compiler, and will even generate Debug information; however the debug information is a variation of the earlier microsoft CodeView format.  The included IDE is the only debugger capable of understanding it.
\par 
\par The following help topics are available:
\par \pard\ri1440\tx720 
\par \tab\cf2\strike Command line syntax\cf3\strike0\{linkID=110\}\cf0 
\par \tab\cf2\strike Extended Keywords\cf3\strike0\{linkID=120\}
\par \tab\cf2\strike #pragma directives\cf3\strike0\{linkID=130\}\cf0\f1 
\par 
\par \cf1\b\f0\fs32 
\par }
20
Scribble20
NASM assembler




Writing



FALSE
10
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 NASM Assembler
\par 
\par \cf0\b0\fs20 The NASM (Netwide) assembler is an up-to-date assembler for current x86 processors; sources are available on the net.  The version included in this package is relatively recent, and was compiled with no changes other than to add a resource section.  Refer to the seperate NASM documentation if you need to code assembly language for this assembler.\f1 
\par 
\par \f0 The following help topics are available:
\par 
\par \pard\ri1460\tx720\tab\cf2\strike Command line syntax\cf3\strike0\{linkID=140\}\cf0\f1 
\par }
30
Scribble30
VALX Linker




Writing



FALSE
11
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil Arial;}{\f1\fnil\fcharset0 Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1460\cf1\b\f0\fs32 VALX Linker\cf0\b0\fs20 
\par 
\par \f1 The VALX linker is an extension of a public-domain linker called VAL; the extensions include support for 32 bit code and Windows PE files.  Note that this linker uses the legacy DOS OMF file format and is not compatible with files and libraries distributed by microsoft.  The purpose of VALX is to take compiled files and turn them into an executable program.  VALX will also work with 16 bit DOS programs, however this usage is deprecated for purposes of the CC386 compiler.
\par 
\par The following help topics are available:
\par 
\par \pard\ri1440\tx700\tab\cf2\strike Command Line Syntax\cf3\strike0\{linkID=150\}\cf0\tab 
\par \pard\ri1460\tab\f0 
\par }
40
Scribble40
XLIB Librarian




Writing



FALSE
10
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil Arial;}{\f1\fnil\fcharset0 Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1460\cf1\b\f0\fs32 XLIB Librarian\cf0\b0\fs20 
\par 
\par \f1 The Xlib librarian is a simple librarian patterened after the old DOS librarians.  Its purpose is to gather a group of compiled files together into a logical grouping called a library.
\par 
\par The following help topics are available:
\par 
\par \pard\ri1440\tx700\tab\cf2\strike Command Line Syntax\cf3\strike0\{linkID=160\}\cf0\f0 
\par }
42
Scribble42
IMPORT Librarian




Writing



FALSE
10
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 IMPORT Librarian\cf0\b0\f1\fs20 
\par 
\par \f0 The IMPORT program is used to make OMF style import libraries from a DLL's export section.  It can  also make simple .DEF files based on the contents of the DLL.
\par 
\par The following help topics are available:
\par 
\par \pard\ri1460\tx700\tab\cf2\strike Command line syntax\cf3\strike0\{linkID=172\}\cf0\f1 
\par }
45
Scribble45
MKLIBLST Library Utility




Writing



FALSE
12
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 MKLIBLST Library Utility\cf0\b0\f1\fs20 
\par 
\par \f0 MKLIBLST is used to create or append to a response file used in creating a library.  The idea is that if there are a bunch of source files scattered across a disk, you compile them and gather their objects into one place, possibly creating the definition file as you go along.  Then when the build succeeds XLIB can use the definition file to determine what files to import into the library.
\par 
\par The following help topics are available:
\par \pard\ri1460\tx720 
\par \tab\cf2\strike Command line syntax\cf3\strike0\{linkID=170\}\cf0 
\par \tab\cf2\strike Using the definition file\cf3\strike0\{linkID=175\}\cf0 
\par \pard\ri1480\tab\f1 
\par }
50
Scribble50
XRC Resource compiler




Writing



FALSE
12
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil Arial;}{\f1\fnil\fcharset0 Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1460\cf1\b\f0\fs32 XRC Resource compiler\cf0\b0\fs20 
\par 
\par \f1 The XRC compiler takes an .RC file and makes a .RES file out of it.  The .RES file gets linked to the image with VALX and creates predefined resources used by the executable.
\par 
\par The syntax of a .RC file is beyond the scope of this documentation; refer to external documentation.
\par 
\par The following help topics are available:
\par 
\par \pard\ri1440\tx700\tab\cf2\strike Command line syntax\cf3\strike0\{linkID=180\}\cf0\f0 
\par }
60
Scribble60
CL386




Writing



FALSE
11
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1460\cf1\b\fs32 CL386 Compiler shell\cf0\b0\f1\fs20 
\par 
\par \f0 The CL386 compiler shell combines the various stages of processing required to change source files into an executable program.
\par 
\par The following help topics are available:
\par \tab 
\par \pard\ri1440\tx680\tab\cf2\strike Command line syntax\cf3\strike0\{linkID=190\}\cf0\f1 
\par \cf1\b\fs32 
\par }
70
Scribble70
IMAKE make utility




Writing



FALSE
13
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green128\blue0;\red128\green0\blue0;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 IMAKE make utility\cf0\b0\f1\fs20 
\par 
\par \f0 The IMAKE utility is a generic make program styled after borland make.  It takes a MAKEFILE and uses it along with file time stamps to determine what aspects of the program have to be recompiled/rebuilt to create the executable.  Note that this is a very primitive type of make; it fully supports macro expansion, ifdef and so forth, and the basics of explicit and implicit rules.  Advanced features found in other make programs are however not present.
\par 
\par The syntax of a MAKEFILE is beyond the scope of this document.
\par 
\par The following help topics are available:
\par 
\par \pard\ri1460\tx700\tab\cf2\strike Command line syntax\cf3\strike0\{linkID=200\}\cf0\f1 
\par \pard\ri1480\cf1\b\fs32 
\par }