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