home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv4.zip / VACPP / IBMCPP / HELP / CPPIBS30.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-06-02  |  12KB  |  317 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Special Notices ΓòÉΓòÉΓòÉ
  3.  
  4. References in this help to IBM products, programs, or services do not imply 
  5. that IBM intends to make these available in all countries in which IBM 
  6. operates. 
  7.  
  8. Any reference to an IBM licensed program in this help is not intended to state 
  9. or imply that only IBM's licensed program may be used. Any functionally 
  10. equivalent product, program, or service that does not infringe any of IBM's 
  11. intellectual property rights may be used instead of the IBM product, program, 
  12. or service. 
  13.  
  14. Evaluation and verification of operation in conjunction with other products, 
  15. except those expressly designated by IBM, is the user's responsibility. 
  16.  
  17. IBM may have patents or pending patent applications covering subject matter in 
  18. this help. The furnishing of this help does not give you any license to these 
  19. patents. 
  20.  
  21. The following terms are trademarks of the IBM corporation in the United States 
  22. and/or other countries: 
  23.  
  24. BookManager
  25. C/2
  26. C Set/2
  27. C Set ++
  28. Common User Access
  29. CUA
  30. IBM
  31. LibraryReader
  32. Open Class
  33. Operating System/2
  34. OS/2
  35. OS/2 Warp
  36. Personal System/2
  37. PS/2
  38. Presentation Manager
  39. Systems Application Architecture
  40. SAA
  41. VisualAge
  42. WorkFrame
  43. WorkPlace Shell
  44. System Object Model
  45. SOM
  46.  
  47. Windows is a trademark of Microsoft Corporation. 
  48.  
  49. Pentium is a trademark of Intel Corporation. 
  50.  
  51. Other company, product, and service names, which may be denoted by a double 
  52. asterisk (**), may be trademarks of others. 
  53.  
  54. This publication contains examples of data and reports used in daily business 
  55. operations. To illustrate them as completely as possible, the examples include 
  56. the names of individuals, companies, brands, and products. All of these names 
  57. are fictitious and any similarity to the names and addresses used by an actual 
  58. business enterprise is entirely coincidental. 
  59.  
  60. Licensees of this program who wish to have information about it for the purpose 
  61. of enabling: (i) the exchange of information between independent created 
  62. programs and other programs (including this one) and (ii) the mutual use of the 
  63. information which has been exchanged, should contact IBM Canada Ltd., 
  64. Department 071, 1150 Eglinton Ave E., North York, ONT Canada M3C 1H7. Such 
  65. information may be available, subject to appropriate terms and conditions, 
  66. including in some cases, payment of a fee. 
  67.  
  68.  
  69. ΓòÉΓòÉΓòÉ 2. Build Smarts Window ΓòÉΓòÉΓòÉ
  70.  
  71. The Build Smarts window is a fast path for setting options for the VisualAge 
  72. C++ actions Compile and Link, and for two options that affect the way your 
  73. project target is built. The options that you set in the Build Smarts window 
  74. work in combination with the options that are set for the individual actions 
  75. themselves. 
  76.  
  77. You can select the following options: 
  78.  
  79.      Debugger 
  80.      Browser 
  81.      Performance Analyzer 
  82.      Optimizer 
  83.      Generate a make file 
  84.      Build any subprojects first 
  85.  
  86.  You can also define and remove macros you specify for a particular stage of 
  87.  development: 
  88.  
  89.      Development 
  90.      Production 
  91.  
  92.  The top four settings in the Build Smarts window affect both the Compiler and 
  93.  Linker options. For example, selecting the Debugger checkbox effectively adds 
  94.  the /Ti option to the compiler command line, and the /DE option to the linker 
  95.  command line, when you initiate a build involving those actions. 
  96.  
  97.  The settings in this window do not change the options already set for Compile 
  98.  and Link in their options dialogs. The Tools setup settings are simply added 
  99.  to what is already set for the involved actions. When there are conflicts, the 
  100.  Build Smarts settings override those already set for the individual actions. 
  101.  
  102.  Two important build options are also included here: Generate a make file and 
  103.  Build any subprojects first. Select the first option to generate a new make 
  104.  file as part of running the build. Select the second option to build any child 
  105.  projects before building the current project so that all the dependencies are 
  106.  up to date. 
  107.  
  108.  At any time, you can disable the Build Smarts options by deselecting the 
  109.  Enable Build Smarts features checkbox if you only want to use the options set 
  110.  for the individual VisualAge C++ actions. 
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ 2.1. Enable Build Smarts ΓòÉΓòÉΓòÉ
  114.  
  115. Select Enable Build Smarts to use the options settings below it, enabling the 
  116. features that are selected and disabling the features that are not selected. 
  117.  
  118. If Enable Build Smarts is not selected, then none of the options are used, even 
  119. if some are selected. 
  120.  
  121. The following options are controlled by Enable Build Smarts: 
  122.  
  123.      Debugger 
  124.      Browser 
  125.      Performance Analyzer 
  126.      Optimizer 
  127.      Generate a make file 
  128.      Build any subprojects first 
  129.      Development user macro sets 
  130.      Production user macro sets 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 2.2. Debugger ΓòÉΓòÉΓòÉ
  134.  
  135. Select Debugger to enable your application for debugging with the VisualAge C++ 
  136. debugger. 
  137.  
  138. Selecting this option is equivalent to specifying the following compiler and 
  139. linker options: 
  140.  
  141.      /Ti (compiler) 
  142.      /O- (compiler) 
  143.      /Os- (compiler) 
  144.      /DE (linker) 
  145.  
  146.  These options are specified in addition to any options specified in the 
  147.  Compiler and Linker Options notebooks. In case of conflict, the options 
  148.  specified by Build Smarts take precedence. 
  149.  
  150.  Do not select both Debugger and Optimizer. The debugger is very limited in its 
  151.  ability to debug optimized code. See Generating Debugger Information for more 
  152.  information. 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 2.3. Browser ΓòÉΓòÉΓòÉ
  156.  
  157. Select Browser to enable your application for browsing with the VisualAge C++ 
  158. browser. 
  159.  
  160. Selecting this option is equivalent to specifying the following compiler and 
  161. linker options: 
  162.  
  163.      /Fb (compiler) 
  164.      /BR (linker) 
  165.  
  166.  These options are specified in addition to any options specified in the 
  167.  Compiler and Linker Options notebooks. In case of conflict, the options 
  168.  specified by Build Smarts take precedence. 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ 2.4. Performance Analyzer ΓòÉΓòÉΓòÉ
  172.  
  173. Select Performance Analyzer to enable your application for performance analysis 
  174. with the VisualAge C++ Performance Analyzer. 
  175.  
  176. Selecting this option is equivalent to specifying the following compiler and 
  177. linker options: 
  178.  
  179.      /Ti (compiler) 
  180.      /Gh (compiler) 
  181.      /DE (linker) 
  182.      /NOE (linker) 
  183.  
  184.  When you select this option, the object file CPPOPA3.OBJ, which is required by 
  185.  the Performance Analyzer, is linked in automatically. 
  186.  
  187.  These options are specified in addition to any options specified in the 
  188.  Compiler and Linker Options notebooks. In case of conflict, the options 
  189.  specified by Build Smarts take precedence. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ 2.5. Optimizer ΓòÉΓòÉΓòÉ
  193.  
  194. Select Optimizer to have the compiler optimize your code to improve the speed 
  195. of your application. See Optimizing Object Code for more information. 
  196.  
  197. Selecting this option is equivalent to specifying the following compiler 
  198. option: 
  199.  
  200.      /O+ 
  201.  
  202.  This option is specified in addition to any options specified in the Compiler 
  203.  and Linker Options notebooks. In case of conflict, options specified by Build 
  204.  Smarts take precedence. 
  205.  
  206.  Do not select both Optimizer and Debugger. The debugger is very limited in its 
  207.  ability to debug optimized code. See Generating Debugger Information for more 
  208.  information. 
  209.  
  210.  
  211. ΓòÉΓòÉΓòÉ 2.6. Generate a make file ΓòÉΓòÉΓòÉ
  212.  
  213. Select Generate a make file if you want WorkFrame to produce a new make file 
  214. each time the Build action is executed. Deselect this button if you have your 
  215. own make file that you want the Build action to use. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 2.7. Build any subprojects first ΓòÉΓòÉΓòÉ
  219.  
  220. Select Build any subprojects first to build any child projects before building 
  221. the current project so that all the dependencies are up to date. 
  222.  
  223. Deselect this option to perform a partial build. The current project will be 
  224. built, but any projects nested inside it will not. For example, you might want 
  225. to build an executable without rebuilding a DLL upon which it depends. 
  226.  
  227.  
  228. ΓòÉΓòÉΓòÉ 2.8. Development ΓòÉΓòÉΓòÉ
  229.  
  230. Select Development when you are developing your application (debugging it 
  231. rather than optimizing it) to define or remove any macros specified in the 
  232. Development entry fields Define and Remove. 
  233.  
  234. This is equivalent to specifying those macros with the command-line compiler 
  235. options /D and /U. 
  236.  
  237. The macros you specify in the Define and Remove fields next to the Development 
  238. checkbox are only defined or removed when Development is selected. 
  239.  
  240. The macro definitions and removals you specify are performed in addition to any 
  241. you specified in the Compiler notebook. In case of conflict, macro 
  242. specifications in Build Smarts take precedence. 
  243.  
  244.  
  245. ΓòÉΓòÉΓòÉ 2.9. Production ΓòÉΓòÉΓòÉ
  246.  
  247. Select Production when you are working on the production of your application 
  248. (optimizing it rather than debugging it) to define or remove any macros 
  249. specified in the Production entry fields Define and Remove. 
  250.  
  251. This is equivalent to specifying those macros with the command-line compiler 
  252. options /D and /U. 
  253.  
  254. The macros you specify in the Define and Remove fields next to the Production 
  255. checkbox are only defined or removed when Production is selected. 
  256.  
  257. The macro definitions and removals you specify are performed in addition to any 
  258. you specified in the Compiler notebook. In case of conflict, macro 
  259. specifications in Build Smarts take precedence. 
  260.  
  261.  
  262. ΓòÉΓòÉΓòÉ 2.10. Define Development macros ΓòÉΓòÉΓòÉ
  263.  
  264. Specify macros in this field that you want defined when you are in your 
  265. development phase (debugging rather than optimizing). The macros are defined 
  266. when you check the Development checkbox. 
  267.  
  268. This is equivalent to defining the macros with the /D command-line compiler 
  269. option. 
  270.  
  271.  
  272. ΓòÉΓòÉΓòÉ 2.11. Remove Development macros ΓòÉΓòÉΓòÉ
  273.  
  274. Specify macros in this field that you want undefined when you are in your 
  275. development phase (debugging rather than optimizing). The macros are undefined 
  276. when you check the Development checkbox. 
  277.  
  278. This is equivalent to undefining the macros with the /U command-line compiler 
  279. option. 
  280.  
  281.  
  282. ΓòÉΓòÉΓòÉ 2.12. Define Production macros ΓòÉΓòÉΓòÉ
  283.  
  284. Specify macros in this field that you want defined when you are in your 
  285. production phase (optimizing rather than debugging). The macros are defined 
  286. when you check the Production checkbox. 
  287.  
  288. This is equivalent to defining the macros with the /D command-line compiler 
  289. option. 
  290.  
  291.  
  292. ΓòÉΓòÉΓòÉ 2.13. Remove Production macros ΓòÉΓòÉΓòÉ
  293.  
  294. Specify macros in this field that you want undefined when you are in your 
  295. production phase (optimizing rather than debugging). The macros are undefined 
  296. when you check the Production checkbox. 
  297.  
  298. This is equivalent to undefining the macros with the /U command-line compiler 
  299. option. 
  300.  
  301.  
  302. ΓòÉΓòÉΓòÉ 2.14. OK ΓòÉΓòÉΓòÉ
  303.  
  304. Select OK to close the Build Smarts window and save your changes. The options 
  305. you selected will be in effect the next time you build your project. 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 2.15. Cancel ΓòÉΓòÉΓòÉ
  309.  
  310. Select Cancel to cancel your changes and close the Build Smarts window without 
  311. saving your selections. 
  312.  
  313.  
  314. ΓòÉΓòÉΓòÉ 2.16. Help ΓòÉΓòÉΓòÉ
  315.  
  316. Select Help to display contextual help for the item currently in focus in the 
  317. window.