ccide.hsc

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

\viewkind4\uc1\pard\tx720\cf1\b\fs32 General Properties Dialog\cf0\b0\f1\fs20 
\par 
\par \f0 The general properties dialog lets you set general properties of the IDE, such as editor properties.
\par 
\par This dialog has the following panes:
\par 
\par \tab\cf2\strike Editor Configuration\cf3\strike0\{linkID=120\}\cf0 
\par \tab\cf2\strike General Configuration\cf3\strike0\{linkID=125\}\cf0 
\par \pard\ri1480\tx720\tx8500\tab\cf2\strike Install Configuration\cf3\strike0\{linkID=127\}\cf0 
\par \pard\tx720 
\par Properties specific to building programs are on the \cf2\strike Target Properties\cf3\strike0\{linkID=131\}\cf0  dialog\f1 
\par }
130
Scribble130
General Target Properties




Writing



FALSE
35
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 General Target Properties\cf0\b0\f1\fs20 
\par 
\par \f0 The target properites property sheet has five dialogs related to setting up the build/debug settings for the target.
\par 
\par This pane holds the general build settings for the target.  The following settings are supported:
\par 
\par \pard\ri1460\tx720\tx2800\tx3680\tab Build Type\tab Selects the type of executable file.  Values are as follows:
\par 
\par \pard\fi-5660\li5660\ri1440\tx720\tx2780\tx3660\tx5660\tab\tab\tab Windows Console\tab makes a windows console mode program
\par \tab\tab\tab Windows GUI\tab makes a windowing program
\par \tab\tab\tab Windows DLL\tab makes a windows DLL
\par \tab\tab\tab MSDOS executable\tab makes a DOS/DPMI executable (DOS32A)
\par \tab\tab\tab Library\tab makes a link-time library
\par \tab\tab\tab Raw\tab makes a raw image without one of the standard EXE headers
\par 
\par \tab Library Type\tab Selects the type of library support
\par 
\par \tab\tab\tab Standard\tab use the CC386 native libraries
\par \tab\tab\tab CRTDLL.DLL\tab use the WIN32 CRTDLL library
\par \tab\tab\tab No Library\tab don't use C runtime libraries (windows import libraries will still be included if you select a WIN32 target)
\par \pard\fi-2780\li2780\ri1440\tx720\tx2780\tx3660 
\par \tab Map File\tab Select this if a map file is to be generated
\par \tab Debug Information\tab Select this if debug information is to be generated
\par \tab Compile via ASM\tab Selected this to compile to assembly code, and assemble the result
\par \tab C99 Mode\tab Select C99 compiler features
\par \tab ANSI Compatibility\tab Select strict mode; disable non-ANSI extensions
\par \tab Auto Select Target\tab Select this to have CCIDE auto-select the first target when it needs a target and one is not selected
\par \tab Show Warnings\tab Select this if you want to see compile-time warnings
\par \tab Include path\tab Selects the path settings to be used for finding included files.  The setting may consist of multiple paths seperated by a semicolon
\par \tab Output Path\tab Selects the path where output files will be placed
\par 
\par 
\par }
131
Scribble131
Target Properties Dialog




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\ri1460\cf1\b\fs32 Target Properties Dialog\cf0\b0\f1\fs20 
\par 
\par \f0 The Target Properties Dialog has several panes for setting the compile and debug properties of a target.  These panes are as follows:
\par 
\par \pard\fi-4240\li4240\ri1440\tx700\tx4240\tab\cf2\strike General Target Properties\cf3\strike0\{linkID=130\}\cf0\tab General compile-time properties
\par \tab\cf2\strike Debug Target Properties\cf3\strike0\{linkID=132\}\cf0\tab General debugger properties
\par \tab\cf2\strike Define Properties\cf3\strike0\{linkID=134\}\cf0\tab Specifies defines to be placed on the command line
\par \tab\cf2\strike Tool Option Properties\cf3\strike0\{linkID=135\}\cf0\tab Allows specifying extended parameters for the tools
\par \tab\cf2\strike Pre Build Step\cf3\strike0\{linkID=137\}\cf0\tab Specifies tasks to be performed before building
\par \tab\cf2\strike Post Build Step\cf3\strike0\{linkID=139\}\cf0\tab Specifies tasks to be performed after a successful build\f1 
\par }
132
Scribble132
Debug Target Properties




Writing



FALSE
15
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1460\cf1\b\fs32 Debug Target Properties\cf0\b0\f1\fs20 
\par 
\par \f0 The target properites property sheet has five dialogs related to setting up the build/debug settings for the target.
\par 
\par This pane holds debugger settings for the target.  The following settings are supported:
\par \pard\fi-3360\li3360\ri1440\tx700\tx3360 
\par \pard\fi-3680\li3680\ri1440\tx680\tx3680\tab Break in winmain\tab Set this to stop at the beginning of the program
\par \tab Break at DLL Entry point\tab Set this to stop at the beginning of debugable dlls
\par \tab Stop before exception handling\tab Set this to abort when an exception is handled.  Reset it to cause the standard exception handling be considered
\par \tab Tool tips\tab Set this if tool tips are to be displayed while browsing source files in debug mode
\par 
\par 
\par }
134
Scribble134
Define Properties




Writing



FALSE
9
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;\red0\green0\blue0;}
\viewkind4\uc1\pard\cf1\b\fs32 Define Properties\cf2\b0\f1\fs20 
\par \pard\ri1460 
\par \f0 The define properties dialog is a generic dialog that lets you set up command line defines and their definition.  For example, for each define in the list a -D switch is added to the compiler command line to create the definition.  Defines are sent to the compiler, the assembler, and the resource compiler.
\par 
\par In this dialog, one can add or remove definitions by selecting them, then pressing the ADD or REMOVE buttons.  To give a definition a value, select it, then type in the VALUE dialog box.  
\par 
\par }
135
Scribble135
Tool Option Properties




Writing



FALSE
14
{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\fnil\fcharset0 Arial;}{\f1\fnil Arial;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ri1480\cf1\b\fs32 Tool Option Properties\cf0\b0\f1\fs20 
\par 
\par \f0 The target properites property sheet has three dialogs related to setting up the build/debug settings for the target.
\par 
\par This pane lets you customize options for the various tools that are used to compile code.  In general nothing needs to be set here as CCIDE will automatically configure options based on other property settings.
\par 
\par \pard\fi-2780\li2780\ri1460\tx700\tx2780\tab Compiler\tab Sets options for the compiler
\par \tab Assembler\tab Sets options for the assembler
\par \tab Linker\tab Sets options for the linker
\par \tab Librarian\tab Sets options for the librarian\f1 
\par 
\par }
137
Scribble137
Pre Build Step




Writing



FALSE
23
{\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 Pre Build Step\cf0\b0\f1\fs20 
\par 
\par \f0 The target properites property sheet has five dialogs related to setting up the build/debug settings for the target.
\par 
\par The information in the Pre Build Step window is used to automate an extra sequence of commands, which executes just prior to the normal build for the given target.  Each command is executed using the equivalent of the C language 'system' command.
\par 
\par The following fields are defined:
\par 
\par \pard\fi-2800\li2800\ri1460\tx700\tx2800\tab label\tab a label displayed in the error window prior to executing the commands
\par \tab build steps\tab a list of commands to execute.  Each line in this window will be executed, one after the other.  Results will appear in the error window.
\par 
\par In the build steps window, the following macros may be used to refer to various built in directories:
\par 
\par \tab $(WINDIR)\tab Windows directory
\par \tab $(SYSDIR)\tab Windows System directory
\par \tab $(OUTPUTDIR)\tab Output path specified in the \cf2\strike General Target Properties window\cf3\strike0\{linkID=130\}
\par \cf0\tab $(PROJECTDIR)\tab Directory the project file is located in
\par \tab $(INSTALLDIR)\tab CC386 installation path
\par 
\par \pard\ri1480 CCIDE will also search the environment in an attempt to do macro substitutions, for example $(COMSPEC) gives the command interpreter.
\par }
139
Scribble139
Post Build Step




Writing



FALSE
25
{\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 Post Build Step\cf0\b0\f1\fs20 
\par 
\par \f0 The target properites property sheet has five dialogs related to setting up the build/debug settings for the target.
\par 
\par The information in the Post Build Step window is used to automate an extra sequence of commands, which executes after a successful build of the given target.  Each command is executed using the equivalent of the C language 'system' command.
\par 
\par The following fields are defined:
\par 
\par \pard\fi-2780\li2780\ri1460\tx680\tx2780\tab label\tab a label displayed in the error window prior to executing the commands:
\par 
\par \tab build steps\tab a list of commands to execute.  Each line in this window will be executed, one after the other.  Results will appear in the error window.
\par 
\par In the build steps window, the following macros may be used to refer to various built in directories:
\par 
\par \tab $(WINDIR)\tab Windows directory
\par \tab $(SYSDIR)\tab Windows System directory
\par \tab $(OUTPUTDIR)\tab Output path specified in the \cf2\strike General Target Properties window\cf3\strike0\{linkID=130\}
\par \cf0\tab $(PROJECTDIR)\tab Directory the project file is located in
\par \tab $(INSTALLDIR)\tab CC386 installation path
\par 
\par \pard\ri1480 CCIDE will also search the environment in an attempt to do macro substitutions, for example $(COMSPEC) gives the command interpreter.
\par \pard\cf1\b\fs32 
\par }
140
Scribble140
Watch Window




Writing



FALSE
23
{\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 Watch Window\cf0\b0\f1\fs20 
\par 
\par \f0 The watch window shows the value of variables, and optionally allows them to be modified.  It is updated automatically each time the program stops at a break point.
\par 
\par There are two ways to get a variable into the watch window.  First, while debugging right-click on a variable and select 'Add To Watch' from the editor right-click menu.  Second, right click in the watch window and select Add To Watch, and a dialog will appear allowing a variable name to be entered.  If the latter method is used, CCIDE will also evaluate any generic \cf2\strike expressions\cf3\strike0\{linkID=240\}\cf0  typed into the dialog and display the results in the watch window.
\par 
\par When evaluating expressions, or adding a variable by using the right-click menu, the IDE will take into account the cursor postion as well as the context of the running tasks.  This means that it will find variables that are in procedures tha