home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / cset21v1.zip / IBMCPP / HELP / DDE4IBR2.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-10-20  |  14KB  |  472 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 on 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, denoted by an asterisk (*) in this help, are trademarks of 
  22. the IBM corporation in the United States and/or other countries: 
  23.  
  24.  IBM 
  25.  OS/2 
  26.  Operating System/2 
  27.  Presentation Manager 
  28.  WorkFrame/2. 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2. Browser Options ΓòÉΓòÉΓòÉ
  32.  
  33. Use the Browser Options notebook to specify the parameters to be passed to the 
  34. IBM* C/C++ Tools Browser when you start it from the Workframe/2* environment. 
  35.  
  36. In this notebook, you can: 
  37.  
  38. o Specify the facts or components you want loaded into the browser database 
  39.  
  40. o Specify the pathnames of browser files to load into the browser database 
  41.  
  42. o Specify the directories of source files that have been moved since their 
  43.   corresponding browser files were generated 
  44.  
  45. o Control the displayed messages on browser file processing. 
  46.  
  47. If you want to create your own Options dynamic link library, you can use the 
  48. DEFL_DLL sample project supplied with WorkFrame/2 as a template. 
  49.  
  50.  
  51. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  52.  
  53. Click on the OK push button to save the browser options settings and close the 
  54. Browser Options notebook. 
  55.  
  56.  
  57. ΓòÉΓòÉΓòÉ <hidden> Reset ΓòÉΓòÉΓòÉ
  58.  
  59. Click on the Reset push button to update the browser options settings to their 
  60. initial values. 
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  64.  
  65. Click on the Cancel push button to close the Browser Options notebook without 
  66. saving any changes. 
  67.  
  68.  
  69. ΓòÉΓòÉΓòÉ <hidden> Help ΓòÉΓòÉΓòÉ
  70.  
  71. Click on the Help push button to get help on the Browser Options notebook. 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
  75.  
  76. Click on the Default push button to update the browser option settings with the 
  77. system default values. 
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ 3. Program Options ΓòÉΓòÉΓòÉ
  81.  
  82. In the Program page of the Browser Options notebook, you can specify the 
  83. program components (called facts) that you want included in the browser 
  84. database when browser .BRS files are loaded. 
  85.  
  86. You can control facts for: 
  87.  
  88. o Variables 
  89.  
  90. o Enumerators 
  91.  
  92. o Typedefs 
  93.  
  94. o Macros 
  95.  
  96. o Header files. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 3.1. Variables ΓòÉΓòÉΓòÉ
  100.  
  101. Use the Variables setting to specify the facts on variables that should be 
  102. included in the browser database when browser .BRS files are loaded. 
  103.  
  104. Select one radio button from the group: 
  105.  
  106. All 
  107.         Includes all the facts on variables in the browser database.  This is 
  108.         the default setting. The equivalent ibrs command-line option is 
  109.         /Fv"all". 
  110.  
  111. None 
  112.         Excludes the facts on variables from the browser database.  The 
  113.         equivalent command-line option is /Fv"none". 
  114.  
  115. Global 
  116.         Includes only the facts on global variables in the browser database. 
  117.         The equivalent command-line option is /Fv"global". 
  118.  
  119. Member & Global 
  120.         Includes only the facts on member and global variables in the browser 
  121.         database.  The equivalent command-line option is /Fv"member+global". 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 3.2. Enumerators ΓòÉΓòÉΓòÉ
  125.  
  126. Use the Enumerators setting to specify the enumerator facts that should be 
  127. included in the browser database when browser .BRS files are loaded. 
  128.  
  129. Select one radio button from the group: 
  130.  
  131. All 
  132.         Includes all the facts on enumerators in the browser database.  This is 
  133.         the default setting.  The equivalent ibrs command-line option is /Fe+. 
  134.  
  135. None 
  136.         Excludes the facts on enumerators from the browser database.  The 
  137.         equivalent command-line option is /Fe-. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 3.3. Typedefs ΓòÉΓòÉΓòÉ
  141.  
  142. Use the Typedefs setting to specify the facts on typedefs that should be 
  143. included in the browser database when browser .BRS files are loaded. 
  144.  
  145. Select one radio button from the group: 
  146.  
  147. All 
  148.         Includes all the facts on typedefs in the browser database.  This is 
  149.         the default setting. The equivalent ibrs command-line option is /Fd+. 
  150.  
  151. None 
  152.         Excludes the facts on typedefs from the browser database. The 
  153.         equivalent command-line option is /Fd-. 
  154.  
  155.  
  156. ΓòÉΓòÉΓòÉ 3.4. Macros ΓòÉΓòÉΓòÉ
  157.  
  158. Use the Macros setting to specify the facts on macros that should be included 
  159. in the browser database when browser .BRS files are loaded. 
  160.  
  161. Select one radio button from the group: 
  162.  
  163. All 
  164.         Includes all the facts on macros in the browser database.  This is the 
  165.         default setting. The equivalent ibrs command-line option is /Fm+. 
  166.  
  167. None 
  168.         Excludes the facts on macros from the browser database.  The equivalent 
  169.         command-line option is /Fm-. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ 3.5. Exclude Header Files ΓòÉΓòÉΓòÉ
  173.  
  174. Use the Exclude header files entry field to specify the names of header files 
  175. whose facts you do not want to load into the browser database. The list of file 
  176. names is kept in the database, but the facts are not. Using this field is 
  177. equivalent to specifying the /Xpath[;path] option on the ibrs command line. 
  178.  
  179. In the Exclude headers field, type the names or file masks of header files 
  180. whose facts you do not want to load into the database. 
  181.  
  182. You can specify file masks using the OS/2* * wildcard. If you specify more than 
  183. one file or file mask, separate each one with a space. 
  184.  
  185. If you leave this entry field blank, the default is to include the facts of all 
  186. header files in the database. 
  187.  
  188.  
  189. ΓòÉΓòÉΓòÉ 4. List Options ΓòÉΓòÉΓòÉ
  190.  
  191. In the List page of the Browser Options notebook, you can specify  options 
  192. involving: 
  193.  
  194. o Browser file messages 
  195.  
  196. o Browser file loading 
  197.  
  198. o Browser file search directories 
  199.  
  200. o Source file search directories. 
  201.  
  202.  
  203. ΓòÉΓòÉΓòÉ 4.1. Verbosity ΓòÉΓòÉΓòÉ
  204.  
  205. Use the Verbosity option to control messages on browser file processing.  There 
  206. are three levels of verbosity you can select: 
  207.  
  208. Suppress all messages 
  209.         Suppresses all messages on browser file processing.  Selecting this 
  210.         item is equivalent to specifying the /V0 option on the ibrs command 
  211.         line.  This is the default setting. 
  212.  
  213. List the name of each file 
  214.         Lists the name of each browser file as it is processed. Selecting this 
  215.         item is equivalent to specifying the /V1 option on the ibrs command 
  216.         line. 
  217.  
  218. List names, database facts, and time 
  219.         Lists the name of each browser file as it is processed, the number of 
  220.         database facts loaded for each file, and the time taken to load the 
  221.         facts into the browser database.  Selecting this item is equivalent to 
  222.         specifying the /V2 option on the ibrs command line. 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 4.2. Browser File Directories ΓòÉΓòÉΓòÉ
  226.  
  227. In the browser file Directories entry field, type the list of directories in 
  228. which to search for the input browser (.BRS) files specified in the File masks 
  229. entry field. 
  230.  
  231. If you specify more than one directory path, separate each one with a 
  232. semicolon. 
  233.  
  234. If you leave this field blank, the default is to search for the input browser 
  235. files in the current directory. Using this field is equivalent to specifying 
  236. the /Bpath[;path] option on the ibrs command line. 
  237.  
  238.  
  239. ΓòÉΓòÉΓòÉ 4.3. Browser File Masks ΓòÉΓòÉΓòÉ
  240.  
  241. In the browser File masks entry field, type the names or file masks of browser 
  242. files you want loaded into the browser database when you start the browser from 
  243. the Workframe/2* environment. 
  244.  
  245. You can specify browser files or file masks using OS/2* wildcards. If you 
  246. specify more than one file or file mask, separate each one with a space. 
  247.  
  248. If you leave this field blank, no browser files are loaded into the browser 
  249. database when you start the browser from WorkFrame/2. 
  250.  
  251. Using this field is equivalent to specifying input browser files on the ibrs 
  252. command line. 
  253.  
  254.  
  255. ΓòÉΓòÉΓòÉ 4.4. Source Directories ΓòÉΓòÉΓòÉ
  256.  
  257. In the source Directories field, type the list of directories in which to 
  258. search for source code files if they have been moved since their corresponding 
  259. browser file was generated.  The directories you specify override the path as 
  260. stored in the browser file. 
  261.  
  262. Using this field is equivalent to specifying the /Spath[;path] option on the 
  263. ibrs command line. 
  264.  
  265. You can specify browser files or file masks using OS/2* wildcards. If you 
  266. specify more than one file or file mask, separate each one with a semicolon. 
  267.  
  268. If you leave this field blank, the default is search for source files in the 
  269. directories they were in when their respective browser files were generated. 
  270.  
  271.  
  272. ΓòÉΓòÉΓòÉ <hidden> Reset Page ΓòÉΓòÉΓòÉ
  273.  
  274. Click on the Reset Page push button to update the browser options settings in 
  275. this page to their initial values. 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
  279.  
  280. Click on the Default push button to update the browser options with their 
  281. default values. 
  282.  
  283.  
  284. ΓòÉΓòÉΓòÉ <hidden> Help ΓòÉΓòÉΓòÉ
  285.  
  286. Click on the Help push button to get help on this page of the Browser Options 
  287. notebook. 
  288.  
  289.  
  290. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  291.  
  292. Explanation: 
  293.  
  294. The application was unable to create a dialog panel for the Browser Options 
  295. notebook due to insufficient system resources. 
  296.  
  297. Recovery: 
  298.  
  299. Close one or more other tasks, and retry the command. 
  300.  
  301.  
  302. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  303.  
  304. Explanation: 
  305.  
  306. You have chosen to reset the browser options to their default settings.  Are 
  307. you sure you want to update the browser options with their default settings? 
  308.  
  309. Recovery: 
  310.  
  311. Select the Yes push button if you want to reset the browser options to the 
  312. default settings.  Select the No push button if you want to retain their 
  313. current settings.  You are then returned to the Browser Options notebook. 
  314.  
  315.  
  316. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  317.  
  318. Explanation: 
  319.  
  320. You have chosen to reset the browser options to their previous settings.  Are 
  321. you sure you want to reset the browser options? 
  322.  
  323. Recovery: 
  324.  
  325. Select Yes if you want to reset the browser option settings. Select No to 
  326. retain their current settings.  You are then returned to the Browser Options 
  327. notebook. 
  328.  
  329.  
  330. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  331.  
  332. Explanation: 
  333.  
  334. The directory path name must be an existing path and must follow the naming 
  335. conventions for directories: 
  336.  
  337. o The name must be 1 to 8 alphanumeric characters 
  338.  
  339. o The first character must be alphabetic 
  340.  
  341. o The name cannot contain embedded blanks, or the characters @, #, and $ 
  342.  
  343. o If you are specifying more than one path name, separate each with a 
  344.   semicolon. 
  345.  
  346. Recovery: 
  347.  
  348. Type a valid directory path name in the field. 
  349.  
  350. See the OS/2* Return Codes Help for more information. 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  354.  
  355. Explanation: 
  356.  
  357. This field requires the names of one or more directory path names.  The path 
  358. name must not contain the name of a file. 
  359.  
  360. Recovery: 
  361.  
  362. Type a valid directory path name in the field. 
  363.  
  364.  
  365. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  366.  
  367. Explanation: 
  368.  
  369. One or more of the specified paths contains a directory name that is longer 
  370. than the maximum length permitted by the operating system. 
  371.  
  372. Recovery: 
  373.  
  374. Enter a shorter directory name and try the command again. 
  375.  
  376. See the OS/2* Return Codes Help for more information. 
  377.  
  378.  
  379. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  380.  
  381. Explanation: 
  382.  
  383. An unexpected error occurred while validating the path. 
  384.  
  385. Recovery: 
  386.  
  387. Enter a valid path name. 
  388.  
  389. See the OS/2* Return Codes Help for more information. 
  390.  
  391.  
  392. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  393.  
  394. Explanation: 
  395.  
  396. One or more of the specified paths does not exist. Do you want to ignore it? 
  397.  
  398. Recovery: 
  399.  
  400. Select Yes to ignore the specified path, save the current settings, and close 
  401. the Browser Options notebook.  Select No to return to the previous page. 
  402.  
  403. See the OS/2* Return Codes Help for more information. 
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  407.  
  408. Explanation: 
  409.  
  410. No files that match the specified file specifier were found. Do you want to 
  411. ignore it? 
  412.  
  413. Recovery: 
  414.  
  415. Select Yes to ignore the file specifier, save the option settings, and close 
  416. the Browser Options notebook.  Select No to return to the previous page without 
  417. closing the Browser Options notebook. 
  418.  
  419.  
  420. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  421.  
  422. Explanation: 
  423.  
  424. You have chosen to discard all the changes made to the Browser Options 
  425. settings.  Are you sure you want to discard the changes? 
  426.  
  427. Recovery: 
  428.  
  429. Select the Yes push button if you want to discard the changes and exit from the 
  430. Browser Options notebook.  Select the No pushbutton if you want to retain the 
  431. changes and return to the previous page without exiting from the Browser 
  432. Options notebook 
  433.  
  434.  
  435. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  436.  
  437. Explanation: 
  438.  
  439. An error occurred while trying to allocate memory.  There may be insufficient 
  440. memory to complete the task. 
  441.  
  442. Recovery: 
  443.  
  444. Close one or more other tasks, and retry the command. 
  445.  
  446.  
  447. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  448.  
  449. Explanation: 
  450.  
  451. The options file for your project has been corrupted. 
  452.  
  453. Recovery: 
  454.  
  455. Use the default options and then reset them to your preferred settings. 
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  459.  
  460. Explanation: 
  461.  
  462. You are using the incorrect version of the options file for your project. 
  463.  
  464. Recovery: 
  465.  
  466. Select Yes to use the default option settings.  Otherwise, select No to cancel 
  467. the current operation. 
  468.  
  469.  
  470. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  471.  
  472. Trademark of the IBM Corporation