Build Configuration options 

Description 

Build Configuration 

Displays the name of the current build configuration associated with the options on this page. There are three default build configurations: Base, Debug, and Release.  

Apply Options... 

Displays the Apply Option Set dialog box to apply the options in a named option set to the current configuration.  

Common items 

Description 

Value from <parent configuration or option set> 

Indicates the value in the parent build configuration or referenced option set. If you change this value here, the change will potentially affect the Base configuration (that is, if you click OK on the Project->Options dialog and subsequently build your project).  

Inherit 

Indicates whether inheritance (from a parent configuration) is on or off for the option. To control inheritance, click the option, and then open the associated generic list dialog box by clicking the that appears. The Inherit values from parent configuration checkbox controls whether your current build configuration inherits the values listed in the lower box of the generic list dialog box.  

<any item in boldface print> 

Indicates that the value of this option has been changed from the value in the parent configuration or referenced option set.  

<any item in Red Print> 

Indicates that there are secondary options available below the option in red print. To view the secondary options, click the + sign in front of the option in red.  

Pop-Up Button 

Appears after you click an option whose value is either of the following:

• An ordered list that you enter and then arrange in the desired order, such as a list of defines or search paths. Clicking invokes the generic ordered list dialog box.
• A single filename, directory or folder name. Clicking invokes the standard Open file or Browse for folder dialog box.

 

Item 

Description 

BPI/Lib output: (-l) 

Tells the linker to place bpi/lib output files in the directory specified, if they are generated. See the description of the pop-up button, above.  

Conditional Defines 

Enter symbols that are referenced in conditional compiler directives. Use semicolons to separate multiple symbols. See the description of the pop-up button, above.  

Final output directory 

Designates the directory where the final output of the build (such as the executable, OCX or DLL) is to be put. See the description of the pop-up button, above.  

Include path: (-I) 

Specifies the directories to be searched for include files. This is a set of include paths that are appended to any tool-specific include paths for the project as a whole. Standard include files are those you specify in angle brackets (<>) in an #include statement (for example, #include <myfile>). See the description of the pop-up button, above.  

Intermediate output: 

Tells the linker to place intermediate output files in the directory specified. Also tells the compilers (dcc, bcc, tasm, brcc) where to put their compiled output; these are normally .obj and ..rcs files. Currently files that qualify for this placement are the linker state files. The .map file and .tds files go to the same directory as the output image, unless otherwise specified for the .map file. See the description of the pop-up button, above.  

Library path: (-L) 

Specifies the directories the linker searches if there is no explicit path given for an .LIB module in the compile/link statement.
The Library Path option uses the following command-line syntax:
/L<PathSpec>[;<PathSpec>][..]
The linker uses the specified library search path(s) if there is no explicit path given for the .LIB file and the linker cannot find the library file in the current directory. For example, the command
ILINK32 /Lc:\mylibs;.\libs splash.\common\logo,,,utils logolib
directs the linker to first search the current directory for SPLASH.LIB. If it is not found in he current directory, the linker then searches for the file in the C:\MYLIBS directory, and then in the .\LIBs directory. However, notice that the linker does not use the library search paths to find the file LOGO.LIB because an explicit path was given for this file.
See the description of the pop-up button, above.  

Show general messages 

Displays all output from the compiler and associated tools. After you select this option, click the down-arrow to select an available option (True, False).  

_TCHAR maps to 

Controls the floating definition of _TCHAR. The choices are wchar_t and char. See the description of the pop-up button, above.
Before you can set this option to wchar_t, your project must have an entry point called "_tmain" or "_tWinMain". New projects (created with RAD Studio) have these entry points by default, but imported projects might need to have these entry points added by hand.
Selecting wchar_t does the following:

• Sets the UNICODE and _UNICODE defines.
• Instructs the linker to use a library of wide versions.
• Instructs standard library and Windows API functions to float to their wide definitions.

If you choose char, _TCHAR does not float to a wide definition. See Floating Functions.  

Default 

Saves the current settings as the default for each new project.