home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv4.zip / VACPP / IBMCPP / HELP / IWFCSH.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-06-02  |  180KB  |  4,928 lines
  1.  
  2. ΓòÉΓòÉΓòÉ <hidden> Project window ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5. ΓòÉΓòÉΓòÉ 1. Project window ΓòÉΓòÉΓòÉ
  6.  
  7. The Project window is where you manipulate source files and other project 
  8. parts, and launch tools that work on particular files or an entire project. 
  9.  
  10. Typically, you interact with the project window by: 
  11.  
  12. o Entering a wildcard pattern or type name in the parts filter entry field, to 
  13.   filter the project parts that are displayed at any one time. 
  14. o Selecting one or more files, then selecting an item from the popup menu of 
  15.   one of the files. 
  16. o Selecting an item from the popup menu of the window background. 
  17. o Selecting an item from one of the pulldown menus of the window. (Some of the 
  18.   entries under the Project and Selected pulldown menus are the same as entries 
  19.   on the popup menus.) 
  20. o Double-clicking on a project part that is listed in the window. 
  21. o Clicking on icons in the toolbar of the window. These icons represent 
  22.   frequently accessed features that are also available through menus or other 
  23.   controls. 
  24.  
  25. Menu-Bar Choices 
  26.  
  27. o Project 
  28. o Selected 
  29. o Monitor 
  30. o View 
  31. o Options 
  32. o Help 
  33.  
  34. Controls 
  35.  
  36. o Near the top of the window is the project toolbar. A choice under the View 
  37.   menu lets you hide the toolbar. 
  38. o The Project parts container is where you manipulate the files and other parts 
  39.   that make up the project. 
  40.  
  41.   Within this container, you can: 
  42.  
  43.    - Double-click on a project part to run its default action. 
  44.    - Select a project part and then select from its popup menu (which is 
  45.      displayed by pressing mouse button 2). 
  46.    - Press mouse button 2 in the blank area away from the project parts, and 
  47.      select from the popup menu for the container itself. 
  48.    - Drag and drop between the project window and Workplace Shell objects. Only 
  49.      certain drag and drop operations are allowed. For example, you can drop a 
  50.      project part on the shredder or drop a file object or project object onto 
  51.      the project window. 
  52.  
  53.   Selections under the View pulldown menu let you open different views of this 
  54.   container: 
  55.  
  56.    - Icon view 
  57.    - Details view 
  58.    - Tree view 
  59.  
  60. o The Monitor is where the results of some actions are displayed. A choice 
  61.   under the Monitor menu lets you hide the Monitor container. 
  62. o Near the bottom of the window is the Monitor toolbar. A choice under the View 
  63.   menu lets you hide the toolbar. 
  64. o An information line provides an explanation of some parts of the window as 
  65.   the mouse moves over them. A choice under the View menu lets you hide the 
  66.   information line. 
  67.  
  68.  
  69. ΓòÉΓòÉΓòÉ 1.1. Project parts container ΓòÉΓòÉΓòÉ
  70.  
  71. This region of the project window displays a collection of the files and other 
  72. projects that are parts of the current project. 
  73.  
  74. Related information 
  75.  
  76. o This container is part of the project window. 
  77. o You filter the contents of this container with the parts filter field on the 
  78.   project toolbar. Press the Enter key within this field when changing the 
  79.   filter. 
  80. o You view different representations of the contents of this container with the 
  81.   Icon, Details, and Tree choices under the View pulldown menu. 
  82. o After selecting one or more project parts in this container, you operate on 
  83.   those parts by selecting from the Selected pulldown menu or from the popup 
  84.   menu of one of the parts. 
  85. o After creating or deleting files, you display the updated contents of the 
  86.   container by selecting the Refresh now choice under the View pulldown menu. 
  87. o You select directories whose contents are displayed in this container using 
  88.   the Location page of the project settings notebook. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 1.2. Monitor window ΓòÉΓòÉΓòÉ
  92.  
  93. This region of the project window displays the output from any monitored 
  94. actions that you run. 
  95.  
  96. When an error message, such as a syntax error from a compiler, indicates the 
  97. source file and a location within the file, you can double-click on the message 
  98. in the monitor to edit the applicable source file. 
  99.  
  100. Related information 
  101.  
  102. o The monitor is part of the project window. 
  103. o You determine if an action is monitored or not on the General page of the 
  104.   action's settings notebook. 
  105. o You control the monitor through the Monitor pulldown menu, the Monitor 
  106.   toolbar in the project window, and the Monitor page in the project settings 
  107.   notebook. 
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ 1.3. Project menu ΓòÉΓòÉΓòÉ
  111.  
  112. Use the entries under this menu to perform operations that affect the whole 
  113. project, not just a particular subset of project parts. 
  114.  
  115. This menu consists of a list of all the actions that are project-scoped, based 
  116. on their Action applies to setting. These are actions that the product defines, 
  117. such as Build, or actions that you define yourself. 
  118.  
  119. The entries under the Project menu are also available from the background popup 
  120. menu within the Project window, and the System menu. 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 1.4. Selected menu ΓòÉΓòÉΓòÉ
  124.  
  125. Use the entries under this menu to perform an action on the project parts that 
  126. are selected in the project window. 
  127.  
  128. If no project parts are selected, or if no actions apply to all of the selected 
  129. parts, this menu has no items. The items vary depending on the actions that 
  130. apply to the selected project parts. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 1.5. Monitor menu ΓòÉΓòÉΓòÉ
  134.  
  135. Use the entries under this menu to control the operation of the monitor, which 
  136. is a portion of the project window where output from actions is sometimes 
  137. displayed. 
  138.  
  139. You can also control the monitor with the toolbar in the project window. 
  140. Project settings related to the monitor are on the Monitor page in the project 
  141. settings notebook. 
  142.  
  143. Menu Summary 
  144.  
  145. o Stop 
  146. o Repeat 
  147. o History 
  148. o Edit errors 
  149. o Save 
  150. o Erase 
  151. o Show 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 1.5.1. Stop ΓòÉΓòÉΓòÉ
  155.  
  156. Cancels the currently running monitored action. 
  157.  
  158. It is equivalent to pressing Ctrl+C in a fullscreen or windowed session. Some 
  159. processes take a while to respond to this stop request and others do not accept 
  160. stop requests. 
  161.  
  162. Related information 
  163.  
  164. o This selection acts on the monitor. 
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ 1.5.2. Repeat ΓòÉΓòÉΓòÉ
  168.  
  169. Executes the most recently executed monitored action again. 
  170.  
  171. It cannot be used to repeat actions that run in a fullscreen or windowed 
  172. session. 
  173.  
  174. Related information 
  175.  
  176. o This selection acts on the monitor. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 1.5.3. History ΓòÉΓòÉΓòÉ
  180.  
  181. Displays a dialog that lists previously executed monitored actions. For any of 
  182. these actions, you can view the output again or run it again. 
  183.  
  184. Related information 
  185.  
  186. o This selection acts on the monitor. 
  187.  
  188.  
  189. ΓòÉΓòÉΓòÉ 1.5.4. Edit errors ΓòÉΓòÉΓòÉ
  190.  
  191. When an error message is selected in the monitor, this selection edits the 
  192. applicable source file at the location of the error. It is the same as 
  193. double-clicking on the line with the error message. If no error message is 
  194. selected, this selection edits the source file for the first error message 
  195. produced by the action. 
  196.  
  197. Related information 
  198.  
  199. o This selection acts on the monitor. 
  200. o The highlighted message must follow the format of the error template for the 
  201.   action. The file name and error location must be indicated by substitution 
  202.   variables. 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 1.5.5. Save ΓòÉΓòÉΓòÉ
  206.  
  207. Saves the contents of the monitor window to a file, in case you want to review 
  208. an error log or other output from a monitored action. 
  209.  
  210. Related information 
  211.  
  212. o This selection acts on the monitor. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 1.5.6. Erase ΓòÉΓòÉΓòÉ
  216.  
  217. Erases the contents of the monitor window. You can view the results of 
  218. previously executed actions by selecting History. 
  219.  
  220. Related information 
  221.  
  222. o This selection acts on the monitor. 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 1.5.7. Show ΓòÉΓòÉΓòÉ
  226.  
  227. Toggles whether the monitor is shown or hidden at the bottom of the project 
  228. window. 
  229.  
  230. Related information 
  231.  
  232. o This selection acts on the monitor. 
  233. o On the Monitor page of the project settings notebook, you can choose to have 
  234.   the monitor displayed or hidden automatically when actions are started or 
  235.   completed, so that more space is available for the list of project parts when 
  236.   you do not need to look at the monitor. 
  237.  
  238.  
  239. ΓòÉΓòÉΓòÉ 1.6. View Menu ΓòÉΓòÉΓòÉ
  240.  
  241. Use the entries under this menu to customize the way information is presented 
  242. in the project window. 
  243.  
  244. Menu Summary 
  245.  
  246. o Icon 
  247. o Details 
  248. o Tree 
  249. o Settings 
  250. o Tools setup 
  251. o Information line 
  252. o Toolbars 
  253. o Refresh now 
  254.  
  255.  
  256. ΓòÉΓòÉΓòÉ 1.6.1. Settings ΓòÉΓòÉΓòÉ
  257.  
  258. Use the entries under this cascading menu to take fast paths to commonly 
  259. referenced pages in the Project Settings notebook, where you can change various 
  260. properties of the project. 
  261.  
  262. Menu Summary 
  263.  
  264. o Target 
  265. o Location 
  266. o Monitor 
  267. o Inheritance 
  268. o View 
  269. o Sort 
  270.  
  271.  
  272. ΓòÉΓòÉΓòÉ 1.6.2. Refresh now ΓòÉΓòÉΓòÉ
  273.  
  274. Displays all the information in the window again. Use this selection if project 
  275. parts are created or deleted while a project view is open. 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 1.7. Options menu ΓòÉΓòÉΓòÉ
  279.  
  280. Use the entries under this menu to change the options (the runtime parameters 
  281. used by the tool) for some actions. 
  282.  
  283. In the settings notebook for each action (available in the Tools setup window), 
  284. you can choose whether or not the action is listed under the Options menu, 
  285. depending on how frequently you need to change its options. 
  286.  
  287.  
  288. ΓòÉΓòÉΓòÉ 1.8. Project toolbar ΓòÉΓòÉΓòÉ
  289.  
  290. Use the toolbar at the top of the Project window to quickly perform a common 
  291. WorkFrame operation; most of these operations can also be selected from menus. 
  292. The toolbar comes already configured with a set of commonly performed 
  293. operations: 
  294.  
  295. Build smarts 
  296.      Displays the Build smarts window where you can set build features for your 
  297.      projects. 
  298.  
  299.      This feature is optional and might not be present in all products that 
  300.      incorporate the WorkFrame component. 
  301.  
  302. Tools setup 
  303.      Displays the Tools setup window that contains the actions, environment 
  304.      variables, and types associated with the project. 
  305.  
  306. How Do I? 
  307.      Displays the online How Do I? help for WorkFrame.  It contains 
  308.      instructions for how to accomplish common WorkFrame tasks. 
  309.  
  310. In the middle of the toolbar is the parts filter, where you select which 
  311. project parts are displayed in all the open views of the project. 
  312.  
  313. The right-hand side of the project toolbar also contains buttons for launching 
  314. frequently-used, project-scoped actions like Build, Debug, and Run. 
  315.  
  316. To remove an action from the toolbar, or add a particular action, change the 
  317. Use in project Toolbar setting in the Menus tab of the action's settings in the 
  318. Tools setup window. 
  319.  
  320. Related information 
  321.  
  322. o Toolbars choice of View pulldown menu 
  323. o Monitor toolbar 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 1.9. Parts filter ΓòÉΓòÉΓòÉ
  327.  
  328. Enter the file mask or type name that determines which project parts to list in 
  329. the project window. You can only enter one file mask or type name. You can also 
  330. select one of the available types from the dropdown list box. 
  331.  
  332. You must press the Enter key to refresh the contents of the view using the new 
  333. filter. 
  334.  
  335. Related information 
  336.  
  337. o If you need to use more than one file mask and the dropdown choices are not 
  338.   suitable, you can set up a new file type using the Types view in the Tools 
  339.   setup window. 
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 1.10. Monitor toolbar ΓòÉΓòÉΓòÉ
  343.  
  344. Use the toolbar at the bottom of the Project window to quickly perform an 
  345. operation on the monitor window (a part of the project window that is sometimes 
  346. displayed and sometimes hidden). These operations can also be selected from the 
  347. Monitor pulldown menu. 
  348.  
  349. The buttons on this toolbar operate on the entire monitor window and its 
  350. contents (Show, Erase, Save to file), or on individual actions whose output has 
  351. been displayed in the monitor window (Stop, Repeat, History, Errors). 
  352.  
  353. You cannot change the contents of this toolbar. 
  354.  
  355. Toolbar choices 
  356.  
  357. Stop 
  358. Repeat 
  359. History 
  360. Errors 
  361. Save 
  362. Erase 
  363. Show 
  364.  
  365. Related information 
  366.  
  367. o Toolbars choice of View pulldown menu 
  368. o Project toolbar 
  369.  
  370.  
  371. ΓòÉΓòÉΓòÉ 1.10.1. Stop ΓòÉΓòÉΓòÉ
  372.  
  373. Cancels the currently running monitored action. 
  374.  
  375. It is equivalent to pressing Ctrl+C in a fullscreen or windowed session. Some 
  376. processes take a while to respond to this stop request and others do not accept 
  377. stop requests. 
  378.  
  379.  
  380. ΓòÉΓòÉΓòÉ 1.10.2. Repeat ΓòÉΓòÉΓòÉ
  381.  
  382. Repeats the most recently performed monitored action. 
  383.  
  384.  
  385. ΓòÉΓòÉΓòÉ 1.10.3. History ΓòÉΓòÉΓòÉ
  386.  
  387. Displays a dialog that lists previously executed actions. You can execute an 
  388. action again or view its results again. 
  389.  
  390.  
  391. ΓòÉΓòÉΓòÉ 1.10.4. Errors ΓòÉΓòÉΓòÉ
  392.  
  393. When an error message is highlighted in the monitor, this selection edits the 
  394. applicable source file at the location of the error. It is the same as 
  395. double-clicking on the line with the error message. If no error message is 
  396. selected, this selection edits the source file for the first error message 
  397. produced by the action. 
  398.  
  399. Related information 
  400.  
  401. o This selection acts on the monitor. 
  402. o The highlighted message must follow the format of the error template for the 
  403.   action. The file name and error location must be indicated by substitution 
  404.   variables. 
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ 1.10.5. Save ΓòÉΓòÉΓòÉ
  408.  
  409. Save 
  410.  
  411. Saves the current contents of the monitor window to a file. 
  412.  
  413.  
  414. ΓòÉΓòÉΓòÉ 1.10.6. Erase ΓòÉΓòÉΓòÉ
  415.  
  416. Erases the contents of the monitor window. You can view the results of 
  417. previously executed actions by selecting History. 
  418.  
  419.  
  420. ΓòÉΓòÉΓòÉ 1.10.7. Show ΓòÉΓòÉΓòÉ
  421.  
  422. Shows or hides the monitor window. 
  423.  
  424.  
  425. ΓòÉΓòÉΓòÉ 1.11. Open ΓòÉΓòÉΓòÉ
  426.  
  427. You can open various views of the project: 
  428.  
  429. o Icon view 
  430. o Details view 
  431. o Tree view 
  432. o Tools setup view 
  433.  
  434.  
  435. ΓòÉΓòÉΓòÉ 1.12. Icon view ΓòÉΓòÉΓòÉ
  436.  
  437. The Icon view lists the project parts as icons. 
  438.  
  439. Related information 
  440.  
  441. o This view is part of the project window. 
  442. o Details view 
  443. o Tree view 
  444.  
  445.  
  446. ΓòÉΓòÉΓòÉ 1.13. Details view ΓòÉΓòÉΓòÉ
  447.  
  448. The Details view lists the project parts and multicolumn information, such as 
  449. location and file size, about each. 
  450.  
  451. Related information 
  452.  
  453. o This view is part of the project window. 
  454. o Icon view 
  455. o Tree view 
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ 1.14. Tree view ΓòÉΓòÉΓòÉ
  459.  
  460. The Tree view lists the project parts as a tree structure, with files grouped 
  461. according to project access method and then according to the directories where 
  462. they are located. 
  463.  
  464. Related information 
  465.  
  466. o This view is part of the project window. 
  467. o Icon view 
  468. o Details view 
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ <hidden> Help menu ΓòÉΓòÉΓòÉ
  472.  
  473. The choices under this menu give you help about aspects of WorkFrame or of the 
  474. entire product. 
  475.  
  476. Menu choices 
  477.  
  478. o Help index displays the index of the WorkFrame online help. 
  479. o General help displays the overall help panel for the current window. 
  480. o Using help displays instructions for the help facility. 
  481. o How Do I? displays online help for WorkFrame tasks. 
  482. o Depending on the product, there may be a set of product-specific cascading 
  483.   menu items. 
  484. o Product information displays a window that identifies the product. 
  485.  
  486.  
  487. ΓòÉΓòÉΓòÉ <hidden> Default action help ΓòÉΓòÉΓòÉ
  488.  
  489. This menu item represents an action that can be executed on the project (from 
  490. the Project menu) or on the selected parts (from the Selected menu). 
  491.  
  492. An action is a description of a tool that can be used to manipulate a project's 
  493. parts or build its target. 
  494.  
  495. Related information 
  496.  
  497. o You can work with actions in the Tools setup window. 
  498.  
  499.  
  500. ΓòÉΓòÉΓòÉ <hidden> Help Menu Items for Online Documentation ΓòÉΓòÉΓòÉ
  501.  
  502. The central portion of the Help pulldown menu is dedicated to all the online 
  503. documentation for the product. Depending on which product you are using, the 
  504. menu might or might not have these selections. 
  505.  
  506. Making a selection from any of these cascading menus launches the documentation 
  507. associated with the menu item. You can find the same documentation in the 
  508. Information folder found in the product's Desktop folder. 
  509.  
  510. The cascading menus are organized as follows: 
  511.  
  512. At A Glance  
  513.           Provides general information on using Visual Age C++, such as what is 
  514.           new in this release, the overall tutorial, a description of all the 
  515.           sample programs, and answers to frequently asked questions. 
  516.  
  517. Using Visual Age C++  
  518.           Provides direct access to the individual sections of the User's 
  519.           Guide. For example, if you are using the Browser, you would look in 
  520.           the Browsing section for more information. 
  521.  
  522. How Do I... Selections  
  523.           Provides access to the How Do I... information for each component of 
  524.           Visual Age C++. Use How Do I... information to find out how to 
  525.           perform common tasks within Visual Age C++. 
  526.  
  527. C/C++  
  528.           Provides access to the information that is specific to programming in 
  529.           C and C++. 
  530.  
  531. Class Libraries  
  532.           Provides access to the Visual Age C++ Open Class Library 
  533.           documentation. 
  534.  
  535. Visual Programming  
  536.           Provides access to the information that is specific to creating your 
  537.           programs visually. 
  538.  
  539. OS/2, PM, and Graphics  
  540.           Provides access to the documentation for the key aspects of OS/2, 
  541.           Presentation Manager, and graphics programming. 
  542.  
  543. IPF, REXX, and Editing  
  544.           Provides access to the IPF, REXX and Editor references. 
  545.  
  546. SOM and Workplace Shell  
  547.           Provides access to the information specific to SOM and the WorkPlace 
  548.           Shell. 
  549.  
  550. Multimedia  
  551.           Provides access to the information that is specific to creating 
  552.           multimedia applications. 
  553.  
  554.  
  555. ΓòÉΓòÉΓòÉ 2. Project settings notebook ΓòÉΓòÉΓòÉ
  556.  
  557. Use the Project Settings notebook to change various properties of the project. 
  558.  
  559. Pages 
  560.  
  561. o Target defines the names of the target file and make file. 
  562. o Location defines the source and working directories. 
  563. o Monitor controls the appearance of the display area that shows the results of 
  564.   running actions. 
  565. o Inheritance defines one or more projects from which to inherit certain 
  566.   properties. 
  567. o View (Page 1 of 3) controls the appearance of the icon view of the project 
  568.   window. 
  569. o View (Page 2 of 3) controls the appearance of the tree view of the project 
  570.   window. 
  571. o View (Page 3 of 3) controls the appearance of the details view of the project 
  572.   window. 
  573. o Sort controls the order in which project parts are displayed. 
  574. o And OS/2-standard Menu, File, Window, and General pages. 
  575.  
  576. Related information 
  577.  
  578. o These settings affect the appearance of the project window. 
  579.  
  580.  
  581. ΓòÉΓòÉΓòÉ 2.1. Target page ΓòÉΓòÉΓòÉ
  582.  
  583. Use this page to define the file that is ultimately produced by building the 
  584. project, and the name of the make file that generates the target file. 
  585.  
  586. If the target is an executable file, you can also enter options to be passed to 
  587. it at run time as if they were typed on the command line. 
  588.  
  589. Controls 
  590.  
  591. Name 
  592.      Enter the name, including the extension, of the target file that will be 
  593.      produced by building the project. 
  594.  
  595. Run options 
  596.      These controls only apply when the target file is an executable program. 
  597.      Enter any runtime parameters that you want to pass to the target program 
  598.      as if they were entered on the command line. 
  599.  
  600. Makefile 
  601.      Enter the name of the make file to use when building the project. When you 
  602.      use MakeMake to generate a make file for the project, it will save the 
  603.      make file with this name. 
  604.  
  605. Undo 
  606.      Restores the page to the same settings as when you opened the dialog. 
  607.  
  608. Default 
  609.      Restores the page to its default values. 
  610.  
  611. Help 
  612.      Displays this help panel. 
  613.  
  614. Related information 
  615.  
  616. o This page is part of the project settings notebook. 
  617.  
  618.  
  619. ΓòÉΓòÉΓòÉ 2.2. Location page ΓòÉΓòÉΓòÉ
  620.  
  621. Use this page to specify which directories contain the files that are part of 
  622. this project. 
  623.  
  624. Controls 
  625.  
  626. Directories for project files 
  627.      Enter the names of one or more directories that contain the files that are 
  628.      part of the project. If a directory does not exist, a WorkFrame prompt 
  629.      will let you decide whether or not to create it. 
  630.  
  631. Find 
  632.      Displays a Find dialog to select directories nteractively. 
  633.  
  634. Working directory 
  635.      After selecting the directories for project files, select one of them as 
  636.      the Working directory. This is the directory where any output files are 
  637.      created. When actions are executed, this directory is their current 
  638.      directory. 
  639.  
  640. Undo 
  641.      Restores the page to the same settings as when you opened the dialog. 
  642.  
  643. Default 
  644.      Restores the page to its default values. 
  645.  
  646. Help 
  647.      Displays this help panel. 
  648.  
  649. Related information 
  650.  
  651. o This page is part of the project settings notebook. 
  652.  
  653.  
  654. ΓòÉΓòÉΓòÉ 2.3. Monitor page ΓòÉΓòÉΓòÉ
  655.  
  656. Use this page to customize the display of the monitor window. 
  657.  
  658. Controls 
  659.  
  660. Show on action start 
  661.      Makes the monitor window visible, if it is not already visible, when a 
  662.      monitored action is executed. 
  663.  
  664. Auto erase 
  665.      Clears the monitor window each time a monitored action is executed. 
  666.  
  667. Auto scroll 
  668.      Scrolls the monitor window as new output is produced, so that you always 
  669.      see the latest output. 
  670.  
  671. Beep on completion 
  672.      Signals you when a monitored action is completed, in case you are doing 
  673.      something else at the time. A high-pitched tone indicates the action was 
  674.      successful (with a return code of zero). A low-pitched tone indicates the 
  675.      action was unsuccessful (with a nonzero return code). 
  676.  
  677. Hide on successful completion 
  678.      Hides the monitor window when a monitored action is completed 
  679.      successfully, on the assumption that there are no error messages to check. 
  680.  
  681. Refresh view(s) on completion 
  682.      Displays the up-to-date list of project parts in all open project views 
  683.      after a monitored action is completed, in case the action created or 
  684.      deleted any files. If frequent refreshing slows down your work, you can 
  685.      deselect this check box and refresh the views directly from the project 
  686.      window selecting Refresh now under the View pulldown menu. 
  687.  
  688. Undo 
  689.      Restores the page to the same settings as when you opened the dialog. 
  690.  
  691. Default 
  692.      Restores the page to its default values. 
  693.  
  694. Help 
  695.      Displays this help panel. 
  696.  
  697. Related information 
  698.  
  699. o This page is part of the project settings notebook. 
  700.  
  701.  
  702. ΓòÉΓòÉΓòÉ 2.4. Inheritance page ΓòÉΓòÉΓòÉ
  703.  
  704. Use this page to select one or more projects whose Tools setup is to be 
  705. inherited by the current project. You do the selection through a Find dialog. 
  706.  
  707. Typically, you might use inheritance to: 
  708.  
  709. o Inherit a complete set of actions, types, and environment variable settings 
  710.   from a pre-configured project that comes as part of the product. 
  711. o Add or override a small set of actions, types, or environment variable 
  712.   settings, if you want to apply these changes to multiple projects. Creating a 
  713.   minimal project and inheriting from it may be more convenient than changing 
  714.   the settings in each new project. 
  715.  
  716. Settings from projects that are lower in the list take precedence over settings 
  717. from higher projects, if there is a conflict such as a duplicate action name. 
  718.  
  719. Controls 
  720.  
  721. When the Inherit from list box is not empty, you can select a project and use 
  722. the buttons to remove it from the list, or move it up or down. 
  723.  
  724. Inherit from 
  725.      Displays the list of projects, in reverse priority sequence, from which 
  726.      this project inherits actions, environment-variable settings, and types. 
  727.  
  728. Promote 
  729.      Moves the selected project up one position in the list, which lowers its 
  730.      precedence. It is only selectable when there is more than one project in 
  731.      the inheritance list. 
  732.  
  733. Demote 
  734.      Moves the selected project down one position in the list, which raises its 
  735.      precedence. It is only selectable when there is more than one project in 
  736.      the inheritance list. 
  737.  
  738. Add 
  739.      Displays a Find dialog where you can select another project from which to 
  740.      inherit Tools setup objects. 
  741.  
  742. Remove 
  743.      Removes the selected project from the inheritance list. 
  744.  
  745. Undo 
  746.      Restores the page to the same settings as when you opened the dialog. 
  747.  
  748. Default 
  749.      Restores the page to its default values. 
  750.  
  751. Help 
  752.      Displays this help panel. 
  753.  
  754. Related information 
  755.  
  756. o This page is part of the project settings notebook. 
  757. o You work with the actions, environment variables, and types in the Tools 
  758.   setup window. 
  759.  
  760.  
  761. ΓòÉΓòÉΓòÉ 2.5. View page (1 of 3) ΓòÉΓòÉΓòÉ
  762.  
  763. Use this page to customize the display of the icon view for the main project 
  764. window. 
  765.  
  766. Controls (Page 1 - Icon view) 
  767.  
  768. Format 
  769.      Selects different arrangements for the project parts in the icon view: 
  770.  
  771.    o Select Flowed if you want the icons arranged in columns across the screen. 
  772.    o Select Non-flowed if you want the icons arranged in a column from the top 
  773.      to the bottom of the screen. 
  774.    o Select Non-grid if you want the icons displayed without columns. 
  775.  
  776. Icon display 
  777.      Selects the visibility of icons for project parts in the icon view. 
  778.  
  779. Font 
  780.      Selects the font for icon labels in the icon view. You can use the Change 
  781.      font pushbutton to interactively select a different font. 
  782.  
  783. Undo 
  784.      Restores the page to the same settings as when you opened the dialog. 
  785.  
  786. Default 
  787.      Restores the page to its default values. 
  788.  
  789. Help 
  790.      Displays this help panel. 
  791.  
  792. Related information 
  793.  
  794. o This page is part of the project settings notebook. 
  795. o View page (2 of 3) 
  796. o View page (3 of 3) 
  797.  
  798.  
  799. ΓòÉΓòÉΓòÉ 2.6. View page (2 of 3) ΓòÉΓòÉΓòÉ
  800.  
  801. Use this pages to customize the display of the tree view for the main project 
  802. window. 
  803.  
  804. Controls (Page 2 - Tree view) 
  805.  
  806. Format 
  807.      Selects whether or not to connect the parts in the tree view with lines. 
  808.  
  809. Icon display 
  810.      Selects the visibility of icons for project parts in the tree view. 
  811.  
  812. Font 
  813.      Selects the font for icon labels in the tree view. You can use the Change 
  814.      font pushbutton to interactively select a different font. 
  815.  
  816. Undo 
  817.      Restores the page to the same settings as when you opened the dialog. 
  818.  
  819. Default 
  820.      Restores the page to its default values. 
  821.  
  822. Help 
  823.      Displays this help panel. 
  824.  
  825. Related information 
  826.  
  827. o This page is part of the project settings notebook. 
  828. o View page (1 of 3) 
  829. o View page (3 of 3) 
  830.  
  831.  
  832. ΓòÉΓòÉΓòÉ 2.7. View page (3 of 3) ΓòÉΓòÉΓòÉ
  833.  
  834. Use this page to customize the display of the details view for the main project 
  835. window. 
  836.  
  837. Controls (Page 3 - Details view) 
  838.  
  839. Details to display 
  840.      Selects which details about each project part are displayed in the details 
  841.      view. 
  842.  
  843. Font 
  844.      Selects the font for icon labels in the details view. You can use the 
  845.      Change font pushbutton to interactively select a different font. 
  846.  
  847. Undo 
  848.      Restores the page to the same settings as when you opened the dialog. 
  849.  
  850. Default 
  851.      Restores the page to its default values. 
  852.  
  853. Help 
  854.      Displays this help panel. 
  855.  
  856. Related information 
  857.  
  858. o This page is part of the project settings notebook. 
  859. o View page (1 of 3) 
  860. o View page (2 of 3) 
  861.  
  862.  
  863. ΓòÉΓòÉΓòÉ 2.8. Sort page ΓòÉΓòÉΓòÉ
  864.  
  865. Use this page to select the order in which project parts are listed in each 
  866. view of the project parts container. 
  867.  
  868. Controls 
  869.  
  870. Sort by attribute 
  871.      Determines which attributes are listed under the Sort cascading menu of 
  872.      the System menu and the project parts container popup menu. You can sort 
  873.      the project parts by selecting from these menus. 
  874.  
  875. Default sort attribute 
  876.      Determines which attribute is to be the default under the Sort cascading 
  877.      menus. Select an attribute from the dropdown list box. 
  878.  
  879.      If the Always maintain sort order check box is selected, changing this 
  880.      setting also sorts the project parts again. 
  881.  
  882. Descending sort order 
  883.      Select this box to sort with largest, latest, or alphabetically greatest 
  884.      items listed first. 
  885.  
  886. Always maintain sort order 
  887.      Select this box if you always want to see the projects parts in sorted 
  888.      order. Deselect it if the sorting is not worth the extra performance 
  889.      overhead. 
  890.  
  891. Undo 
  892.      Restores the page to the same settings as when you opened the dialog. 
  893.  
  894. Default 
  895.      Restores the page to its default values. 
  896.  
  897. Help 
  898.      Displays this help panel. 
  899.  
  900. Related information 
  901.  
  902. o This page is part of the project settings notebook. 
  903. o You can sort the project parts at any time using the Sort cascading menu 
  904.   under the project's popup or System menu. 
  905.  
  906.  
  907. ΓòÉΓòÉΓòÉ <hidden> Select ΓòÉΓòÉΓòÉ
  908.  
  909. Use the choices under this cascading menu to select or deselect all the project 
  910. parts in the project container at once. 
  911.  
  912.  
  913. ΓòÉΓòÉΓòÉ <hidden> Sort ΓòÉΓòÉΓòÉ
  914.  
  915. To sort the parts in a project, select Sort from the project's popup or System 
  916. menu.  You can select the attribute to be used for sorting from the Sort 
  917. cascading menu. 
  918.  
  919. Related information 
  920.  
  921. o Select which attributes are listed under the Sort cascading menu, and whether 
  922.   WorkFrame automatically keeps the project parts in sorted order, on the Sort 
  923.   page of the project's settings notebook. 
  924.  
  925.  
  926. ΓòÉΓòÉΓòÉ 3. Tools setup window ΓòÉΓòÉΓòÉ
  927.  
  928. The Tools setup window is where you define what tools are associated with the 
  929. project, the settings of environment variables to be in effect when those tools 
  930. are executed, and symbolic names for the different file types (or groups of 
  931. file types) that these tools accept as input or produce as output. 
  932.  
  933. You can customize what objects are displayed in this window by selecting or 
  934. deselecting the menu choices under the View pulldown menu. 
  935.  
  936. Menu-Bar Choices 
  937.  
  938. o Actions 
  939. o Variables 
  940. o Types 
  941. o View 
  942. o Help 
  943.  
  944. Controls 
  945.  
  946. o The object container can display these different views: 
  947.  
  948.    - Actions view. 
  949.    - Variables view. 
  950.    - Types view. 
  951.  
  952. o The Tools setup toolbar gives fast access to some of the operations that are 
  953.   available from the popup and pulldown menus. 
  954. o An information line provides an explanation of some parts of the window as 
  955.   the mouse moves over them. A choice under the View menu lets you hide the 
  956.   information line. 
  957.  
  958.  
  959. ΓòÉΓòÉΓòÉ 3.1. Actions view ΓòÉΓòÉΓòÉ
  960.  
  961. Information about how to execute a particular tool is contained within an 
  962. object called an action. Each action defines what types of files the tool 
  963. accepts as input and produces as output, what options to set when executing the 
  964. tool, and other related items of information. Depending on what types of files 
  965. the action applies to, it may appear on the popup menus for objects in the 
  966. Project window and/or in the background popup menu of the Project window. 
  967.  
  968. Actions are grouped according to their Class field, in categories such as Edit 
  969. and Compile. 
  970.  
  971. In the container, you can: 
  972.  
  973. o Click on the plus-sign icons next to the class names to expand or contract 
  974.   parts of the tree view. Or double-click on the class names themselves. 
  975.  
  976. o Select an actions from the list, and select items from its popup menu to 
  977.   create, delete, change, or do other things to the action. 
  978.  
  979.   Moving and copying an action both start with an action in the current project 
  980.   and put it in a different project. The Where defined menu choice shows which 
  981.   project has the original definition of this action, if the definition is 
  982.   inherited from another project. 
  983.  
  984. o Double-click on an action to change its options. If the action has both 
  985.   project-scoped options and file-scoped options, the project-scoped options 
  986.   are displayed by double-clicking. 
  987.  
  988. o Drag and drop an action on the shredder to delete it. Or, drag and drop it on 
  989.   the Tools setup window of another project to move or copy it (depending on 
  990.   whether you hold down the Ctrl key while dragging). Actions that are 
  991.   inherited can only be deleted in the defining project. 
  992.  
  993. o Select some common operations from the toolbar as a fastpath. 
  994.  
  995. Related information 
  996.  
  997. o This view is part of the Tools setup window. 
  998. o You can switch between the different view with the View pulldown menu 
  999. o Actions pulldown menu 
  1000.  
  1001.  
  1002. ΓòÉΓòÉΓòÉ 3.2. Environment variables view ΓòÉΓòÉΓòÉ
  1003.  
  1004. The Environment variables view lists environment variables and their settings 
  1005. that are in effect while an action is being executed. These settings override 
  1006. those specified in the CONFIG.SYS file. All the listed environment variables 
  1007. are set while running any action. 
  1008.  
  1009. In the view, you can: 
  1010.  
  1011. o Add a new environment variable or override the setting of an existing one, by 
  1012.   selecting Add from the toolbar or from the Variables pulldown menu. 
  1013.  
  1014. o Select one or more environment variables from the list, and select an 
  1015.   operation from their popup menu. 
  1016.  
  1017.   Moving and copying an environment variable both start with a variable in the 
  1018.   current project and put it in a different project. The Where defined menu 
  1019.   choice shows which project has the original definition of this variable, if 
  1020.   the definition is inherited from another project. 
  1021.  
  1022. o Double-click on a variable to change its value. 
  1023.  
  1024. o Drag and drop a variable on the shredder to delete it. Or, drag and drop it 
  1025.   on the Tools setup window of another project to move or copy it (depending on 
  1026.   whether you hold down the Ctrl key while dragging). Variables that are 
  1027.   inherited can only be deleted in the defining project. 
  1028.  
  1029. o Select some common operations from the toolbar as a fastpath. 
  1030.  
  1031. Related information 
  1032.  
  1033. o This view is part of the Tools setup window. 
  1034. o You can switch between the different containers with the View pulldown menu 
  1035. o Variables pulldown menu 
  1036.  
  1037.  
  1038. ΓòÉΓòÉΓòÉ 3.3. Types view ΓòÉΓòÉΓòÉ
  1039.  
  1040. The Types view lists symbolic names that are assigned to file types and groups 
  1041. of file types. You can use these names in the places where you can specify file 
  1042. masks, such as *.C. In fields where you can enter multiple names or masks, you 
  1043. can mix these type names with file masks. 
  1044.  
  1045. In the view, you can: 
  1046.  
  1047. o Select one or more types from the list, and select an operation from their 
  1048.   popup menu. 
  1049.  
  1050.   Moving and copying a type both start with a type in the current project and 
  1051.   put it in a different project. 
  1052.  
  1053.   The Where defined menu choice shows which project has the original definition 
  1054.   of this type, if the definition is inherited from another project. 
  1055.  
  1056.   When adding a type, probably the most common form you will use is the 
  1057.   FileMask, which is one or more file masks using wildcard characters such as * 
  1058.   and ?. To enter a Logical AND or other logical expression, all of the 
  1059.   components of the expression must be other type names or file masks. 
  1060.  
  1061. o Double-click on a type to change its value. 
  1062.  
  1063. o Drag and drop a type on the shredder to delete it. Or, drag and drop it on 
  1064.   the Tools setup window of another project to move or copy it. (depending on 
  1065.   whether you hold down the Ctrl key while dragging). Types that are inherited 
  1066.   can only be deleted in the defining project. 
  1067.  
  1068. o Select some common operations from the toolbar as a fastpath. 
  1069.  
  1070. Related information 
  1071.  
  1072. o Background information about types and type classes 
  1073. o This view is part of the Tools setup window. 
  1074. o You can switch between the different containers with the View pulldown menu 
  1075. o Types menu 
  1076.  
  1077.  
  1078. ΓòÉΓòÉΓòÉ 3.4. Actions menu ΓòÉΓòÉΓòÉ
  1079.  
  1080. Use the entries under this menu to perform an operation on the selected action, 
  1081. or on the default action for a class if a class is selected. 
  1082.  
  1083. Menu Summary 
  1084.  
  1085. o Project options 
  1086. o File options 
  1087. o Add 
  1088. o Change 
  1089. o Copy 
  1090. o Move 
  1091. o Delete 
  1092. o Expand all 
  1093. o Collapse all 
  1094. o Where defined 
  1095.  
  1096.  
  1097. ΓòÉΓòÉΓòÉ 3.4.1. Project options ΓòÉΓòÉΓòÉ
  1098.  
  1099. The choices under this cascading menu allow you to change, copy, or delete the 
  1100. options from a selected project-scoped action. 
  1101.  
  1102. These options are passed to the action as if typed on the command line. 
  1103.  
  1104. If this menu item is not available, either select a project-scoped action or 
  1105. change the action settings and make sure the action applies to projects. 
  1106.  
  1107. Menu Choices 
  1108.  
  1109. Change 
  1110.      Allows you to change the options that are used by the action when it is 
  1111.      executed as a project-scoped action. Some actions supply a customized 
  1112.      options dialog; others use a common change dialog in which you enter the 
  1113.      options as a string. 
  1114.  
  1115. Copy 
  1116.      Copies the project-scoped options from this action to another action. 
  1117.  
  1118.      When you copy the options of an inherited action, the options from the 
  1119.      defining project are copied. 
  1120.  
  1121. Delete 
  1122.      Removes any changes you have made to the project-scoped options for this 
  1123.      inherited action. The options return to their inherited values. If you 
  1124.      have not changed the options from their default values or if the action is 
  1125.      not inherited, this choice is not available. 
  1126.  
  1127.  
  1128. ΓòÉΓòÉΓòÉ 3.4.2. File options ΓòÉΓòÉΓòÉ
  1129.  
  1130. The choices under this cascading menu allow you to change, copy, or delete the 
  1131. options from a selected file-scoped action. 
  1132.  
  1133. These options are passed to the action as if typed on the command line. 
  1134.  
  1135. If this menu item is not available, either select a file-scoped action or 
  1136. change the action settings and make sure the action applies to files. 
  1137.  
  1138. Menu Choices 
  1139.  
  1140. Change 
  1141.      Allows you to change the options that are used by the action when it is 
  1142.      executed as a file-scoped action. Some actions supply a customized options 
  1143.      dialog; others use a common change dialog in which you enter the options 
  1144.      as a string. 
  1145.  
  1146. Copy 
  1147.      Copies the file-scoped options from this action to another action. 
  1148.  
  1149.      When you copy the options of an inherited action, the options from the 
  1150.      defining project are copied. 
  1151.  
  1152. Delete 
  1153.      Removes any changes you have made to the file-scoped options for this 
  1154.      inherited action. The options return to their default values. If you have 
  1155.      not changed the options from their default values or if the action is not 
  1156.      inherited, this choice is not available. 
  1157.  
  1158.  
  1159. ΓòÉΓòÉΓòÉ 3.4.3. Add ΓòÉΓòÉΓòÉ
  1160.  
  1161. Displays a settings notebook where you can define the settings of a new action. 
  1162.  
  1163. If a class name is selected in the window, the settings notebook only has a few 
  1164. values filled in. 
  1165.  
  1166. If an action is selected in the window, the notebook dialog has the same values 
  1167. as the selected action. Change the name and/or class, and any other settings 
  1168. that you want to customize. This is a convenient way to make multiple, slightly 
  1169. customized copies of an action within the same project. If the action is 
  1170. inherited, you can create a local copy (which can be changed) by selecting Add 
  1171. and leaving the name and class the same. 
  1172.  
  1173. Related information 
  1174.  
  1175. o This same notebook is also used to change an action. 
  1176. o Background information about actions 
  1177.  
  1178.  
  1179. ΓòÉΓòÉΓòÉ 3.4.4. Change ΓòÉΓòÉΓòÉ
  1180.  
  1181. Displays a settings notebook where you can change the settings of a selected 
  1182. action. 
  1183.  
  1184. If this menu item is not available: 
  1185.  
  1186. o Make sure you have selected an action (not a class name). 
  1187. o Use the Where defined menu choice to check if the action is defined in this 
  1188.   project, or inherited from a base project. If the action is inherited, you 
  1189.   can change it within the base project, or by selecting Add and making a local 
  1190.   copy of the action that overrides the inheriteda action. 
  1191.  
  1192. Related information 
  1193.  
  1194. o This same notebook is also used to add an action 
  1195. o When modifying inherited objects in a base project, there are precautions 
  1196.   that you should take. 
  1197. o Background information about actions 
  1198.  
  1199.  
  1200. ΓòÉΓòÉΓòÉ 3.4.5. Copy ΓòÉΓòÉΓòÉ
  1201.  
  1202. Copies the selected action or all actions in the selected class to a project. 
  1203.  
  1204. You can enter a different name for the action, which is required when copying 
  1205. an action within the same project. 
  1206.  
  1207. You can also use a Find dialog to locate the project to which to copy the 
  1208. action. 
  1209.  
  1210. If you want to copy an action from some other project to this one, open the 
  1211. other project and perform the copy operation from there. 
  1212.  
  1213.  
  1214. ΓòÉΓòÉΓòÉ 3.4.6. Move ΓòÉΓòÉΓòÉ
  1215.  
  1216. Moves the selected action to a project. 
  1217.  
  1218. You can enter a different name for the action, allowing you to rename an action 
  1219. by moving it within the same project. 
  1220.  
  1221. You can also use a Find dialog locate the project to which to move the action. 
  1222.  
  1223. If you want to move an action from some other project to this one, open the 
  1224. other project and perform the move operation from there. 
  1225.  
  1226. If this menu item is not available: 
  1227.  
  1228. o Make sure you have selected an action (not a class name). 
  1229. o Use the Where defined menu choice to check if the action is defined in this 
  1230.   project, or inherited from a base project. If the action is inherited, you 
  1231.   can move or copy it from the base project. 
  1232.  
  1233. Related information 
  1234.  
  1235. o When modifying inherited objects in a base project, there are precautions 
  1236.   that you should take. 
  1237.  
  1238.  
  1239. ΓòÉΓòÉΓòÉ 3.4.7. Delete ΓòÉΓòÉΓòÉ
  1240.  
  1241. Deletes the selected action or all actions in the selected class from a 
  1242. project. 
  1243.  
  1244. If this menu item is not available: 
  1245.  
  1246. o Make sure you have selected an action (not a class name). 
  1247. o Use the Where defined menu choice to check if the action is defined in this 
  1248.   project, or inherited from a base project. If the action is inherited, you 
  1249.   can delete it within the base project. 
  1250.  
  1251. If you delete an action but it is still available in the project, you might 
  1252. have deleted a local copy of an inherited action, and must use the above 
  1253. procedure or remove the inheritance relationship if you want to delete it 
  1254. permanently. 
  1255.  
  1256. Related information 
  1257.  
  1258. o When modifying inherited objects in a base project, there are precautions 
  1259.   that you should take. 
  1260.  
  1261.  
  1262. ΓòÉΓòÉΓòÉ 3.4.8. Expand all ΓòÉΓòÉΓòÉ
  1263.  
  1264. Expands all levels of the tree view, showing all the action classes and all the 
  1265. associated actions. 
  1266.  
  1267.  
  1268. ΓòÉΓòÉΓòÉ 3.4.9. Collapse all ΓòÉΓòÉΓòÉ
  1269.  
  1270. Collapses all levels of the tree view. 
  1271.  
  1272.  
  1273. ΓòÉΓòÉΓòÉ 3.4.10. Expand ΓòÉΓòÉΓòÉ
  1274.  
  1275. Expands one level of the tree view, showing the list of actions that are 
  1276. grouped under the selected class. Within each class, actions are listed in the 
  1277. order of their priority, with the highest-priority action on top. 
  1278.  
  1279. This item is only available after selecting a class, not an action. 
  1280.  
  1281.  
  1282. ΓòÉΓòÉΓòÉ 3.4.11. Collapse ΓòÉΓòÉΓòÉ
  1283.  
  1284. Collapses one level of the tree view, hiding the list of actions that are 
  1285. grouped under the selected class. 
  1286.  
  1287. This item is only available after selecting a class, not an action. 
  1288.  
  1289.  
  1290. ΓòÉΓòÉΓòÉ 3.4.12. Where defined ΓòÉΓòÉΓòÉ
  1291.  
  1292. Displays the project where the selected action, type, or environment variable 
  1293. is defined. You can then go directly to that project's Tools setup, where you 
  1294. can modify an object that is inherited by your project. 
  1295.  
  1296. These objects can be inherited from other projects, that is, defined in one 
  1297. project and used in another. The defining project might be one that you or 
  1298. someone in your organization has set up, or it might be one provided as part of 
  1299. a product. 
  1300.  
  1301. Related information 
  1302.  
  1303. o When modifying inherited objects in a base project, there are precautions 
  1304.   that you should take. 
  1305.  
  1306.  
  1307. ΓòÉΓòÉΓòÉ 3.5. Variables menu ΓòÉΓòÉΓòÉ
  1308.  
  1309. Use the entries under this menu to perform an operation on the selected 
  1310. environment variable. 
  1311.  
  1312. Menu Summary 
  1313.  
  1314. o Add 
  1315. o Change 
  1316. o Copy 
  1317. o Move 
  1318. o Delete 
  1319. o Where defined 
  1320.  
  1321.  
  1322. ΓòÉΓòÉΓòÉ 3.5.1. Add ΓòÉΓòÉΓòÉ
  1323.  
  1324. Displays a dialog where you can define the settings for a new environment 
  1325. variable. 
  1326.  
  1327. Related information 
  1328.  
  1329. o Background information about environment variables 
  1330.  
  1331.  
  1332. ΓòÉΓòÉΓòÉ 3.5.2. Change ΓòÉΓòÉΓòÉ
  1333.  
  1334. Displays a dialog where you can change the value of a selected variable. 
  1335.  
  1336. If this menu item is not available: 
  1337.  
  1338. o Use the Where defined menu choice to check if the variable is defined in this 
  1339.   project, or inherited from a base project. If the variable is inherited, you 
  1340.   can change it within the base project. 
  1341.  
  1342. Related information 
  1343.  
  1344. o Background information about environment variables 
  1345. o When modifying inherited objects in a base project, there are precautions 
  1346.   that you should take. 
  1347.  
  1348.  
  1349. ΓòÉΓòÉΓòÉ 3.5.3. Copy ΓòÉΓòÉΓòÉ
  1350.  
  1351. Copies the selected variable to a project. 
  1352.  
  1353. You can enter a different name for the variable, which is required when copying 
  1354. a variable within the same project. 
  1355.  
  1356. You can also use a Find dialog to locate the project to which to copy the 
  1357. variable. 
  1358.  
  1359. If you want to copy a variable from some other project to this one, open the 
  1360. other project and perform the copy operation from there. 
  1361.  
  1362.  
  1363. ΓòÉΓòÉΓòÉ 3.5.4. Move ΓòÉΓòÉΓòÉ
  1364.  
  1365. Moves the selected variable to a project. 
  1366.  
  1367. You can enter a different name for the variable, allowing you to rename a 
  1368. variable by moving it within the same project. 
  1369.  
  1370. You can also use a Find dialog to locate the project to which to move the 
  1371. variable. 
  1372.  
  1373. If you want to move a variable from some other project to this one, open the 
  1374. other project and perform the move operation from there. 
  1375.  
  1376. Related information 
  1377.  
  1378. o When modifying inherited objects in a base project, there are precautions 
  1379.   that you should take. 
  1380.  
  1381.  
  1382. ΓòÉΓòÉΓòÉ 3.5.5. Delete ΓòÉΓòÉΓòÉ
  1383.  
  1384. Deletes the definition of the selected variable from a project. 
  1385.  
  1386. If this menu item is not available: 
  1387.  
  1388. o Use the Where defined menu choice to check if the variable is defined in this 
  1389.   project, or inherited from a base project. If the variable is inherited, you 
  1390.   can delete it within the base project. 
  1391.  
  1392. If you delete a variable but it is still available in the project, you might 
  1393. have deleted a local copy of an inherited variable, and must use the above 
  1394. procedure or remove the inheritance relationship if you want to delete it 
  1395. permanently. 
  1396.  
  1397. Related information 
  1398.  
  1399. o When modifying inherited objects in a base project, there are precautions 
  1400.   that you should take. 
  1401.  
  1402.  
  1403. ΓòÉΓòÉΓòÉ 3.6. Types menu ΓòÉΓòÉΓòÉ
  1404.  
  1405. Use the entries under this menu to perform an operation on the selected type. 
  1406.  
  1407. Menu Summary 
  1408.  
  1409. o Add 
  1410. o Change 
  1411. o Copy 
  1412. o Move 
  1413. o Delete 
  1414. o Where defined 
  1415. o Register class 
  1416.  
  1417. Related information 
  1418.  
  1419. o Background information about types and type classes 
  1420.  
  1421.  
  1422. ΓòÉΓòÉΓòÉ 3.6.1. Add ΓòÉΓòÉΓòÉ
  1423.  
  1424. Displays a dialog where you can define the filters for a new type. 
  1425.  
  1426. You can use types in many of the same places that you can enter file masks, to 
  1427. save having to remember complicated file masks and enter them over and over. 
  1428.  
  1429. Related information 
  1430.  
  1431. o Types view 
  1432. o Background information about types and type classes 
  1433.  
  1434.  
  1435. ΓòÉΓòÉΓòÉ 3.6.2. Change ΓòÉΓòÉΓòÉ
  1436.  
  1437. Displays a dialog where you can change the settings of a selected type. 
  1438.  
  1439. If this menu item is not available: 
  1440.  
  1441. o Use the Where defined menu choice to check if the object is defined in this 
  1442.   project, or inherited from a base project. If the object is inherited, you 
  1443.   can only change it within the base project. 
  1444.  
  1445. Related information 
  1446.  
  1447. o When modifying inherited objects in a base project, there are precautions 
  1448.   that you should take. 
  1449. o Types view 
  1450. o Background information about types and type classes 
  1451.  
  1452.  
  1453. ΓòÉΓòÉΓòÉ 3.6.3. Copy ΓòÉΓòÉΓòÉ
  1454.  
  1455. Copies the selected type to a project. 
  1456.  
  1457. You can enter a different name for the type, which is required when copying a 
  1458. type within the same project. 
  1459.  
  1460. You can also use a Find dialog to locate the project to which to copy the type. 
  1461.  
  1462. If you want to copy a type from some other project to this one, open the other 
  1463. project and perform the copy operation from there. 
  1464.  
  1465.  
  1466. ΓòÉΓòÉΓòÉ 3.6.4. Move ΓòÉΓòÉΓòÉ
  1467.  
  1468. Moves the selected type to a project. 
  1469.  
  1470. You can enter a different name for the type, allowing you to rename a type by 
  1471. moving it within the same project. 
  1472.  
  1473. You can also use a Find dialog to locate the project to which to move the type. 
  1474.  
  1475. If you want to move a type from some other project to this one, open the other 
  1476. project and perform the move operation from there. 
  1477.  
  1478. If this menu item is not available: 
  1479.  
  1480. o Use the Where defined menu choice to check if the object is defined in this 
  1481.   project, or inherited from a base project. If the object is inherited, you 
  1482.   can only move it within the base project. 
  1483.  
  1484. Related information 
  1485.  
  1486. o When modifying inherited objects in a base project, there are precautions 
  1487.   that you should take. 
  1488.  
  1489.  
  1490. ΓòÉΓòÉΓòÉ 3.6.5. Delete ΓòÉΓòÉΓòÉ
  1491.  
  1492. Deletes the definition of the selected type from a project. 
  1493.  
  1494. If this menu item is not available: 
  1495.  
  1496. o Use the Where defined menu choice to check if the object is defined in this 
  1497.   project, or inherited from a base project. If the object is inherited, you 
  1498.   can only delete it within the base project. 
  1499.  
  1500. Related information 
  1501.  
  1502. o When modifying inherited objects in a base project, there are precautions 
  1503.   that you should take. 
  1504.  
  1505.  
  1506. ΓòÉΓòÉΓòÉ 3.6.6. Register class ΓòÉΓòÉΓòÉ
  1507.  
  1508. Displays a dialog where you can define a new type class that will be available 
  1509. on the dialogs related to types. 
  1510.  
  1511.  
  1512. ΓòÉΓòÉΓòÉ 3.7. View menu ΓòÉΓòÉΓòÉ
  1513.  
  1514. Use this menu to change the presentation of information in the Tools setup 
  1515. window. 
  1516.  
  1517. Menu choices 
  1518.  
  1519. o Actions 
  1520. o Variables 
  1521. o Types 
  1522. o Mini-icons 
  1523. o Information line 
  1524. o Toolbar 
  1525.  
  1526.  
  1527. ΓòÉΓòÉΓòÉ 3.7.1. Actions ΓòÉΓòÉΓòÉ
  1528.  
  1529. Displays in the window the actions that are available to the project. These 
  1530. actions are displayed on popup and pulldown menus in the Project window. 
  1531.  
  1532. Related information 
  1533.  
  1534. o Actions view. 
  1535.  
  1536.  
  1537. ΓòÉΓòÉΓòÉ 3.7.2. Variables ΓòÉΓòÉΓòÉ
  1538.  
  1539. Displays in the window the environment-variable settings that are defined for 
  1540. the project. 
  1541.  
  1542. These settings are in effect while any project action is being executed, 
  1543. overriding any previous value. The settings have no effect on applications or 
  1544. commands that are executed outside the project. 
  1545.  
  1546. Related information 
  1547.  
  1548. o Variables view. 
  1549.  
  1550.  
  1551. ΓòÉΓòÉΓòÉ 3.7.3. Types ΓòÉΓòÉΓòÉ
  1552.  
  1553. Displays in the window the types that are defined for the project. 
  1554.  
  1555. Related information 
  1556.  
  1557. o Types view. 
  1558.  
  1559.  
  1560. ΓòÉΓòÉΓòÉ 3.7.4. Mini-icons ΓòÉΓòÉΓòÉ
  1561.  
  1562. Toggles whether the action view represents the actions using large or small 
  1563. icons. 
  1564.  
  1565.  
  1566. ΓòÉΓòÉΓòÉ 3.7.5. Information line ΓòÉΓòÉΓòÉ
  1567.  
  1568. Toggles whether the information line at the bottom of the window is displayed 
  1569. or hidden. You might not need the information line if you use the View pulldown 
  1570. menu to change the tool bar to a textual representation or turn on the hover 
  1571. help for the tool bar. 
  1572.  
  1573.  
  1574. ΓòÉΓòÉΓòÉ 3.7.6. Toolbars ΓòÉΓòÉΓòÉ
  1575.  
  1576. Changes the appearance of any tool bars in this window. 
  1577.  
  1578. Menu choices 
  1579.  
  1580. Show 
  1581.      Selects whether any toolbars are displayed in the window. Deselect it if 
  1582.      you use the menus or accelerator keys exclusively. 
  1583.  
  1584. Hover help 
  1585.      Selects whether or not brief explanations of each toolbar icon are 
  1586.      displayed next to the icon as the mouse moves over the toolbar. Deselect 
  1587.      it if you are familiar with the toolbar icons, if the explanations in the 
  1588.      information line are sufficient, or if the performance overhead of this 
  1589.      help slows down your work. 
  1590.  
  1591. Style 
  1592.      Selects whether the tool bar should label its icons with graphics, text, 
  1593.      or both: 
  1594.  
  1595.    Graphic and text 
  1596.         Displays both a graphic icon and text label for each toolbar item. 
  1597.  
  1598.    Graphic only 
  1599.         Displays a graphic icon for each toolbar item. 
  1600.  
  1601.    Text only 
  1602.         Displays a text label for each toolbar item. 
  1603.  
  1604.  
  1605. ΓòÉΓòÉΓòÉ 3.8. Tools setup toolbar ΓòÉΓòÉΓòÉ
  1606.  
  1607. This tool bar contains the following buttons, which provide fastpaths to 
  1608. functions that are also available from the popup and pulldown menus: 
  1609.  
  1610. Add 
  1611.      Displays the Add window for the current view. For example, for the Actions 
  1612.      view, the Add action window is displayed. 
  1613.  
  1614. Change 
  1615.      Opens the settings for the selected object. This button is not available 
  1616.      when an inherited object is selected. You can only change Tools setup 
  1617.      objects in the project where they are defined. 
  1618.  
  1619. Delete 
  1620.      Deletes the selected Tools setup object. This button is not available when 
  1621.      an inherited object is selected. You can only delete Tools setup objects 
  1622.      from the project where they are defined. 
  1623.  
  1624. File-scoped options 
  1625.      Displays the file-scoped options dialog of the selected action. Use this 
  1626.      dialog to set options for the file-scoped action. Options are the 
  1627.      parameters that are passed to the tool when the action is invoked. This 
  1628.      button is not available in the Variables view and Types view, or if the 
  1629.      selected action does not have the applicable scope. 
  1630.  
  1631. Project-scoped options 
  1632.      Displays the project-scoped options dialog of the selected action. Use 
  1633.      this dialog to set options for the project-scoped action. Options are the 
  1634.      parameters that are passed to the tool when the action is invoked. This 
  1635.      button is not available in the Variables view and the Types view, or if 
  1636.      the selected action does not have the applicable scope. 
  1637.  
  1638. Actions view 
  1639.      Switches to Actions view. 
  1640.  
  1641. Variables view 
  1642.      Switches to Variables view. 
  1643.  
  1644. Types view 
  1645.      Switches to Types view. 
  1646.  
  1647. How Do I? 
  1648.      Shows the WorkFrame How Do I? help, which explains how to do common tasks 
  1649.      using WorkFrame. 
  1650.  
  1651.  
  1652. ΓòÉΓòÉΓòÉ <hidden> Background information about types and type classes ΓòÉΓòÉΓòÉ
  1653.  
  1654. Like actions, types are named and grouped into classes.  A type's class 
  1655. provides the method in which a project part is determined to be a member of the 
  1656. type. WorkFrame provides several predefined type classes, including "File 
  1657. Mask": 
  1658.  
  1659. File Mask 
  1660.      This type class provides simple OS/2-style pattern matching on the file 
  1661.      name of a project part.  You specify filter patterns using wild cards. 
  1662.  
  1663. Regular Expression 
  1664.      This type class is similar to "File Mask", but allows filter patterns to 
  1665.      be specified using the full power of regular expressions. Unlike file 
  1666.      masks, a regular expression cannot be used interchangeably with types when 
  1667.      you use the project's Parts filter, or when specifying the Source and 
  1668.      Target types of an action.  You must define and use a Regular Expression 
  1669.      type instead. 
  1670.  
  1671.      There are several different syntaxes for regular expressions.  The one 
  1672.      supported here is the Extended Regular Expressions (ERE) format. The 
  1673.      syntax is described in a table, where a, b, and c are regular expressions, 
  1674.      and n and m are integers. 
  1675.  
  1676. PAM 
  1677.      The filter for this type class is the name of a Project Access Method. 
  1678.      Only parts returned by the specified PAM are members of the type. 
  1679.  
  1680.      For example, a version control tool might provide a PAM type called 
  1681.      "Checked out" that identifies project parts that are already in use.  A 
  1682.      PAM that provides access to parts on a database might support its own 
  1683.      types like "Locked" and "Unlocked". 
  1684.  
  1685.      Typically, only a very specific list of types can be created from a PAM 
  1686.      class type.  The basic OS/2 PAM does not support any types. 
  1687.  
  1688. Logical AND 
  1689.      The filter for this class is a list of other types or file masks. Parts 
  1690.      that are members of all the listed types are also members of this type. 
  1691.  
  1692. Logical OR 
  1693.      The filter for this class is a list of other types or file masks. Parts 
  1694.      that are members of any one of the listed types are also members of this 
  1695.      type. 
  1696.  
  1697. NOT IN File Mask 
  1698.      This is the inverse of the File Mask type class.  The filter for this 
  1699.      class is a list of file masks.  Parts that do not match any of the listed 
  1700.      masks are members of this type. 
  1701.  
  1702. NOT IN Regular Expression 
  1703.      This is the inverse of the Regular Expression type class.  The filter for 
  1704.      this class is a list of regular expressions. Parts that do not match any 
  1705.      of the listed regular expressions are members of this type. 
  1706.  
  1707. NOT IN Logical AND 
  1708.      This type class is the inverse of the Logical-AND type class. The filter 
  1709.      for this class is a list of other types or file masks. Parts that do not 
  1710.      match any of the listed types are members of this type. 
  1711.  
  1712. NOT IN Logical OR 
  1713.      This type class is the inverse of the Logical-OR type class. The filter 
  1714.      for this class is a list of other types or file masks. Parts that do not 
  1715.      match any of the listed types are members of this type. 
  1716.  
  1717. MakeMake Note  Only the "File Mask", "Logical OR", and "NOT IN Logical OR" 
  1718. classes are recognized by MakeMake in the source and target types of actions 
  1719. invoked during a project build. 
  1720.  
  1721. Related information 
  1722.  
  1723. o Registering classes 
  1724.  
  1725.  
  1726. ΓòÉΓòÉΓòÉ <hidden> Regular expression syntax ΓòÉΓòÉΓòÉ
  1727.  
  1728. This table shows the notation you can use for specifying regular expressions in 
  1729. type filters. 
  1730.  
  1731.                           Γöé
  1732.  a                        ΓöéDenotes an exact match.
  1733.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1734.  .                        ΓöéMatches any single character.  This is the same as
  1735.                           Γöéthe ? wild card used in OS/2 file masks.  To
  1736.                           Γöédenote a literal dot character, precede the dot
  1737.                           Γöéwith a backslash, as in \..
  1738.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1739.  ^a                       ΓöéMatches if a occurs at the beginning of the name.
  1740.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1741.  a$                       ΓöéMatches if a occurs at the end of the name. For
  1742.                           Γöéexample, ^a$ matches only a.
  1743.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1744.  a|b                      ΓöéMatches either a or b.
  1745.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1746.  [<list of characters>]   ΓöéMatches any of the characters in the list. For
  1747.                           Γöéexample, [abc] would match the names a, b, and c.
  1748.                           ΓöéTo match a dash (-) character, it must be placed
  1749.                           Γöéfirst or last in the list (for example, [-abc].c).
  1750.                           ΓöéTo match a caret (^) character, it must be placed
  1751.                           Γöésomewhere other than in the first position.  To
  1752.                           Γöématch a close or open bracket character ([ or ]),
  1753.                           Γöéit must be placed first in the list, or second
  1754.                           Γöéafter a caret.
  1755.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1756.  [<range of characters>]  ΓöéMatches any character in the range.  For example,
  1757.                           Γöé[a-c] would match the names a, b, and c. You could
  1758.                           Γöéalso write [ab-c] as an equivalent expression.
  1759.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1760.  [^<characters>]          ΓöéMatches any character other than those specified
  1761.                           Γöéin the list or range.  For example, [^a-c] will
  1762.                           Γöématch any file not named a, b, or c.
  1763.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1764.  a{n}                     ΓöéMatches a repeated exactly n times.  For example,
  1765.                           Γöéa{3} will match only the name aaa.
  1766.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1767.  a{n,m}                   ΓöéMatches a repeated between n and m times,
  1768.                           Γöéinclusively. For example, a{2,3} will match only
  1769.                           Γöéthe file names aa and aaa. If m is ommitted, then
  1770.                           Γöéit assumes the value of infinity.
  1771.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1772.  a?                       ΓöéMatches zero or one occurrences of a.  This is
  1773.                           Γöéshorthand for a{0,1}.
  1774.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1775.  a+                       ΓöéMatches one or more repetitions of a.  This is
  1776.                           Γöéshorthand for a{1,}.  For example, a+b\.c will
  1777.                           Γöématch the file name ab.c, but not b.c.
  1778.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1779.  a*                       ΓöéMatches zero or more repetitions of a. For example
  1780.                           Γöéba* will match the names b, ba, and baaaaaaaaa. to
  1781.                           Γöébe considered a comment and lost. The regular
  1782.                           Γöéexpression .* is equivalent to the OS/2 *
  1783.                           Γöéwildcard.
  1784.                           Γöé
  1785.  
  1786. Notes  Because OS/2 files are case-insensitive, WorkFrame ignores case when 
  1787. matching regular expressions. Regular expressions can be grouped using 
  1788. parentheses.  To match any literal regular expression character, precede it 
  1789. with a backslash (\). 
  1790.  
  1791.  
  1792. ΓòÉΓòÉΓòÉ <hidden> Copy/Move dialog ΓòÉΓòÉΓòÉ
  1793.  
  1794. Use this dialog to copy or move an object from this project to another project. 
  1795.  
  1796. Controls 
  1797.  
  1798. New name 
  1799.      When moving or copying a single object, you can enter a new name. The new 
  1800.      name is optional if the destination project does not have an object with 
  1801.      the same name. 
  1802.  
  1803. Target project 
  1804.      Enter the physical file name of the destination project. This name is on 
  1805.      the first File page in the project's settings notebook. 
  1806.  
  1807. Find 
  1808.      You can use a Find dialog to browse the directory tree and locate the 
  1809.      project file of the destination project. 
  1810.  
  1811. Move or Copy 
  1812.      Performs the move or copy operation. 
  1813.  
  1814. Cancel 
  1815.      Exits without performing the operation or saving data. 
  1816.  
  1817.  
  1818. ΓòÉΓòÉΓòÉ <hidden> Add/Change environment variable dialog ΓòÉΓòÉΓòÉ
  1819.  
  1820.  
  1821. ΓòÉΓòÉΓòÉ <hidden> Add/Change environment variable dialog ΓòÉΓòÉΓòÉ
  1822.  
  1823. Use this dialog to add or change an environment variable within the project. 
  1824.  
  1825. Controls 
  1826.  
  1827. Name 
  1828.      Enter the name of the environment variable that you want to add or change. 
  1829.      You can also select a name from the dropdown list box. 
  1830.  
  1831. String 
  1832.      Enter or change the value for the environment variable. Remember that this 
  1833.      value is only in effect while actions are being executed, not permanently. 
  1834.  
  1835. Add or Change 
  1836.      Performs the add or change operation. 
  1837.  
  1838. Undo 
  1839.      Restores the page to the same settings as when you opened the dialog. 
  1840.  
  1841. Cancel 
  1842.      Exits without performing the operation or saving data. 
  1843.  
  1844.  
  1845. ΓòÉΓòÉΓòÉ <hidden> Add/Change type dialog ΓòÉΓòÉΓòÉ
  1846.  
  1847.  
  1848. ΓòÉΓòÉΓòÉ <hidden> Add/Change type dialog ΓòÉΓòÉΓòÉ
  1849.  
  1850. Use this dialog to add or change a type within the project. 
  1851.  
  1852. Controls 
  1853.  
  1854. Class 
  1855.      Enter the class to which the type belongs. Some common type classes are 
  1856.      FileMask, Regular Expression, and Logical OR or Logical AND of two or more 
  1857.      other types. You can also select a class from the dropdown list box. 
  1858.  
  1859. Name 
  1860.      Enter the name of the type to add or change. You can rename an existing 
  1861.      type by changing the name and leaving the value the same. 
  1862.  
  1863. Filter 
  1864.      Enter one or more values that identify the project parts that this type 
  1865.      identifies. The kinds of values depend on the type class: enter file masks 
  1866.      for the FileMask class, regular expressions for the Regular Expression 
  1867.      class, and so on. 
  1868.  
  1869. Add or Change 
  1870.      Performs the add or change operation. 
  1871.  
  1872. Undo 
  1873.      Restores the page to the same settings as when you opened the dialog. 
  1874.  
  1875. Cancel 
  1876.      Exits without performing the operation or saving data. 
  1877.  
  1878. Related information 
  1879.  
  1880. o Background information about types and type classes 
  1881. o Type requirements for MakeMake 
  1882.  
  1883.  
  1884. ΓòÉΓòÉΓòÉ <hidden> Register new type class dialog ΓòÉΓòÉΓòÉ
  1885.  
  1886. Use this dialog to register a new type class for the project. You only need to 
  1887. do so if you are a product developer and are integrating your product with 
  1888. WorkFrame using the WorkFrame Integration Kit, which will be available through 
  1889. the IBM support channel for this product. 
  1890.  
  1891. You can also delete an existing type class. 
  1892.  
  1893. Type classes are added to the WorkFrame environment through a registration 
  1894. process.  Registering new type classes is a specialized task that usually only 
  1895. tool providers need to do. You register, change, and delete type classes by 
  1896. selecting Register class from the Types container pop-up menu. When you 
  1897. register a new type class, you must provide the name of a DLL and an entrypoint 
  1898. that WorkFrame can call to query type membership.  WorkFrame calls the type DLL 
  1899. entrypoint passing it a list of parts and the type filter.  The entrypoint 
  1900. should then return a boolean value, true indicating that all the parts are 
  1901. valid members of the type, and false indicating that at least one of the parts 
  1902. is not. 
  1903.  
  1904. Controls 
  1905.  
  1906. Existing classes 
  1907.      You can select an existing class name from this list to fill in the Class, 
  1908.      Module name, and Entrypoint fields with values appropriate to the class. 
  1909.  
  1910. Class 
  1911.      Enter the name of the type class to add or delete. You can also select a 
  1912.      class from the dropdown list box. 
  1913.  
  1914. Module name 
  1915.      Enter the name of the DLL (without the .DLL extension) that contains the 
  1916.      function that determines if a given project part is a member of the type. 
  1917.  
  1918. Entry point 
  1919.      Enter the name of the entrypoint for the function that determines if a 
  1920.      given project part is a member of the type. WorkFrame calls the DLL 
  1921.      entrypoint passing it a list of parts and the type filter. The entrypoint 
  1922.      should return a boolean value, true indicating that all the parts are 
  1923.      valid members of the type, and false indicating that at least one of the 
  1924.      parts is not. 
  1925.  
  1926. Add 
  1927.      Adds the new type class to the project. 
  1928.  
  1929. Delete 
  1930.      Deletes the existing type class from the project. 
  1931.  
  1932. Undo 
  1933.      Restores the page to the same settings as when you opened the dialog. 
  1934.  
  1935. Cancel 
  1936.      Exits without performing the operation or saving data. 
  1937.  
  1938. Related information 
  1939.  
  1940. o Background information about types and type classes 
  1941. o Type requirements for MakeMake 
  1942.  
  1943.  
  1944. ΓòÉΓòÉΓòÉ <hidden> Precautions for inherited objects ΓòÉΓòÉΓòÉ
  1945.  
  1946. Because inherited objects can be used in multiple projects, make sure that 
  1947. changing, moving, or deleting them in the base project will not cause problems 
  1948. in other projects that might inherit them. If other developers inherit from the 
  1949. same base project, you might need to coordinate changes to the base project 
  1950. with them. 
  1951.  
  1952.  
  1953. ΓòÉΓòÉΓòÉ 4. Action settings notebook ΓòÉΓòÉΓòÉ
  1954.  
  1955. Use the Action notebook to customize an action or to get information about an 
  1956. action. This notebook is displayed when you create or change an action. 
  1957.  
  1958. Pages 
  1959.  
  1960. o General 
  1961. o Types 
  1962. o Support 
  1963. o Menus 
  1964.  
  1965. Controls 
  1966.  
  1967. OK (in notebook frame) 
  1968.      Closes the dialog and saves all the settings. Close the dialog with this 
  1969.      pushbutton rather than with the System menu to preserve any changes you 
  1970.      have made. 
  1971.  
  1972. Undo or Reset (in notebook frame) 
  1973.      Restores all pages to the same settings as when you opened the dialog. 
  1974.  
  1975. Default (in notebook frame) 
  1976.      Restores all pages to their default values. 
  1977.  
  1978. Cancel (in notebook frame) 
  1979.      Exits without performing the operation or saving data. Closing this dialog 
  1980.      using the System menu has the same effect:  changes are not saved. 
  1981.  
  1982. Help (in notebook frame) 
  1983.      Displays help for the overall dialog. The Help button on each page 
  1984.      displays help for that page. 
  1985.  
  1986.  
  1987. ΓòÉΓòÉΓòÉ 4.1. Action notebook - General page ΓòÉΓòÉΓòÉ
  1988.  
  1989. Use this page to specify the basic information about an action: 
  1990.  
  1991. Controls 
  1992.  
  1993. Class 
  1994.      The class of an action identifies the general category of an action, and 
  1995.      determines how the action is grouped in pop-up menus. There are a number 
  1996.      of predefined action classes, such as Edit and Build. You can select one 
  1997.      of the predefined names from the drop-down list box, or type in a new 
  1998.      class name. 
  1999.  
  2000.      Note:  If you are adding or changing a Run class action, specify an 
  2001.             asterisk (*) on the Program field so that the file to execute is 
  2002.             determined by the Run action's options. For example, a 
  2003.             project-scoped Run-action options string should contain the %o %r 
  2004.             substitution variables to run the project's target. A file-scoped 
  2005.             Run action should contain the %f substitution variable to run the 
  2006.             selected file. 
  2007.  
  2008. Name 
  2009.      An action's name identifies it and sets it apart from the rest of the 
  2010.      actions in the same class.  The name is also used to list the action in 
  2011.      project pop-up menus. 
  2012.  
  2013. Program 
  2014.      This field contains the name of the program or command file to run when 
  2015.      the action is invoked, including any extension, such as .EXE. 
  2016.  
  2017.      By default, actions can execute OS/2, DOS, and WIN-OS2 programs, as well 
  2018.      as .CMD or .BAT command files. You do not need to configure any special 
  2019.      settings to define actions for DOS and WIN-OS/2 programs or .BAT files. 
  2020.  
  2021.      Cross-platform or cooperative development products can extend this 
  2022.      capability to execute programs on remote or foreign file systems. 
  2023.  
  2024. Session 
  2025.      Select one of these radio buttons to specify where the output from the 
  2026.      action should be sent: 
  2027.  
  2028.    Default 
  2029.         Allows the operating system to decide where to send the output. 
  2030.  
  2031.    Monitor 
  2032.         Send the output to the project's monitor window where you can click on 
  2033.         error messages to bring up the editor on the source file. You can also 
  2034.         save the output or print it.  This option is only valid for actions 
  2035.         that write their output to standard out. 
  2036.  
  2037.         Actions that run in the monitor window are called monitored actions. 
  2038.  
  2039.         Because the monitor does not support user input, actions that prompt 
  2040.         for input should be run in a Window or Full screen session instead. 
  2041.  
  2042.    Window 
  2043.         Output is sent to a text window. 
  2044.  
  2045.    Full screen 
  2046.         Output is sent to a full-screen window. 
  2047.  
  2048. Action applies to 
  2049.      Actions may be file-scoped or project-scoped: 
  2050.  
  2051.    File-scoped 
  2052.         File-scoped actions apply to specific project parts, and can only be 
  2053.         invoked from those parts. To run a file-scoped action, you must select 
  2054.         one or more project parts and then invoke the action on the selected 
  2055.         parts. 
  2056.  
  2057.         Only file-scoped actions can be included in a make file. 
  2058.  
  2059.         The types listed in the action's Source types list determine the 
  2060.         project parts the action applies to; the action is listed on the popup 
  2061.         menu for parts that have the applicable types. 
  2062.  
  2063.    Project-scoped 
  2064.         Project-scoped actions apply to a project as a whole, rather than to 
  2065.         any particular set of project parts. These actions can be passed 
  2066.         project information, such as the name of the project make file or 
  2067.         target. Examples of project-scoped actions are Build and Run. 
  2068.  
  2069.         Project-scoped actions are invoked from the project's pop-up menu.  To 
  2070.         bring up the project's pop-up menu, point to any background area in the 
  2071.         project container and press mouse button 2. 
  2072.  
  2073.         Project-scoped actions cannot be included in a make file. 
  2074.  
  2075.    Access method 
  2076.         This field is only relevant for a project-scoped action, and is filled 
  2077.         in by the person who creates an action. It identifies the project 
  2078.         access method (PAM) that executes the program that defines the action. 
  2079.         If this field is empty, or if the project contains only OS/2 files, 
  2080.         fill in IWFBPAM as the default choice. 
  2081.  
  2082. Undo (on notebook page) 
  2083.      Restores the page to the same settings as when you opened the dialog. 
  2084.  
  2085.      The Undo pushbutton on the notebook frame undoes the changes for all 
  2086.      notebook pages. 
  2087.  
  2088. Default (on notebook page) 
  2089.      Restores the page to its default values. 
  2090.  
  2091.      The Default button on the notebook frame restores the default values for 
  2092.      all notebook pages. 
  2093.  
  2094. Help (on notebook page) 
  2095.      Displays help for the notebook page. 
  2096.  
  2097.      The Help button on the notebook frame displays help for the overall 
  2098.      notebook. 
  2099.  
  2100.  
  2101. ΓòÉΓòÉΓòÉ 4.2. Action notebook - Types page ΓòÉΓòÉΓòÉ
  2102.  
  2103. Use the Types page to specify the source and target types that apply to an 
  2104. action. 
  2105.  
  2106. Because the source and target types only apply to file-scoped actions, this 
  2107. page is only available when you have indicated that the action applies to files 
  2108. on the General page. 
  2109.  
  2110. Controls 
  2111.  
  2112. Source types 
  2113.      A list of file masks and named types that can apply to an action.  This 
  2114.      field is only required if the action is file-scoped.  For example, an Edit 
  2115.      action might have source types like the following: 
  2116.  
  2117.    o SourceFiles 
  2118.    o *.mak 
  2119.    o *.rc 
  2120.    o TextFiles 
  2121.  
  2122. Target types 
  2123.      A list of file masks and named types that are produced by an invocation of 
  2124.      the action. This field is only required if the action is file-scoped and 
  2125.      could potentially be included in a make file. For example, an Edit action 
  2126.      would not have any target types listed, but an action that created or 
  2127.      updated files as part of a Build action would need to list the applicable 
  2128.      types. 
  2129.  
  2130. Available types 
  2131.      This is the comprehensive list of types that are available to the project. 
  2132.      To add a type to the Source types and Target types lists, select one or 
  2133.      more available types then click on the <<Add push button beside the Source 
  2134.      types or Target types list box. 
  2135.  
  2136.      As you click on each available type in this list box, the information area 
  2137.      at the bottom of the page shows the filter value of the type. If the 
  2138.      filter is too long to fit in the information area, it is truncated. 
  2139.  
  2140. Undo (on notebook page) 
  2141.      Restores the page to the same settings as when you opened the dialog. 
  2142.  
  2143.      The Undo pushbutton on the notebook frame undoes the changes for all 
  2144.      notebook pages. 
  2145.  
  2146. Default (on notebook page) 
  2147.      Restores the page to its default values. 
  2148.  
  2149.      The Default button on the notebook frame restores the default values for 
  2150.      all notebook pages. 
  2151.  
  2152. Help (on notebook page) 
  2153.      Displays help for the notebook page. 
  2154.  
  2155.      The Help button on the notebook frame displays help for the overall 
  2156.      notebook. 
  2157.  
  2158. Note:  The lists of source and target types determine the order in which 
  2159.        actions are invoked to build the project's target when a Build action is 
  2160.        invoked, or when you use the MakeMake tool to explicitly create a make 
  2161.        file. To avoid unpredictable results from a Build action, do not list 
  2162.        file types or masks that do not apply to the action in the Source types 
  2163.        list. 
  2164.  
  2165. Related information 
  2166.  
  2167. o Background information about types and type classes 
  2168. o Type requirements for MakeMake 
  2169.  
  2170.  
  2171. ΓòÉΓòÉΓòÉ 4.3. Action notebook - Support page ΓòÉΓòÉΓòÉ
  2172.  
  2173. Use the Support page to specify the Actions Support DLL and any customized help 
  2174. for your action. 
  2175.  
  2176. Controls 
  2177.  
  2178. Customized help for action 
  2179.      You can specify context-sensitive help for an action using these entry 
  2180.      fields.  The help you specify here appears when you place focus on the 
  2181.      menu item for the action and press the F1 key. 
  2182.  
  2183. Command 
  2184.      This field contains the command that displays the help.  For example, if 
  2185.      the help is in an .INF file called HELP.INF, the command could be: 
  2186.  
  2187.              VIEW HELP.INF
  2188.  
  2189.      Because, with the IPF View facility, you can specify the name of a panel 
  2190.      in the .INF file to open the document to, the command could also be 
  2191.      specified as: 
  2192.  
  2193.              VIEW HELP.INF Some Help Topic
  2194.  
  2195. Topic 
  2196.      You can specify the help topic separately from the command by entering the 
  2197.      name of the topic in this field. The contents of this field are appended 
  2198.      to the text in the Command field, so you could also have specified the 
  2199.      command in the previous example as: 
  2200.  
  2201.              VIEW HELP.INF
  2202.  
  2203.      and specified the topic 
  2204.  
  2205.              Some Help Topic
  2206.      in the Topic field. 
  2207.  
  2208.      If the topic needs to be specified in a position other than at the end of 
  2209.      the command text, use the %TOPIC% substitution variable to place the text 
  2210.      in the Topic field anywhere in the Command text. 
  2211.  
  2212.      For example, some viewing tool has the following command syntax: 
  2213.  
  2214.              SOMEVIEW TOPIC='Some Help Topic' FILE='HELP.FIL'
  2215.  
  2216.      The Command text can then be specified as: 
  2217.  
  2218.              SOMEVIEW TOPIC=%TOPIC% FILE='HELP.FIL'
  2219.  
  2220.      If the %TOPIC% substition variable occurs more than once in the Command, 
  2221.      only the first instance is replaced. 
  2222.  
  2223. Action Support DLL 
  2224.      Each action has an associated Actions Support DLL that performs the 
  2225.      following very important functions: 
  2226.  
  2227.    o Sets the default option settings for an action. 
  2228.    o Displays a graphical user interface to gather the action options settings 
  2229.      when you request to change the options for an action. 
  2230.    o Generates the command line that correctly invokes the action with the 
  2231.      specified options. 
  2232.    o Processes the target and dependencies lists when the action is to be 
  2233.      included in a make file. 
  2234.    o If the action is monitored, parses selected error messages to correctly 
  2235.      invoke the default editor on the erroneous source file, and provides help 
  2236.      for any parsed error messages. 
  2237.    o If the action is an editor, enables the Dynamic Data Exchange (DDE) 
  2238.      communication with WorkFrame so that the editor displays source files and 
  2239.      processes the error lines correctly. 
  2240.  
  2241.      The Actions Support DLL is specified by two fields: 
  2242.  
  2243.    Name 
  2244.         The name of the Actions Support DLL, for example, IWFOPT, the default 
  2245.         Actions Support DLL. 
  2246.    Entrypoint 
  2247.         Because an Actions Support DLL can provide support for more than one 
  2248.         action, you must also specify an entrypoint.  The Entrypoint field is a 
  2249.         drop-down list box that shows all the available entrypoints in the DLL. 
  2250.  
  2251.      Actions Support DLLs are provided by tool developers who have integrated 
  2252.      their tools into the WorkFrame environment.  For tools that are not 
  2253.      WorkFrame enabled, WorkFrame provides a default Actions Support DLL called 
  2254.      IWFOPT.DLL, with entrypoints that apply to many action classes.  The 
  2255.      DEFAULT entrypoint is for actions whose class does not match any of the 
  2256.      provided entrypoints. 
  2257.  
  2258. Undo (on notebook page) 
  2259.      Restores the page to the same settings as when you opened the dialog. 
  2260.  
  2261.      The Undo pushbutton on the notebook frame undoes the changes for all 
  2262.      notebook pages. 
  2263.  
  2264. Default (on notebook page) 
  2265.      Restores the page to its default values. 
  2266.  
  2267.      The Default button on the notebook frame restores the default values for 
  2268.      all notebook pages. 
  2269.  
  2270. Help (on notebook page) 
  2271.      Displays help for the notebook page. 
  2272.  
  2273.      The Help button on the notebook frame displays help for the overall 
  2274.      notebook. 
  2275.  
  2276.  
  2277. ΓòÉΓòÉΓòÉ 4.4. Action notebook - Menus page ΓòÉΓòÉΓòÉ
  2278.  
  2279. Use this page to define whether the action is shown on particular menus and 
  2280. toolbars, and to define an accelerator key that allows you to run the action 
  2281. without using the menus. 
  2282.  
  2283. Controls 
  2284.  
  2285. Add to menus 
  2286.      Select this check box if you want to be able to execute the action 
  2287.      directly from popup menus and the Project and/or Selected pulldown menus. 
  2288.      You can deselect this check box if this action is only used as part of the 
  2289.      build process. 
  2290.  
  2291. Add to project options menu 
  2292.      Select this check box to list the action under the Options pulldown menu 
  2293.      in the project window. Selecting the action from this pulldown menu lets 
  2294.      you change action options without going through the Tools setup window. 
  2295.  
  2296. Add to project Toolbar 
  2297.      Select this check box to make the action available from the toolbar at the 
  2298.      top of the project window. Pressing the toolbar icon will execute the 
  2299.      action. This check box is only selectable for project-scoped actions. 
  2300.  
  2301. Ctrl+Shift+ 
  2302.      Enter an easy-to-remember character that you can use to run the action by 
  2303.      pressing a key combination. Press Ctrl+Shift+character to execute the 
  2304.      action. 
  2305.  
  2306.      You cannot use a character that is already an accelerator for another 
  2307.      action. These reserved characters are shown in the In use field. 
  2308.  
  2309. In use 
  2310.      This read-only field shows what characters are already used as 
  2311.      accelerators for other actions. 
  2312.  
  2313. Undo 
  2314.      Restores the page to the same settings as when you opened the dialog. 
  2315.  
  2316. Default 
  2317.      Restores the page to its default values. 
  2318.  
  2319.  
  2320. ΓòÉΓòÉΓòÉ 5. MakeMake window ΓòÉΓòÉΓòÉ
  2321.  
  2322. Use the MakeMake utility to create a make file. 
  2323.  
  2324. First, select the actions you want incorporated in the make file from the 
  2325. Actions list. 
  2326.  
  2327. Next, select which files you want used from the Source files list box. This 
  2328. listbox shows you which project files match the source masks specified for the 
  2329. selected actions. 
  2330.  
  2331. Ensure that files are selected for those actions that need to be performed 
  2332. first. 
  2333.  
  2334. When you have finished selecting the actions and files, select the Start 
  2335. pushbutton to begin generating the make file. If you want to halt processing, 
  2336. select Stop. Once the make file has been created, you can select the Change 
  2337. push button to view or modify it in the Results window. (You can force the 
  2338. Results to display automatically by selecting Always show make file from the 
  2339. Options menu.) 
  2340.  
  2341. If you change the files or actions associated with a project while the MakeMake 
  2342. utility is open, select the Refresh push button to update the Actions and 
  2343. Source files list boxes. 
  2344.  
  2345. Controls 
  2346.  
  2347. Actions 
  2348.      The list of file-scoped actions that have at least one source and at least 
  2349.      one target type defined. Select the actions that are needed, and they will 
  2350.      be incorporated into the make rules. 
  2351.  
  2352.      If you have multiple actions that use the same input file types, only 
  2353.      select one action for each file type. 
  2354.  
  2355.      If you want to select all or nearly all of the actions, you can select 
  2356.      Select all from the popup menu and deselect the ones you do not want. 
  2357.  
  2358. Source files 
  2359.      The list of files that can be used as input files for the selected 
  2360.      actions. The list is empty until you select one or more actions from the 
  2361.      previous list box. 
  2362.  
  2363.      Select or deselect items to include or omit particular files from the 
  2364.      build. The selected files are used to build the make dependency list. 
  2365.  
  2366.      If you want to select all or nearly all of the files, you can select 
  2367.      Select all from the popup menu and deselect the ones you do not want. 
  2368.  
  2369. Start 
  2370.      Generates an internal representation of the make file, creating make rules 
  2371.      and dependencies based on the selected actions and files. 
  2372.  
  2373.      To update the actual make file, select one of the "Save" choices under the 
  2374.      File menu. 
  2375.  
  2376. Stop 
  2377.      Interrupts the generation of the make file. Any existing make file is not 
  2378.      modified. 
  2379.  
  2380. Change 
  2381.      Displays another window in which you can change the make file, and 
  2382.      dependency file if applicable, before saving them. 
  2383.  
  2384. Refresh 
  2385.      Displays the lists of actions and files again, in case the project has 
  2386.      been updated while MakeMake is running. 
  2387.  
  2388. Menu-Bar Choices 
  2389.  
  2390. o File 
  2391. o Options 
  2392. o Help 
  2393.  
  2394. Related information 
  2395.  
  2396. o You can also run this utility from the command line. Enter IWFMMAKE /? 
  2397.   >filename for information about the command-line options. 
  2398. o MakeMake limitations 
  2399. o Selecting actions for Build and Make 
  2400.  
  2401.  
  2402. ΓòÉΓòÉΓòÉ 5.1. File ΓòÉΓòÉΓòÉ
  2403.  
  2404. Use this pulldown menu to perform open, save, and exit operations for the 
  2405. MakeMake program. 
  2406.  
  2407. Menu choices 
  2408.  
  2409. o Open project 
  2410. o Save makefile 
  2411. o Save and close 
  2412. o Exit 
  2413.  
  2414.  
  2415. ΓòÉΓòÉΓòÉ 5.1.1. Open project ΓòÉΓòÉΓòÉ
  2416.  
  2417. Selects a project for which to generate a make file, then reads the list of 
  2418. applicable actions and files from the project. 
  2419.  
  2420.  
  2421. ΓòÉΓòÉΓòÉ 5.1.2. Save makefile ΓòÉΓòÉΓòÉ
  2422.  
  2423. Saves the generated make file back into the project, overwriting any earlier 
  2424. version of the same file. If you do not save the make file before exiting from 
  2425. MakeMake, the updated make file information is lost. 
  2426.  
  2427.  
  2428. ΓòÉΓòÉΓòÉ 5.1.3. Save and close ΓòÉΓòÉΓòÉ
  2429.  
  2430. Provides a fast way to perform these two final operations when you are finished 
  2431. using MakeMake: 
  2432.  
  2433. o Save make file 
  2434. o Exit 
  2435.  
  2436.  
  2437. ΓòÉΓòÉΓòÉ 5.1.4. Exit ΓòÉΓòÉΓòÉ
  2438.  
  2439. Exits from the MakeMake program. 
  2440.  
  2441. Make sure to save the new or updated make file before selecting Exit. 
  2442.  
  2443.  
  2444. ΓòÉΓòÉΓòÉ 5.2. Options ΓòÉΓòÉΓòÉ
  2445.  
  2446. Use this pulldown menu to customize the display areas, generated make rules, 
  2447. and prompts for the MakeMake program. 
  2448.  
  2449. Menu choices 
  2450.  
  2451. o Swipe selection 
  2452. o Select new files 
  2453. o Always show make file 
  2454. o Depend on make file 
  2455. o Exit without verification 
  2456.  
  2457.  
  2458. ΓòÉΓòÉΓòÉ 5.2.1. Swipe selection ΓòÉΓòÉΓòÉ
  2459.  
  2460. Toggles whether the items listed in the list boxes can be selected and 
  2461. deselected individually, or if a range of items can be selected by selecting 
  2462. one item and dragging the mouse. 
  2463.  
  2464. When Swipe Selection is selected, use Ctrl+Mouse Button 1 to select or deselect 
  2465. multiple ranges of items. 
  2466.  
  2467.  
  2468. ΓòÉΓòÉΓòÉ 5.2.2. Select new files ΓòÉΓòÉΓòÉ
  2469.  
  2470. Toggles whether files are automatically selected as they are added to the 
  2471. Source files list box. 
  2472.  
  2473.  
  2474. ΓòÉΓòÉΓòÉ 5.2.3. Always show make file ΓòÉΓòÉΓòÉ
  2475.  
  2476. Toggles whether the make file and dependency file are automatically displayed 
  2477. after being generated, so that you can edit them before saving them. If this 
  2478. item is not selected, you can display the Results window by selecting the 
  2479. Change pushbutton. 
  2480.  
  2481.  
  2482. ΓòÉΓòÉΓòÉ 5.2.4. Depend on make file ΓòÉΓòÉΓòÉ
  2483.  
  2484. Toggles whether to add the make file as a dependency to each make rule, so that 
  2485. everything will be built again after the make file is changed. 
  2486.  
  2487.  
  2488. ΓòÉΓòÉΓòÉ 5.2.5. Exit without verification ΓòÉΓòÉΓòÉ
  2489.  
  2490. Toggles whether to display a confirmation prompt when you try to exit from the 
  2491. MakeMake utility. 
  2492.  
  2493.  
  2494. ΓòÉΓòÉΓòÉ 5.3. MakeMake - Results ΓòÉΓòÉΓòÉ
  2495.  
  2496. Use this window to view and alter the make file once it has been created and 
  2497. before it has been saved. 
  2498.  
  2499. If you chose to create a separate dependencies file, a second page appears 
  2500. behind the make file page. You can edit the dependencies file in the same 
  2501. manner as you edit the make file. 
  2502.  
  2503. To edit the make file: 
  2504.  
  2505.  1. Scroll to the area you want to change. (By selecting one of the targets in 
  2506.     the Targets list, you can automatically scroll to the statements describing 
  2507.     how to build that target.) 
  2508.  
  2509.     Note:  If you insert or delete lines, selecting a target may no longer take 
  2510.            you to the correct line in the make file. 
  2511.  
  2512.  2. The Make file list box acts as a simple text editor. To edit the make file, 
  2513.     move the cursor to the area you want to change and start typing. Remember, 
  2514.     any editing changes you make will not be reflected if the MakeMake tool is 
  2515.     used to replace the make file later. 
  2516.  
  2517.  3. Close this window after you have finished making the changes. 
  2518.  
  2519. Since the MakeMake utility creates an ASCII file, you can also modify the file 
  2520. with an editor. 
  2521.  
  2522. Warning: Any changes you make (within the MakeMake Results window or an editor) 
  2523. will not be restored the next time you use the MakeMake utility to replace the 
  2524. make file. 
  2525.  
  2526. If you decide to undo all the changes you made to the make file after the 
  2527. MakeMake Results window was opened, select the Reset push button. 
  2528.  
  2529. Controls 
  2530.  
  2531. Targets produced 
  2532.      Shows the names of all the targets in the make file. Select a target to 
  2533.      display the part of the make file that defines it. 
  2534.  
  2535. Make and dependency file notebook 
  2536.      Shows the contents of the make file, and the dependency file if one was 
  2537.      created, in a notebook dialog. You can edit the contents of these files by 
  2538.      changing the text in the notebook. 
  2539.  
  2540. Reset 
  2541.      Removes any changes you have made to the generated files. 
  2542.  
  2543.  
  2544. ΓòÉΓòÉΓòÉ <hidden> Select all ΓòÉΓòÉΓòÉ
  2545.  
  2546. Selects all the items in the list box. 
  2547.  
  2548.  
  2549. ΓòÉΓòÉΓòÉ <hidden> Deselect all ΓòÉΓòÉΓòÉ
  2550.  
  2551. Deselects all the items in the list box. 
  2552.  
  2553.  
  2554. ΓòÉΓòÉΓòÉ <hidden> Actions Support DLL (IWFOPT.DLL) Entrypoints ΓòÉΓòÉΓòÉ
  2555.  
  2556. The default actions support DLL (IWFOPT.DLL) supplied with WorkFrame contains 
  2557. support entrypoints for many common actions. The entrypoint defines the options 
  2558. dialog to be used and how the action is used within a make file. 
  2559.  
  2560. The following list describes the purpose of the entrypoints not specifically 
  2561. related to the IBM Developer's Toolkit: 
  2562.  
  2563. COMPILE   Use for compilers that do not supply their own actions support DLL. 
  2564.  
  2565. DEBUG     Use for debuggers. 
  2566.  
  2567. DEFAULT   Use for actions that do not fit into any other category of 
  2568.           entrypoint. 
  2569.  
  2570. EDIT      Use for editors. 
  2571.  
  2572. LIB       Use for a library utility. 
  2573.  
  2574. LINK      Use with the LINK386 linker. This is an older OS/2 linker that you 
  2575.           may still be using with existing projects. 
  2576.  
  2577. MAKE      Use with make utilities such as NMAKE. 
  2578.  
  2579. RUN       Use when you simply need to run the selected file or files. 
  2580.  
  2581. The following entrypoints are used with the IBM Developer's Toolkit tools: 
  2582.  
  2583. IMPLIB    Use for the Import Library utility. 
  2584.  
  2585. IPF_COMPILE Use for the Information Presentation Facility compiler. 
  2586.  
  2587. MESSAGE_BIND Use with the message binding utility. 
  2588.  
  2589. MESSAGE_COMPILE Use with the message compiler. 
  2590.  
  2591. MSGBIND_PLUS Use with the special message binding utility. 
  2592.  
  2593. RESOURCE_BIND Use when binding resources to an executable file or dynamic link 
  2594.           library. 
  2595.  
  2596. RESOURCE_COMPILE Use with the resource compiler. 
  2597.  
  2598.  
  2599. ΓòÉΓòÉΓòÉ <hidden> Default Link Options ΓòÉΓòÉΓòÉ
  2600.  
  2601. The default link options interface is provided by WorkFrame to let programmers 
  2602. set options for the LINK386.EXE linker through a graphical user interface. 
  2603.  
  2604. The help for each option describes its equivalent command line version. 
  2605.  
  2606. This interface is intended to be used only for the LINK386 linker. Other 
  2607. linkers should use the DEFAULT entrypoint. 
  2608.  
  2609. Related information 
  2610.  
  2611. o Entrypoints in IWFOPT.DLL 
  2612.  
  2613.  
  2614. ΓòÉΓòÉΓòÉ <hidden> Generation Options (Pages 1 and 2) ΓòÉΓòÉΓòÉ
  2615.  
  2616. Use these pages to control the format and content of the executable file 
  2617. produced by the linker. 
  2618.  
  2619. For more information, select one of the following items: 
  2620.  
  2621. o Page 1: 
  2622.  
  2623. o Include Debug Information (/CO[DEVIEW]) 
  2624.  
  2625. o Optimize Intrasegment Far Calls (/F[ARCALLTRANSLATION] or 
  2626.   /NOF[ARCALLTRANSLATION]) 
  2627.  
  2628. o Sort Segments (/DO[SSEG]) 
  2629.  
  2630. o Sort Segments But Do Not Add 16-byte NULL Region (/NON[ULLSDOSSEG]) 
  2631.  
  2632. o Application Type (/PM[TYPE]:parameter) 
  2633.  
  2634. o Pack The Code Segments (and Size) (/P[ACKCODE][:number]  or /NOP[ACKCODE]) 
  2635.  
  2636. o Page 2: 
  2637.  
  2638. o Pack the Data Segments (and Size) (/PACKD[ATA][:number]) 
  2639.  
  2640. o Maximum Number of Segments (/SE[GMENTS]:number) 
  2641.  
  2642. o Stack Size (/ST[ACK]:number) 
  2643.  
  2644. o Module Load Address (/BAS[E]:number) 
  2645.  
  2646. o Segment Alignment (/A[LIGNMENT]:number). 
  2647.  
  2648. o Compress repeated data (/E[XEPACK]). 
  2649.  
  2650.  
  2651. ΓòÉΓòÉΓòÉ <hidden> Compress repeated data ΓòÉΓòÉΓòÉ
  2652.  
  2653. Select this option to compress repeated data in the file. The OS/2 Applications 
  2654. Loader will automatically decompress the data when the program is run. 
  2655.  
  2656. The corresponding command line option is /E[XEPACK]. 
  2657.  
  2658.  
  2659. ΓòÉΓòÉΓòÉ <hidden> Include Debug Information ΓòÉΓòÉΓòÉ
  2660.  
  2661. If you are going to debug your application, select this option to copy the 
  2662. debug information from the objects into the module. 
  2663.  
  2664. The corresponding command line option is /CO[DEVIEW]. 
  2665.  
  2666.  
  2667. ΓòÉΓòÉΓòÉ <hidden> Optimize Intrasegment Far Calls ΓòÉΓòÉΓòÉ
  2668.  
  2669. Select this option to optimize far calls by converting them to near calls if 
  2670. possible. Do not use this option if data in the program could appear to the 
  2671. linker as far calls. 
  2672.  
  2673. The corresponding command line option is /F[ARCALLTRANSLATION]. 
  2674. /NOF[ARCALLTRANSLATION] does not optimize the far calls and is the default. 
  2675.  
  2676.  
  2677. ΓòÉΓòÉΓòÉ <hidden> Sort Segments ΓòÉΓòÉΓòÉ
  2678.  
  2679. Select this option to force segments to be ordered as follows (first to last): 
  2680.  
  2681.  1. All code segments 
  2682.  
  2683.  2. Far data segments 
  2684.  
  2685.  3. Near data (DGROUP) segments, in the following order: 
  2686.  
  2687.     a. Any segments of class BEGDATA (this class name is reserved) 
  2688.     b. Any segments not of class BEGDATA, BSS, or STACK 
  2689.     c. Segments of class BSS 
  2690.     d. Segments of class STACK 
  2691. This option also initializes two special variables: _edata is initialized to 
  2692. DGROUP :BSS and _end is initialized to DGROUP : STACK. These variables have 
  2693. special meanings for some compilers so you should avoid using them in your 
  2694. programs. Assembly-language programs can refer to _edata and _end but not 
  2695. modify them. 
  2696.  
  2697. If the _TEXT segment is defined, 16 NULL bytes are added to the beginning of 
  2698. it. 
  2699.  
  2700. The corresponding command line option is /DO[SSEG]. 
  2701.  
  2702.  
  2703. ΓòÉΓòÉΓòÉ <hidden> Sort Segments But Do Not Add 16-byte NULL Region ΓòÉΓòÉΓòÉ
  2704.  
  2705. Select this option to write the segments to the module in the order detailed in 
  2706. the Sort Segments help. 
  2707.  
  2708. Unlike Sort Segments, it does not add 16 NULL bytes to the beginning of the 
  2709. code segment. 
  2710.  
  2711. Note:  Do not select this option if the program is being linked with libraries 
  2712.        that require the NULL bytes region. 
  2713.  
  2714. The corresponding command line option is /NON[ULLSDOSSEG]. 
  2715.  
  2716.  
  2717. ΓòÉΓòÉΓòÉ <hidden> Pack The Code Segments (and Size) ΓòÉΓòÉΓòÉ
  2718.  
  2719. Select Pack the code segment to concatenate the code segments when building the 
  2720. module. 
  2721.  
  2722. If the Pack the code segment check box is selected, you can use the Size entry 
  2723. field to specify the maximum size of each of the concatenated code segments in 
  2724. the module. The size must be in one of the following formats: 
  2725.  
  2726. o Hexadecimal (prefixed by 0x as in 0x2D7) 
  2727.  
  2728. o Octal (prefixed by zero as in 027) 
  2729.  
  2730. o Decimal (cannot start with zero as in 27). 
  2731.  
  2732. For 16-bit code, the size can be from zero to 65500 and the default value is 
  2733. 65500. 
  2734.  
  2735. For 32-bit code, the size can be from zero to 4294967295 and the default value 
  2736. is 4294967295. 
  2737.  
  2738. The corresponding command line options are: 
  2739.  
  2740. /PACKC[ODE] (the default) 
  2741.           If the Pack the code segment is selected. /NOP[ACKCODE] causes the 
  2742.           linker to not pack the code. 
  2743.  
  2744. /PACKC[ODE]:number 
  2745.           If a number is entered in the Size field. 
  2746.  
  2747.  
  2748. ΓòÉΓòÉΓòÉ <hidden> Pack the Data Segments (and Size) ΓòÉΓòÉΓòÉ
  2749.  
  2750. Select Pack neighboring logical data to concatenate the data segments together 
  2751. when building the module. 
  2752.  
  2753. If the Pack neighboring logical data check box is selected, you can use the 
  2754. Size entry field to specify the maximum size of each of the concatenated data 
  2755. segments in the module. The size must be in one of the following formats: 
  2756.  
  2757. o Hexadecimal (prefixed by 0x as in 0x2D7) 
  2758.  
  2759. o Octal (prefixed by zero as in 027) 
  2760.  
  2761. o Decimal (cannot start with zero as in 27). 
  2762.  
  2763. For 16-bit code, the size can be from zero to 65536 and the default value is 
  2764. 65536. 
  2765.  
  2766. For 32-bit code, the size can be from zero to 4294967295 and the default value 
  2767. is 4294967295. 
  2768.  
  2769. The corresponding command line options are: 
  2770.  
  2771. /PACKD[ATA] (the default) 
  2772.           If the Pack neighboring logical data is selected. 
  2773.  
  2774. /PACKD[ATA]:number 
  2775.           If a number is entered in the Size field. 
  2776.  
  2777.  
  2778. ΓòÉΓòÉΓòÉ <hidden> Maximum Number of Segments ΓòÉΓòÉΓòÉ
  2779.  
  2780. Specify the maximum number of segments that is to be allowed in the module. The 
  2781. number must be in the range from zero to 3072 (for the LINK.EXE linker) or zero 
  2782. to 16375 (for the LINK386.EXE linker). You can use any of the following 
  2783. formats: 
  2784.  
  2785. o Hexadecimal (prefixed by 0x as in 0x2D7) 
  2786.  
  2787. o Octal (prefixed by zero as in 027) 
  2788.  
  2789. o Decimal (cannot start with zero as in 27). 
  2790. The default value for the LINK.EXE linker is 128. There is no default value for 
  2791. the LINK386.EXE linker. 
  2792.  
  2793. The corresponding command line option is /SE[GMENTS]:number. 
  2794.  
  2795.  
  2796. ΓòÉΓòÉΓòÉ <hidden> Stack Size ΓòÉΓòÉΓòÉ
  2797.  
  2798. Specify the size of the stack to be used by the module. The size must be in the 
  2799. range from zero to 65535 (for 16-bit code) or zero to 4294967295 (for 32-bit 
  2800. code). You can use any of the following formats: 
  2801.  
  2802. o Hexadecimal (prefixed by 0x as in 0x2D7) 
  2803.  
  2804. o Octal (prefixed by zero as in 027) 
  2805.  
  2806. o Decimal (cannot start with zero as in 27). 
  2807. The default value is found within the object modules. 
  2808.  
  2809. The corresponding command line option is /ST[ACK]:number. 
  2810.  
  2811.  
  2812. ΓòÉΓòÉΓòÉ <hidden> Module Load Address ΓòÉΓòÉΓòÉ
  2813.  
  2814. Use this option to specify the address that the module will be loaded at if the 
  2815. address space is not being used by other code. You can use this option for both 
  2816. executable files and dynamic link libraries. 
  2817.  
  2818. You can use any of the following formats: 
  2819.  
  2820. o Hexadecimal (prefixed by 0x as in 0x2D7) 
  2821.  
  2822. o Octal (prefixed by zero as in 027) 
  2823.  
  2824. o Decimal (cannot start with zero as in 27). 
  2825.  
  2826. The corresponding command line option is /BAS[E]:number. 
  2827.  
  2828.  
  2829. ΓòÉΓòÉΓòÉ <hidden> Segment Alignment ΓòÉΓòÉΓòÉ
  2830.  
  2831. Specify the segment alignment factor (in bytes) in the executable file. The 
  2832. default value is 512 for 16-bit code and 4096 for 32-bit code. 
  2833.  
  2834. The corresponding command line option is /A[LIGNMENT]:number. 
  2835.  
  2836.  
  2837. ΓòÉΓòÉΓòÉ <hidden> Application Type ΓòÉΓòÉΓòÉ
  2838.  
  2839. Select one of these radio buttons to specify the type of program to be built by 
  2840. the linker. 
  2841.  
  2842. Select None if you do not want the linker to set the type of program. The 
  2843. program itself will determine what kind of program it is. 
  2844.  
  2845. Select the PM radio button to specify to the linker that the file to be built 
  2846. is a Presentation Manager program and is to be run in a window. The 
  2847. corresponding command line option is /PM[TYPE]:PM. 
  2848.  
  2849. Select Window to specify to the linker that the program can run in a window but 
  2850. is not a Presentation Manager program. The corresponding command line option is 
  2851. /PM[TYPE]:VIO. 
  2852.  
  2853. Select Full screen to specify to the linker that the program can only run in 
  2854. full screen mode. The corresponding command line option is /PM[TYPE]:NOVIO. 
  2855.  
  2856.  
  2857. ΓòÉΓòÉΓòÉ <hidden> Processing Options ΓòÉΓòÉΓòÉ
  2858.  
  2859. The options that appear on this window specify to the linker how to build the 
  2860. executable file. 
  2861.  
  2862. They are: 
  2863.  
  2864. o Display the Logo (/NOL[OGO]) 
  2865.  
  2866. o Search the Extended Dictionary (/NOE[XTDICTIONARY]) 
  2867.  
  2868. o Display Link-time Information (/INF[ORMATION]) 
  2869.  
  2870. o Run Linker in Batch Mode (/BA[TCH]) 
  2871.  
  2872. o Respect Case in Symbol Names (/NOI[GNORECASE]) 
  2873.  
  2874. o Copy Source Line Numbers to Map File (/LI[NENUMBERS]) 
  2875.  
  2876. o Generate Warnings for Fixups (/W[ARNFIXUP]) 
  2877.  
  2878. o Ignore Default Libraries (and Particular Libraries to Ignore) 
  2879.   (/NOD[EFAULTLIBRARYSEARCH][:libname]) 
  2880.  
  2881. o Map File (and Maximum Number Of Entries) (/M[AP][:parameter]). 
  2882.  
  2883.  
  2884. ΓòÉΓòÉΓòÉ <hidden> Display the Logo ΓòÉΓòÉΓòÉ
  2885.  
  2886. Choose whether or not to display the name, version, and copyright information 
  2887. of the linker. 
  2888.  
  2889. The corresponding command line option is (/NOL[OGO]). 
  2890.  
  2891.  
  2892. ΓòÉΓòÉΓòÉ <hidden> Search the Extended Dictionary ΓòÉΓòÉΓòÉ
  2893.  
  2894. Select this option to ignore the extended library information (if it exists) 
  2895. found in the library. 
  2896.  
  2897. The corresponding command line option is /NOE[XTDICTIONARY]. 
  2898.  
  2899.  
  2900. ΓòÉΓòÉΓòÉ <hidden> Display Link-time Information ΓòÉΓòÉΓòÉ
  2901.  
  2902. Select this option to display messages as it creates the executable file. 
  2903.  
  2904. The corresponding command line option is /INF[ORMATION]. 
  2905.  
  2906.  
  2907. ΓòÉΓòÉΓòÉ <hidden> Run Linker in Batch Mode ΓòÉΓòÉΓòÉ
  2908.  
  2909. This option causes warning or error messages when a library cannot be found 
  2910. instead of prompting the user for a new path to the library. 
  2911.  
  2912. The corresponding command line option is /BA[TCH]. 
  2913.  
  2914.  
  2915. ΓòÉΓòÉΓòÉ <hidden> Respect Case in Symbol Names ΓòÉΓòÉΓòÉ
  2916.  
  2917. Select this option to respect the case of external definitions when trying to 
  2918. resolve external references. 
  2919.  
  2920. The corresponding command line option is /NOI[GNORECASE]. 
  2921.  
  2922.  
  2923. ΓòÉΓòÉΓòÉ <hidden> Generate Warnings for Fixups ΓòÉΓòÉΓòÉ
  2924.  
  2925. This option causes a message to be produced for each fixup found or generated 
  2926. in the module. 
  2927.  
  2928. The corresponding command line option is /W[ARNFIXUP]. 
  2929.  
  2930.  
  2931. ΓòÉΓòÉΓòÉ <hidden> Ignore Default Libraries (and Particular Libraries to Ignore) ΓòÉΓòÉΓòÉ
  2932.  
  2933. Select Ignore default library search to specify that the linker should not 
  2934. search the default libraries named within the object modules. 
  2935.  
  2936. If only certain default libraries should be ignored, you can enter their names 
  2937. in the Particular libraries to ignore field if the Ignore default library 
  2938. search check box is selected. 
  2939.  
  2940. Note:  If you are specifying more than one library, enter one per line. 
  2941.  
  2942. The corresponding command line options are: 
  2943.  
  2944. /NOD[EFAULTLIBRARYSEARCH] 
  2945.           To ignore all the default libraries named in the object modules. 
  2946.  
  2947. /NOD[EFAULTLIBRARYSEARCH]:libname 
  2948.           For each particular library to be ignored. 
  2949.  
  2950.  
  2951. ΓòÉΓòÉΓòÉ <hidden> Map File (and Maximum Number Of Entries) ΓòÉΓòÉΓòÉ
  2952.  
  2953. Use the None, Regular, and Full radio buttons to specify the content of the map 
  2954. file: 
  2955.  
  2956. None 
  2957.           Do not create a map file. 
  2958.  
  2959. Regular 
  2960.           Show offsets of all the external symbols that appear in the module. 
  2961.  
  2962. Full 
  2963.           Include information about how the references are resolved as well as 
  2964.           showing the offsets of all external symbols. Select Full only if you 
  2965.           are using the LINK386.EXE linker. 
  2966.  
  2967. If you selected Regular and are using the LINK.EXE linker, you can use the 
  2968. Maximum number of entries field to specify the number of external symbols that 
  2969. the linker should be able to handle. If the linker produces a message 
  2970. indicating the map symbol limit is too high, reduce the limit until the message 
  2971. stops appearing. The number must be in the range 1 to 32767 in one of the 
  2972. following formats: 
  2973.  
  2974. o Hexadecimal (prefixed by 0x as in 0x2D7) 
  2975.  
  2976. o Octal (prefixed by zero as in 027) 
  2977.  
  2978. o Decimal (cannot start with zero as in 27). 
  2979. The default value is 2048. 
  2980.  
  2981. The corresponding command line options are: 
  2982.  
  2983. /M[AP] 
  2984.           If Regular is selected and a maximum number of entries is not 
  2985.           specified. 
  2986.  
  2987. /M[AP]:number 
  2988.           If Regular is selected and a maximum number of entries is specified. 
  2989.  
  2990. /M[AP]:FULL 
  2991.           If Full is selected. 
  2992.  
  2993.  
  2994. ΓòÉΓòÉΓòÉ <hidden> Copy Source Line Numbers to Map File ΓòÉΓòÉΓòÉ
  2995.  
  2996. Select this option to include line number information in the map file 
  2997. generated. 
  2998.  
  2999. The corresponding command line option is /LI[NENUMBERS]. 
  3000.  
  3001.  
  3002. ΓòÉΓòÉΓòÉ <hidden> Map File Name ΓòÉΓòÉΓòÉ
  3003.  
  3004. Enter the name of the map file to be produced. If one is not specified, no map 
  3005. file will be produced unless either Regular or Full was selected. If no 
  3006. extension is specified, the linker assumes the extension is MAP. 
  3007.  
  3008.  
  3009. ΓòÉΓòÉΓòÉ <hidden> File Name Options ΓòÉΓòÉΓòÉ
  3010.  
  3011. This page lets you specify the names of the following files: 
  3012.  
  3013. Generated Executable File Name 
  3014.           The name of the module file. 
  3015.  
  3016. Libraries To Use 
  3017.           The names or paths of any libraries to be used for resolving external 
  3018.           references. You can also specify paths to be searched for the 
  3019.           required libraries. 
  3020.  
  3021. Definition File Name 
  3022.           The name of the definition file used to build the module. 
  3023.  
  3024.  
  3025. ΓòÉΓòÉΓòÉ <hidden> Generated Executable File Name ΓòÉΓòÉΓòÉ
  3026.  
  3027. Enter the name of the module file to be produced. If a name is not specified, 
  3028. the linker uses the file name of the first object passed to it and adds an 
  3029. extension of either EXE or DLL as appropriate. If a name is specified without 
  3030. an extension, the linker assumes the extension is either EXE or DLL. 
  3031.  
  3032.  
  3033. ΓòÉΓòÉΓòÉ <hidden> Libraries to Use ΓòÉΓòÉΓòÉ
  3034.  
  3035. Enter the names of the libraries, one per line, to be searched when the linker 
  3036. tries to resolve the external references found in the objects it is linking. If 
  3037. no extension is specified in a library name, the linker assumes the extension 
  3038. is LIB. The linker searches these libraries before those specified in the 
  3039. objects themselves. 
  3040.  
  3041. You can also specify paths to be searched for the required libraries. Any paths 
  3042. you specify will be searched before those in the LIB environment variable. 
  3043.  
  3044.  
  3045. ΓòÉΓòÉΓòÉ <hidden> Definition File Name ΓòÉΓòÉΓòÉ
  3046.  
  3047. Enter the name of the definition file used to build the module. If no extension 
  3048. is specified, the linker assumes the extension is DEF. 
  3049.  
  3050.  
  3051. ΓòÉΓòÉΓòÉ <hidden> WorkFrame Default Options Dialog ΓòÉΓòÉΓòÉ
  3052.  
  3053. Use this dialog to define the command-line parameters to be passed to a tool 
  3054. when it is executed. 
  3055.  
  3056. For certain actions that produce error messages, you can also define error 
  3057. templates so that WorkFrame can recognize error messages and determine what 
  3058. file to edit to fix the error. 
  3059.  
  3060. Depending on the scope setting for the action, you may be able to specify 
  3061. options for the file-scoped form of the action, the project-scoped form, or 
  3062. both. 
  3063.  
  3064. The different variations in the controls of this dialog come from the different 
  3065. entrypoints in the IWFOPT actions support DLL, which you specify in the action 
  3066. settings notebook. Actions that use support DLLs other than the WorkFrame 
  3067. default might provide different dialogs to set action options. 
  3068.  
  3069. Controls 
  3070.  
  3071. Parameters 
  3072.      Fill in a string that represents the command-line parameters to pass to 
  3073.      the tool. You can represent variable items, such as file names, using 
  3074.      substitution variables. 
  3075.  
  3076. Error template(not always present) 
  3077.      Fill in a string that represents the format of an error message. You will 
  3078.      be able to launch an editor from the monitor window by double-clicking on 
  3079.      the error message. You can represent the information needed to locate the 
  3080.      error using a set of substitution variables (different than the ones in 
  3081.      the Parameters field). 
  3082.  
  3083. Send errors to editor(not always present) 
  3084.      This check box only applies to Edit actions. Select it if the editor 
  3085.      supports Dynamic Data Exchange (DDE), so that requests to edit a 
  3086.      particular file or location can be transmitted to a running editor 
  3087.      session. 
  3088.  
  3089. Prompt 
  3090.      Select this check box if you want to enter the options string 
  3091.      interactively, when the action is executed. Options entered in response to 
  3092.      the prompt override the options specified in the Parameters field. 
  3093.  
  3094. Undo (on notebook page) 
  3095.      Restores the page to the same settings as when you opened the dialog. 
  3096.  
  3097.      The Undo pushbutton on the notebook frame undoes the changes for all 
  3098.      notebook pages. 
  3099.  
  3100. Default (on notebook page) 
  3101.      Restores the page to its default values. 
  3102.  
  3103.      The Default button on the notebook frame restores the default values for 
  3104.      all notebook pages. 
  3105.  
  3106. Help (on notebook page) 
  3107.      Displays help for the notebook page. 
  3108.  
  3109.      The Help button on the notebook frame displays help for the overall 
  3110.      notebook. 
  3111.  
  3112. OK (in notebook frame) 
  3113.      Closes the dialog and saves all the settings. Close the dialog with this 
  3114.      pushbutton rather than with the System menu to preserve any changes you 
  3115.      have made. 
  3116.  
  3117. Undo or Reset (in notebook frame) 
  3118.      Restores all pages to the same settings as when you opened the dialog. 
  3119.  
  3120. Default (in notebook frame) 
  3121.      Restores all pages to their default values. 
  3122.  
  3123. Cancel (in notebook frame) 
  3124.      Exits without performing the operation or saving data. Closing this dialog 
  3125.      using the System menu has the same effect:  changes are not saved. 
  3126.  
  3127. Help (in notebook frame) 
  3128.      Displays help for the overall dialog. The Help button on each page 
  3129.      displays help for that page. 
  3130.  
  3131. Related information 
  3132.  
  3133. o Entrypoints in IWFOPT.DLL 
  3134. o Substitution variables for option strings 
  3135. o Substitution variables for error templates 
  3136.  
  3137.  
  3138. ΓòÉΓòÉΓòÉ <hidden> Substitution variables for option strings ΓòÉΓòÉΓòÉ
  3139.  
  3140. Typically, you will use substitution variables in the options string to refer 
  3141. to variable items, such as file names. The substitution variables you can use 
  3142. are: 
  3143.  
  3144.            Γöé
  3145.  %a %z     ΓöéIs replaced by the names of all the selected files,
  3146.            Γöéseparated by a space.  If the space between the 'a' and the
  3147.            Γöé'%' is replaced by a string, the names are separated by that
  3148.            Γöéstring. For example, if the selected files are d:\cat.obj,
  3149.            Γöéd:\dog.obj and d:\bird.obj the substitution variable %a+%z
  3150.            Γöéproduces the string
  3151.            Γöé    d:\cat.obj+d:\dog.obj+d:\bird.obj
  3152.            ΓöéThe only substitution variables allowed within the %a %z
  3153.            Γöésubstitution variables are %% and %d.
  3154.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3155.  %d        ΓöéIs replaced with the project's working directory.
  3156.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3157.  %e        ΓöéIs replaced by the extension (including the period) of the
  3158.            Γöéfirst selected file.
  3159.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3160.  %f        ΓöéIs replaced with the fully qualified name of the first
  3161.            Γöéselected file. Specifying %f is the same as specifying
  3162.            Γöé%q%n%e.
  3163.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3164.  %m        ΓöéIs replaced by the make file name specified for the project
  3165.            Γöéin its Settings notebook.
  3166.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3167.  %n        ΓöéIs replaced by the file name (without an extension and path)
  3168.            Γöéof the first selected file.
  3169.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3170.  %o        ΓöéIs replaced by the target file name specified for the
  3171.            Γöéproject in its Settings notebook.
  3172.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3173.  %p        ΓöéIs replaced by the fully qualified project file name.
  3174.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3175.  %q        ΓöéIs replaced by the path of the first selected file.
  3176.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3177.  %r        ΓöéIs replaced by the run options set for the project target
  3178.            Γöéfile in the project's Settings notebook.
  3179.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3180.  %t        ΓöéIs replaced by the fully qualified file name (without an
  3181.            Γöéextension) of the project's target.
  3182.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3183.  %TOPIC%   ΓöéIs replaced by the contents of the Help Topic field in the
  3184.            Γöéaction's Settings notebook.  This field specified the help
  3185.            Γöétopic to be displayed when the user requests help on the
  3186.            Γöéaction.
  3187.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3188.  %%        ΓöéIs replaced by the % symbol.
  3189.            Γöé
  3190.  
  3191. Related information 
  3192.  
  3193. o Substitution variables for error templates 
  3194.  
  3195.  
  3196. ΓòÉΓòÉΓòÉ <hidden> Substitution variables for error templates ΓòÉΓòÉΓòÉ
  3197.  
  3198. The substitution variables in the table below are used to specify error message 
  3199. format in error templates.  WorkFrame uses error templates to parse error 
  3200. messages in a monitor window when you double-click on an error message to 
  3201. invoke the editor. 
  3202.  
  3203.            Γöé
  3204.  %f        ΓöéIs replaced by the name of the file name where the error
  3205.            Γöéoccurred. If the error message does not emit a
  3206.            Γöéfully-qualified file name, the editor may not be able load
  3207.            Γöéthe file if it is not located in the project's Working
  3208.            Γöédirectory.
  3209.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3210.  %i        ΓöéThe line in the source file at which the error occurred.
  3211.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3212.  %c        ΓöéThe column in the source file at which the error occurred.
  3213.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  3214.  %t        ΓöéThe text of the error message.
  3215.            Γöé
  3216.  
  3217. Related information 
  3218.  
  3219. o Substitution variables for option strings 
  3220.  
  3221.  
  3222. ΓòÉΓòÉΓòÉ <hidden> Lib tool options ΓòÉΓòÉΓòÉ
  3223.  
  3224. Use the options on this page to specify the options for the command line 
  3225. Library Manager (LIB.EXE). 
  3226.  
  3227. Controls 
  3228.  
  3229. Display the logo 
  3230.           Is equivalent to not using the /NO[LOGO] option. 
  3231.  
  3232. Respect case of names 
  3233.           Is equivalent to using the /NOI[GNORECASE] option. 
  3234.  
  3235. Create the extended dictionary 
  3236.           Is equivalent to not using the /NOE[XTDICTIONARY] option. 
  3237.  
  3238. Set page size 
  3239.           Is equivalent to the /P[AGESIZE] option. 
  3240.  
  3241. Set listing level 
  3242.           Is equivalent to the /L[ISTLEVEL] option. 
  3243.  
  3244. List file name 
  3245.           Is equivalent to specifying the name of the listing file on the 
  3246.           command line. 
  3247.  
  3248. Library file name 
  3249.           Is equivalent to specifying the name of the library file on the 
  3250.           command line. The %o substitution variable represents the target file 
  3251.           name specified on the Target page of the project's Settings notebook. 
  3252.  
  3253. OK (in notebook frame) 
  3254.           Closes the dialog and saves all the settings. Close the dialog with 
  3255.           this pushbutton rather than with the System menu to preserve any 
  3256.           changes you have made. 
  3257.  
  3258. Undo or Reset (in notebook frame) 
  3259.           Restores all pages to the same settings as when you opened the 
  3260.           dialog. 
  3261.  
  3262. Default (in notebook frame) 
  3263.           Restores all pages to their default values. 
  3264.  
  3265. Cancel (in notebook frame) 
  3266.           Exits without performing the operation or saving data. Closing this 
  3267.           dialog using the System menu has the same effect:  changes are not 
  3268.           saved. 
  3269.  
  3270. Help (in notebook frame) 
  3271.           Displays help for the overall dialog. The Help button on each page 
  3272.           displays help for that page. 
  3273.  
  3274.  
  3275. ΓòÉΓòÉΓòÉ <hidden> Build Options ΓòÉΓòÉΓòÉ
  3276.  
  3277.  
  3278. ΓòÉΓòÉΓòÉ 6. Build Options ΓòÉΓòÉΓòÉ
  3279.  
  3280. Use this notebook to set the options used by a Build action. You can customize 
  3281. the build for speed, efficiency, convenience, and single-user or team 
  3282. development. 
  3283.  
  3284. Pages 
  3285.  
  3286. o Actions 
  3287. o Make 
  3288. o Project 
  3289. o Display 
  3290.  
  3291. Controls 
  3292.  
  3293. OK (in notebook frame) 
  3294.      Closes the dialog and saves all the settings. Close the dialog with this 
  3295.      pushbutton rather than with the System menu to preserve any changes you 
  3296.      have made. 
  3297.  
  3298. Undo or Reset (in notebook frame) 
  3299.      Restores all pages to the same settings as when you opened the dialog. 
  3300.  
  3301. Default (in notebook frame) 
  3302.      Restores all pages to their default values. 
  3303.  
  3304. Cancel (in notebook frame) 
  3305.      Exits without performing the operation or saving data. Closing this dialog 
  3306.      using the System menu has the same effect:  changes are not saved. 
  3307.  
  3308. Help (in notebook frame) 
  3309.      Displays help for the overall dialog. The Help button on each page 
  3310.      displays help for that page. 
  3311.  
  3312. Related information 
  3313.  
  3314. o You can also run this utility from the command line. Enter IWFBUILD /? for 
  3315.   information about the command-line options. 
  3316. o Background information about the Build utility 
  3317.  
  3318.  
  3319. ΓòÉΓòÉΓòÉ 6.1. Actions ΓòÉΓòÉΓòÉ
  3320.  
  3321. The settings on this page determine which of the actions in the project are 
  3322. processed by the build action. You can do partial builds by omitting some 
  3323. actions. 
  3324.  
  3325. The choices here override the similar choices you can make in the MakeMake 
  3326. utility. 
  3327.  
  3328. The actions that are listed on this page are those that are file-scoped and 
  3329. have at least one source type and at least one target type specified. These 
  3330. types are used by MakeMake to determine the order in which the actions are to 
  3331. be executed. 
  3332.  
  3333. Controls 
  3334.  
  3335. MakeMake 
  3336.      Runs the MakeMake utility to produce a new make file separately from this 
  3337.      dialog. 
  3338.  
  3339. Reset 
  3340.      Restores the page to the same settings as when you opened the dialog. 
  3341.  
  3342. Default 
  3343.      Restores the page to its default values. 
  3344.  
  3345. Help 
  3346.      Displays this help panel. 
  3347.  
  3348. Related information 
  3349.  
  3350. o Selecting actions for Build and Make 
  3351.  
  3352.  
  3353. ΓòÉΓòÉΓòÉ 6.2. Make ΓòÉΓòÉΓòÉ
  3354.  
  3355. The settings on this page determine how the Build action generates and runs 
  3356. make files. 
  3357.  
  3358. Controls 
  3359.  
  3360. Generate a make file 
  3361.      Select this check box if you want WorkFrame to automatically determine 
  3362.      file dependencies and produce a new make file each time this Build action 
  3363.      is executed. Deselect this check box if you have your own make file that 
  3364.      you want the Build action to use. 
  3365.  
  3366. Replace make files not generated by MakeMake 
  3367.      This check box is a safety feature to prevent WorkFrame from accidentally 
  3368.      overwriting a customized make file. Select it if you want WorkFrame to 
  3369.      overwrite the existing make file, regardless of any modifications you have 
  3370.      made to it. 
  3371.  
  3372. Generate a dependency file 
  3373.      Select this check box if you want the dependency information to be stored 
  3374.      in a separate file, rather than as part of the make file. 
  3375.  
  3376. Dependency file extension 
  3377.      If the build is to generate a separate dependency file, enter the 
  3378.      extension (usually .DEP) here. 
  3379.  
  3380. Make file generator 
  3381.      Allows you to replace the program that generates a make file, if you want 
  3382.      the generated make files to be compatible with some other make utility. 
  3383.  
  3384.      The generator program must transform intermediate (.$MM extension) files 
  3385.      to finished make files. If you need information about writing a make file 
  3386.      generation script, you must get the WorkFrame Integration Kit, which will 
  3387.      be available through the IBM support channel for this product. 
  3388.  
  3389. Make command 
  3390.      If you want the build process to use a Make command other than the 
  3391.      WorkFrame-supplied default, enter the command here. 
  3392.  
  3393. Reset 
  3394.      Restores the page to the same settings as when you opened the dialog. 
  3395.  
  3396. Default 
  3397.      Restores the page to its default values. 
  3398.  
  3399. Help 
  3400.      Displays this help panel. 
  3401.  
  3402.  
  3403. ΓòÉΓòÉΓòÉ 6.3. Project ΓòÉΓòÉΓòÉ
  3404.  
  3405. The settings on this page determine how to process projects that are nested 
  3406. inside one another, and allow you to speed up builds of projects for which you 
  3407. are the only developer or builder. 
  3408.  
  3409. Controls 
  3410.  
  3411. Use build settings from parent project 
  3412.      Leave this check box selected unless this project is nested within 
  3413.      another, and you want to build it with different settings than its parent 
  3414.      project. 
  3415.  
  3416.      When this check box is selected, the parent's Build settings override any 
  3417.      settings for this project. 
  3418.  
  3419. Pass build settings to subprojects 
  3420.      Select this check box to allow any nested projects to assume this 
  3421.      project's Build settings. If you do not select this check box, and the 
  3422.      subprojects are set to use the Build settings from their parent, they will 
  3423.      assume the Build settings from this project's parent instead, if one 
  3424.      exists. If this project is at the root of a project hierarchy, its 
  3425.      subprojects must define Build settings of their own or their builds will 
  3426.      fail. 
  3427.  
  3428. Build any subprojects first 
  3429.      Deselect this check box to perform a partial build. The current project 
  3430.      will be built, but any projects nested inside it will not. For example, 
  3431.      you might want to build an executable without rebuilding a DLL upon which 
  3432.      it depends. 
  3433.  
  3434. Lock the project as it is built 
  3435.      Leave this check box selected unless you are the only person who will be 
  3436.      building the project. It speeds up the build process by omitting checks 
  3437.      that prevent multiple simultaneous builds of the same project. 
  3438.  
  3439. Ensure the project target is not in use 
  3440.      Select this check box to have the build utility check if the target can be 
  3441.      accessed before starting the build. If the target is in use, the build 
  3442.      will not start. 
  3443.  
  3444. Reset 
  3445.      Restores the page to the same settings as when you opened the dialog. 
  3446.  
  3447. Default 
  3448.      Restores the page to its default values. 
  3449.  
  3450. Help 
  3451.      Displays this help panel. 
  3452.  
  3453.  
  3454. ΓòÉΓòÉΓòÉ 6.4. Display ΓòÉΓòÉΓòÉ
  3455.  
  3456. The settings on this page determine what kinds of interactive prompts to 
  3457. display during a build. 
  3458.  
  3459. Controls 
  3460.  
  3461. Prompt if errors are detected during build 
  3462.      Select this check box if you will be watching the build in person, and 
  3463.      might want to react to any errors that occur. Deselect it if you will 
  3464.      leave the build running unattended, or if you want the build to run to 
  3465.      completion regardless of any errors that occur. 
  3466.  
  3467. Display the MakeMake window during build 
  3468.      Select this check box if you want to explicitly create a make file using 
  3469.      MakeMake during a build. This check box allows you to customize the 
  3470.      makefile generation each time the build is run. 
  3471.  
  3472. Reset 
  3473.      Restores the page to the same settings as when you opened the dialog. 
  3474.  
  3475. Default 
  3476.      Restores the page to its default values. 
  3477.  
  3478. Help 
  3479.      Displays this help panel. 
  3480.  
  3481.  
  3482. ΓòÉΓòÉΓòÉ <hidden> Background information about the Build utility ΓòÉΓòÉΓòÉ
  3483.  
  3484. The WorkFrame Build utility eliminates the need for explicitly generating and 
  3485. maintaining make files.  It uses the MakeMake utility to generate a new make 
  3486. file each time a Build is initiated.  You can also set Build options to have 
  3487. the Build utility build all targets, even if they are not out of date with 
  3488. respect to their dependent files, or to effectively perform a Make action by 
  3489. only building the out-of-date files. 
  3490.  
  3491. Build Prerequisites 
  3492.  
  3493. The Build utility relies on a well-defined project setup to correctly generate 
  3494. the build rules and dependency information for your project: 
  3495.  
  3496. o The project dependencies must be expressed within the project hierarchy. 
  3497.  
  3498. o Correct Build options, especially the build actions, must be set. 
  3499.  
  3500. o The actions must have the source and target types set up correctly. 
  3501.  
  3502. o The Actions Support DLLs associated with each action involved in the Build 
  3503.   must provide a correct list of dependencies to the MakeMake utility. 
  3504.  
  3505. Note:  The default WorkFrame actions are already configured correctly for use 
  3506.        in your builds. If you use only these actions in your builds, you only 
  3507.        need to concern yourself with the first two prerequisites. 
  3508.  
  3509. You start a build action on your project by selecting Build from the project's 
  3510. pop-up menu or toolbar. 
  3511.  
  3512.  
  3513. ΓòÉΓòÉΓòÉ <hidden> Selecting actions for Build and Make ΓòÉΓòÉΓòÉ
  3514.  
  3515. You can select the build actions from the Actions list box in the Build options 
  3516. dialog, or you can run the MakeMake utility and select Build actions there. 
  3517. Where you select the Build actions depends on: 
  3518.  
  3519. o Whether you want to have descendant projects use the same set of Build 
  3520.   actions.  If you do, you will need to: 
  3521.  
  3522.     1. Select the Build actions from the Actions list box in the Build options 
  3523.        dialog. 
  3524.     2. Select the Pass Build settings to child projects on the Projects page in 
  3525.        the Build options dialog. 
  3526.     3. In the Build options for the descendant projects, select the Use build 
  3527.        settings from parent project in the Project page (this is the default). 
  3528.  
  3529.   The Build actions you select in the Actions list box apply to all the source 
  3530.   files in the project.  If you only want the Build actions to apply to some of 
  3531.   the source files in the project, you must select the Build actions and 
  3532.   applicable source files from MakeMake. 
  3533.  
  3534. o Whether you want to explicitly select source files to which the Build actions 
  3535.   should apply.  If you do, you will need to select the Build actions from 
  3536.   MakeMake.  Descendant projects cannot use the current project's Build actions 
  3537.   if they are specified from MakeMake. 
  3538.  
  3539.   MakeMake saves the actions from your last successful make file generation in 
  3540.   the extended attributes of the generated make file. If you already have a 
  3541.   make file generated by MakeMake, you can use the previously saved actions by 
  3542.   deselecting any actions selected in the Actions list box. 
  3543.  
  3544.   Note:  If any actions in the Build options Actions list box are selected, 
  3545.          those actions are used for the Build, even if Build actions were 
  3546.          previously set from MakeMake. 
  3547.  
  3548.  
  3549. ΓòÉΓòÉΓòÉ <hidden> MakeMake limitations ΓòÉΓòÉΓòÉ
  3550.  
  3551. The MakeMake utility creates make files that build a single target by invoking 
  3552. a series of actions.  Since projects are typically organized as a hierarchy of 
  3553. projects, with each project in the hierarchy representing a single target, 
  3554. MakeMake works very well with WorkFrame projects.  However, there are some 
  3555. limitations that you should be aware of. 
  3556.  
  3557. Note:  These limitations would only concern you if you need to: 
  3558.  
  3559. o Work with projects that use multiple PAMs 
  3560.  
  3561. o Build with actions that use third-party Actions Support DLLs 
  3562.  
  3563. o Use actions that specify user-defined types 
  3564.  
  3565. Here are four important MakeMake limitations: 
  3566.  
  3567. o The source and target types of each action involved in the make must be 
  3568.   specified correctly so that MakeMake can infer the order in which the actions 
  3569.   are to be executed. 
  3570.  
  3571. o The types specified in each action's settings for Source types and Target 
  3572.   types must be of the type classes "FileMask", "Logical OR", and "NOT in 
  3573.   Logical OR" or MakeMake will ignore the type. 
  3574.  
  3575.   All the predefined types are of the allowed classes, "FileMask", "Logical 
  3576.   OR", and "NOT in Logical OR".  The other type classes can be used to specify 
  3577.   the source types of actions that are not used in builds (such as Edit), and 
  3578.   for the project Parts filter. 
  3579.  
  3580. o MakeMake only works with project parts that are accessed by the basic PAM 
  3581.   (IWFBPAM) and other PAMs derived from it. 
  3582.  
  3583. o MakeMake calls application programming interfaces (APIs) in the Actions 
  3584.   Support DLLs of every action involved in the make to determine the list of 
  3585.   project parts or files the source is dependent on. 
  3586.  
  3587.   The accuracy of the dependencies and targets list is dependent upon the 
  3588.   Actions Support DLL for each action, not the MakeMake utility.  If MakeMake 
  3589.   fails to generate the correct list of dependencies or targets for a 
  3590.   user-written or third-party action, contact the supplier of the Actions 
  3591.   Support DLL. 
  3592.  
  3593.  
  3594. ΓòÉΓòÉΓòÉ 7. Project migration tool - Main window ΓòÉΓòÉΓòÉ
  3595.  
  3596. Use this tool to create projects for the current version of WorkFrame, based on 
  3597. existing projects for earlier WorkFrame versions. 
  3598.  
  3599. After the migration process is completed, you can start working with the new 
  3600. projects using the latest version of WorkFrame, and the original projects 
  3601. remain unchanged so that you can archive them. 
  3602.  
  3603. Controls 
  3604.  
  3605. Migrate V1.X projects 
  3606.      Selects the migration process that applies to WorkFrame Version 1.X 
  3607.      projects. When this check box is selected, you must enter the name of the 
  3608.      directory where the project is stored. 
  3609.  
  3610.    V1.X project directory 
  3611.         Displays the full path name of the directory where WorkFrame Version 
  3612.         1.X projects are located. You can use the Change directory pushbutton 
  3613.         to locate the directory. Then use the Find projects pushbutton to 
  3614.         locate and select the projects. 
  3615.  
  3616.    Change directory 
  3617.         Displays a Find dialog where you can locate a directory that contains 
  3618.         WorkFrame Version 1.X projects. Then use the Find projects pushbutton 
  3619.         to locate and select the projects. 
  3620.  
  3621. Migrate V2.X projects 
  3622.      Selects the migration process that applies to WorkFrame Version 2.X 
  3623.      projects. When this check box is selected, you must select one or more 
  3624.      drives to search for projects to be migrated. 
  3625.  
  3626.    Select drives 
  3627.         Select one or more drives to search for WorkFrame Version 2.X projects 
  3628.         to migrate. Then use the Find projects pushbutton to locate and select 
  3629.         the projects. 
  3630.  
  3631. Find projects 
  3632.      Automatically searches for projects to migrate, in the directory or on the 
  3633.      drives that you selected. After the search is finished, another dialog is 
  3634.      displayed where you can select which V2.X or V1.X projects to migrate. 
  3635.  
  3636. Stop search 
  3637.      Interrupts the search for projects to migrate, then proceeds to the next 
  3638.      migration phase where you select the individual projects. As the search 
  3639.      for V2.X projects can take a long time, you might want to stop the search 
  3640.      once it has located all the projects that you want to migrate. 
  3641.  
  3642. Cancel 
  3643.      Closes the window without performing any operation or saving any data. 
  3644.  
  3645. Related information 
  3646.  
  3647. o What is migrated from Version 1.X projects 
  3648. o What is migrated from Version 2.X projects 
  3649. o V1.X migration window 
  3650. o V2.X migration window 
  3651.  
  3652.  
  3653. ΓòÉΓòÉΓòÉ 7.1. Select V2.X Projects to Migrate ΓòÉΓòÉΓòÉ
  3654.  
  3655. Use this window to migrate Version 2.X projects. 
  3656.  
  3657. Select one or more projects, decide whether the default actions are sufficient 
  3658. or if you need to migrate a customized actions profile, then press the Migrate 
  3659. pushbutton. 
  3660.  
  3661. If not all the information for a Version 2.X project is available, you might 
  3662. see error messages in an Action Log window. The migration process will continue 
  3663. despite these messages, and migrate as much of the project as possible. 
  3664.  
  3665. Controls 
  3666.  
  3667. Projects 
  3668.      Lists the projects on which you can perform the migration process. Select 
  3669.      any existing projects for which you want to create equivalent WorkFrame 
  3670.      Version 3.0 projects. 
  3671.  
  3672.      This process creates a new project, and does not change the original 
  3673.      project. 
  3674.  
  3675.      After selecting some projects, you can use the Migrate pushbutton to start 
  3676.      the migration process. 
  3677.  
  3678.      If there are projects that you want to migrate but are not listed, you can 
  3679.      use the More projects pushbutton to select them one at a time. 
  3680.  
  3681. Only projects 
  3682.      Generates new projects without including the actions or action profiles 
  3683.      that were defined in the existing projects. The new projects will use the 
  3684.      same set of default actions as other newly created projects. 
  3685.  
  3686.      Select this check box if you have not integrated your own tools into the 
  3687.      projects that are being migrated, and will be using the default tools and 
  3688.      menus under WorkFrame Version 3.0. 
  3689.  
  3690. Projects and actions 
  3691.      Generates new projects that include the actions or action profiles that 
  3692.      were defined in the existing projects. 
  3693.  
  3694.      Select this check box if you have integrated your own tools into the 
  3695.      projects and do not want to have to do this work again in the migrated 
  3696.      project. 
  3697.  
  3698. Migrate V2.X action options 
  3699.      When you migrate the actions for a project along with the project itself, 
  3700.      this check box selects if the action options are migrated too. Otherwise, 
  3701.      the migrated actions use the WorkFrame defaults for command-line option 
  3702.      strings, error templates, compiler options, and so on. 
  3703.  
  3704. Migrate 
  3705.      Starts the migration process. The migration tool creates a folder on your 
  3706.      desktop called WorkFrame V3.0 Migration which contains two folders called 
  3707.      WorkFrame V3.0 Projects and WorkFrame V3.0 Action Projects. If you chose 
  3708.      not to migrate the actions from your old projects, the latter folder is 
  3709.      empty. The WorkFrame V3.0 Projects folder contains the migrated projects. 
  3710.  
  3711. Stop 
  3712.      Interrupts the migration process. You can stop the process if something 
  3713.      goes wrong or you change your mind before it is finished. 
  3714.  
  3715. More projects 
  3716.      Allows you to select more projects for the migration process, one at a 
  3717.      time through a Find dialog. 
  3718.  
  3719. Cancel 
  3720.      Exits from the window without performing the migration process. 
  3721.  
  3722. Related information 
  3723.  
  3724. o What is migrated from Version 2.X projects 
  3725.  
  3726.  
  3727. ΓòÉΓòÉΓòÉ 7.2. Select V1.X Projects to Migrate ΓòÉΓòÉΓòÉ
  3728.  
  3729. Use this window to migrate Version 1.X projects. 
  3730.  
  3731. Select one or more projects from the list and then select the Migrate 
  3732. pushbutton. 
  3733.  
  3734. Controls 
  3735.  
  3736. Projects 
  3737.      Lists all the WorkFrame Version 1 projects that are in the directory you 
  3738.      selected from the previous window. 
  3739.  
  3740. Migrate 
  3741.      Begins the migration process. 
  3742.  
  3743.      The migration tool creates a folder on your desktop called WorkFrame V3.0 
  3744.      Migration in which a folder called WorkFrame V3.0 Projects is created. 
  3745.      WorkFrame V3.0 Projects folder contains your migrated projects. Projects 
  3746.      migrated from Version 1.X inherit their actions from the default project 
  3747.      for the product. 
  3748.  
  3749. Stop migration 
  3750.      Interrupts the migration process before it is completed. 
  3751.  
  3752. Cancel 
  3753.      Exits from the window without performing the migration process. 
  3754.  
  3755. Related information 
  3756.  
  3757. o What is migrated from Version 1.X projects 
  3758.  
  3759.  
  3760. ΓòÉΓòÉΓòÉ <hidden> What is migrated from Version 2.X projects ΓòÉΓòÉΓòÉ
  3761.  
  3762. Here is a list of the Version 2.X project information that is migrated by the 
  3763. project migration tool. 
  3764.  
  3765. Information migrated from projects: 
  3766.  
  3767. o Target name 
  3768. o Run parameters 
  3769. o Run prompt 
  3770. o Run monitored 
  3771. o Make file name 
  3772. o Source directories 
  3773. o Working directory 
  3774. o File name filter 
  3775.  
  3776.    - The migration utility creates a new type called "Migrated file masks" and 
  3777.      adds it to the project's Parts filter entry field. 
  3778.  
  3779. o Auto-scroll monitor 
  3780. o PAMs are migrated as follows: 
  3781.  
  3782.    - DDE3BPAM to IWFBPAM 
  3783.    - EVFP370 to IWFP370 
  3784.    - EVFPADM to IWFPADM 
  3785.    - EVFP400 to IWFP400 
  3786.    - All others to IWFBPAM. 
  3787.  
  3788. The following information is migrated from action profiles into WorkFrame 
  3789. Version 3.0 projects: 
  3790.  
  3791. o Action scope (If an action is project-scoped, its controlling PAM defaults to 
  3792.   IWFBPAM.) 
  3793. o Action source and target types 
  3794. o Action run mode 
  3795. o Options DLLs are mapped to new Actions Support DLLs as follows: 
  3796.  
  3797.    - DDE3DEF2 to IWFOPT 
  3798.    - DDE4ICC2 to CPPICC30 
  3799.    - DDE4ICL2 to CPPICL30 
  3800.    - All others are migrated as is. 
  3801.  
  3802. o Environment variables 
  3803. o Types (All types are migrated to types of class FileMask.) 
  3804.  
  3805. The following information is not migrated: 
  3806.  
  3807. o Since there is no concept of a composite project in WorkFrame Version 3.0, 
  3808.   composite projects are not migrated.  However, any base projects in a 
  3809.   composite project can be migrated.  The names of the migrated base projects 
  3810.   include the name of their composite project in parentheses. 
  3811.  
  3812.  
  3813. ΓòÉΓòÉΓòÉ <hidden> What is migrated from Version 1.X projects ΓòÉΓòÉΓòÉ
  3814.  
  3815. The project migration tool migrates the following information from Version 1.X 
  3816. projects: 
  3817.  
  3818. o Target name 
  3819. o Make file name 
  3820. o Source directories 
  3821. o Working directory 
  3822. o File name filter 
  3823.  
  3824. Actions are not migrated. 
  3825.  
  3826.  
  3827. ΓòÉΓòÉΓòÉ 8. Project Smarts ΓòÉΓòÉΓòÉ
  3828.  
  3829. Project Smarts is a powerful tool to help you get started quickly writing your 
  3830. applications.  It is a catalog of template applications you can use as a base 
  3831. with which to write your own applications. products that incorporate the 
  3832. WorkFrame component. is defined as an IPFCPREP macro in IWFCSH.PRE. 
  3833.  
  3834. This feature is optional and might not be present in all products that 
  3835. incorporate the WorkFrame component. 
  3836.  
  3837. The Project Smarts catalog lists the available applications in the Available 
  3838. projects list box.  As you select an application name, the Description field is 
  3839. updated with a short description of the application. 
  3840.  
  3841. To create a project, select it and then select the Create push button.  You 
  3842. will be prompted for a folder in which to create the project, a directory in 
  3843. which to copy the source files (if it does not exist, it will be created for 
  3844. you), and the name you want to give the created project.  You may also be 
  3845. prompted for customization information. 
  3846.  
  3847. A Progress Console appears showing the progress of the install. After the 
  3848. project has been created, it will contain skeleton source files for your 
  3849. application.  All the actions necessary to build the applications are 
  3850. configured. 
  3851.  
  3852.  
  3853. ΓòÉΓòÉΓòÉ 8.1. Progress Console ΓòÉΓòÉΓòÉ
  3854.  
  3855. The Project Smarts Console shows the progress of the project creation.  It has 
  3856. three areas: 
  3857.  
  3858. o The Progress Indicator shows how much work has progressed since the creation 
  3859.   was started. 
  3860.  
  3861. o The Status Area shows the current status message. 
  3862.  
  3863. o The Message log shows more detail, and a history of the current status. 
  3864.  
  3865.  
  3866. ΓòÉΓòÉΓòÉ 8.2. Location ΓòÉΓòÉΓòÉ
  3867.  
  3868. The Location window prompts you for the folder in which to create the project, 
  3869. the directory in which to copy the source files, and the name to give the new 
  3870. project.  It has three fields: 
  3871.  
  3872. Project 
  3873.      Enter the name you want to give the new project in this entry field. 
  3874.  
  3875. Directory 
  3876.      Enter the fully-qualified path name of the directory where you want the 
  3877.      source files to be copied.  This directory will be the new project's 
  3878.      working directory. 
  3879.  
  3880. Folder 
  3881.      This field contains a tree view of all the folders on your Desktop. 
  3882.      Select the folder where you want your new project created. 
  3883.  
  3884.  
  3885. ΓòÉΓòÉΓòÉ 8.3. Variable Settings ΓòÉΓòÉΓòÉ
  3886.  
  3887. Use the Variable Settings window to customize the generated project by setting 
  3888. values for certain substitution variables, such as the source-file prolog text, 
  3889. current date, and your name. As you select each variable name in the Variable 
  3890. list box, the Variable Description and Variable Setting fields are updated to 
  3891. show a short description of the variable and its default value. 
  3892.  
  3893. Verify the defaults and set values of your own.  To change the default values, 
  3894. edit the Value field.  The values that you set are used when the application is 
  3895. installed.  They are also saved for the next time you install the same Project 
  3896. Smarts application. 
  3897.  
  3898.  
  3899. ΓòÉΓòÉΓòÉ 8.4. Project Smarts Settings - Catalog Page ΓòÉΓòÉΓòÉ
  3900.  
  3901. Use the Catalog page of the Project Smarts Settings notebook to change the 
  3902. settings of a Project Smarts application, or add another application to the 
  3903. catalog. 
  3904.  
  3905. To change an application, select it and then select the Settings... push 
  3906. button. 
  3907.  
  3908. To add an application, select the Create another... push button. 
  3909.  
  3910. The Catalog entry window appears where you can change or define the settings 
  3911. for a Project Smarts application. 
  3912.  
  3913. For more details on how to add your own Project Smarts application to the 
  3914. Project Smarts catalog, or how to create a catalog of your own, please refer to 
  3915. the "Project Smarts" chapter of the WorkFrame user's guide. 
  3916.  
  3917.  
  3918. ΓòÉΓòÉΓòÉ 8.4.1. Catalog Entry ΓòÉΓòÉΓòÉ
  3919.  
  3920. Unless you are providing your own Project Smarts application, the Catalog Entry 
  3921. window will not be of much interest to you.  For more information about this 
  3922. window, and how to provide your own Project Smarts application or catalog, see 
  3923. the "Project Smarts" chapter of the WorkFrame user's guide, called Developing 
  3924. Applications with WorkFrame. 
  3925.  
  3926. The Catalog Entry window contains fields that define a Project Smarts 
  3927. application: 
  3928.  
  3929. Project 
  3930.      Enter the project's title.  The application is listed under this title in 
  3931.      the catalog.  It is also the default title for the created project. 
  3932.  
  3933. Description 
  3934.      Enter a description of the application.  This description also appears in 
  3935.      the catalog. 
  3936.  
  3937. Source 
  3938.      Enter the location of the base source files for the application. The 
  3939.      location can be a directory or an existing WorkFrame project. The install 
  3940.      script copies the source from this location. 
  3941.  
  3942. Script 
  3943.      Enter the name of the Project Smarts REXX install script that creates the 
  3944.      Project Smarts application.  You can enter a fully qualified path name or 
  3945.      a command file found on the PATH. 
  3946.  
  3947.      You can specify your own customized script, or use the default script, 
  3948.      IWFSMART.CMD. 
  3949.  
  3950. Parameters 
  3951.      List any parameters that your install script may require. Project Smarts 
  3952.      will pass these parameters to your script when it invokes it during the 
  3953.      installation.  Three substitution variables are also available to be 
  3954.      passed as parameters to your script: 
  3955.  
  3956.    %project% 
  3957.            The name of the project, as specified in the Project field of the 
  3958.            Catalog Entry window when the Project Smarts application was added 
  3959.            to the catalog.  The install script can use this name as the default 
  3960.            name of the project it creates. 
  3961.    %location% 
  3962.            The directory where the base source files are located, as specified 
  3963.            in the Source field of the Catalog Entry window. Your install script 
  3964.            can use this information to copy the files from the source 
  3965.            directory, or do some other file processing. 
  3966.    %description% 
  3967.            The description of the application, as specified in the Description 
  3968.            field of the Catalog Entry window. 
  3969.    %catalog% 
  3970.            The fully-qualified path name of the Project Smarts catalog. The 
  3971.            path name of the catalog is a required parameter for the 
  3972.            IwfSaveVariables and IwfRestoreVariables utilities because the 
  3973.            variable settings are stored with the Project Smarts catalog. 
  3974.  
  3975.      If you use the default installation script (IWFSMART.CMD), enter the 
  3976.      required parameters %project% %location% in the Parameters entry field. 
  3977.  
  3978. Select the OK push button to make your changes active. 
  3979.  
  3980.  
  3981. ΓòÉΓòÉΓòÉ 8.5. Project Smarts Settings - Display Page ΓòÉΓòÉΓòÉ
  3982.  
  3983. Use the Display page of the Project Smarts Settings notebook to configure which 
  3984. dialogs to display during the creation of a Project Smarts application.  You 
  3985. can select the following check boxes: 
  3986.  
  3987. Display the installation console 
  3988.      Select this option to always display the Project Smarts Progress Console 
  3989.      whenever you create a project from Project Smarts.  If you do not select 
  3990.      this option, the Progress Console will not appear during the installation. 
  3991.  
  3992. Display the variable settings dialog 
  3993.      Select this option to always display the Project Smarts Variable Settings 
  3994.      window whenever you create a project from Project Smarts.  If you do not 
  3995.      select this option, you won't be able to customize the created project at 
  3996.      installation time.  Instead, Project Smarts uses the default variable 
  3997.      settings, or the settings specified the last time the application was 
  3998.      installed. 
  3999.  
  4000.  
  4001. ΓòÉΓòÉΓòÉ <hidden> Find directories ΓòÉΓòÉΓòÉ
  4002.  
  4003. Use this window to select one or more directories. There are two versions of 
  4004. this window, one for selecting one directory (with only Drives and Directories 
  4005. controls), and an extended version for selecting multiple directories that 
  4006. includes extra pushbuttons. 
  4007.  
  4008.  1. Select a drive from the Drives dropdown list box. 
  4009.  2. Select a directory from the Directories list box. Double-click on a 
  4010.     directory to see any subdirectories it contains. 
  4011.  3. In the extended version of the window: 
  4012.  
  4013.    o Select the Add pushbutton to add the selected directory to the list of 
  4014.      Selected directories. 
  4015.    o Repeat this process as often as necessary until you have selected all the 
  4016.      directories you want. 
  4017.    o You can also remove a selected directory from the Selected directories 
  4018.      list box with the Remove pushbutton. 
  4019.  
  4020. To confirm your selection, select the OK button. To cancel the selection, 
  4021. select the Cancel button. 
  4022.  
  4023.  
  4024. ΓòÉΓòÉΓòÉ <hidden> Find and Open Windows ΓòÉΓòÉΓòÉ
  4025.  
  4026. Use the Find and Open windows to locate and select an object such as a file or 
  4027. a project. 
  4028.  
  4029. To locate and select an object: 
  4030.  
  4031.  1. Select the arrow to the right of the Drive list to display all the drives 
  4032.     on your system. 
  4033.  2. Select a drive from the Drive list. 
  4034.  3. Select a directory from the Directory list. 
  4035.  
  4036.     Note:  By default, WorkFrame projects are located under the operating 
  4037.            system's Desktop directory. If a project is nested inside a base 
  4038.            project, then the associated project file is located in one of the 
  4039.            source directories of the base project. 
  4040.  
  4041.  
  4042.  4. Select a file name from the File list or type in a file name and select the 
  4043.     OK push button. 
  4044.  
  4045.     Note:  This list shows only the physical file name of projects. To 
  4046.            determine the physical file name for a project, check the File page 
  4047.            in its settings notebook. If you are using the FAT (File Allocation 
  4048.            Table) file system, the file name is usually the first eight letters 
  4049.            of the objects title. If the first eight letters are common to 
  4050.            another object in the directory, the file name ends in a number. For 
  4051.            example, the projects Test Project 1 and Test Project 2 could appear 
  4052.            as 
  4053.  
  4054.                          TEST_PRO
  4055.                          TEST_PR1
  4056.  
  4057.  
  4058. For a detailed explanation of each field, select from the list below: 
  4059.  
  4060. o Open filename 
  4061. o Type of file 
  4062. o Drive 
  4063. o Files 
  4064. o Directory 
  4065. o OK 
  4066. o Cancel 
  4067.  
  4068.  
  4069. ΓòÉΓòÉΓòÉ <hidden> Open Filename ΓòÉΓòÉΓòÉ
  4070.  
  4071. Type the name of the file you want to open in the Open filename field. 
  4072.  
  4073.  
  4074. ΓòÉΓòÉΓòÉ <hidden> Type of File ΓòÉΓòÉΓòÉ
  4075.  
  4076. Select the arrow to the right of the Type of file field to display the 
  4077. available file types. 
  4078.  
  4079. The contents of the field and its combination box depend on what task you are 
  4080. performing. 
  4081.  
  4082.  
  4083. ΓòÉΓòÉΓòÉ <hidden> Drive ΓòÉΓòÉΓòÉ
  4084.  
  4085. The Drive list displays the drives on your system. Select the drive that 
  4086. contains the file you are looking for. 
  4087.  
  4088.  
  4089. ΓòÉΓòÉΓòÉ <hidden> Files ΓòÉΓòÉΓòÉ
  4090.  
  4091. The File list displays all the files in the directory you selected from the 
  4092. Directory list that match the Type of file indicated. Select the file you want 
  4093. from this list. 
  4094.  
  4095.  
  4096. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  4097.  
  4098. Select this pushbutton when you have selected the file. 
  4099.  
  4100.  
  4101. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  4102.  
  4103. Select this pushbutton to close the window without selecting a file. 
  4104.  
  4105.  
  4106. ΓòÉΓòÉΓòÉ <hidden> Directory ΓòÉΓòÉΓòÉ
  4107.  
  4108. The Directory list displays the directories on the selected drive. Select a 
  4109. directory to display the list of files from that directory in the File list 
  4110. box. 
  4111.  
  4112.  
  4113. ΓòÉΓòÉΓòÉ <hidden> Confirm Deletion ΓòÉΓòÉΓòÉ
  4114.  
  4115. Use this window to verify you want to delete all the items shown from the 
  4116. project. 
  4117.  
  4118. Select the OK or Yes pushbutton to delete all the items, or the Cancel or No 
  4119. pushbutton if you do not want to delete all the items. 
  4120.  
  4121.  
  4122. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4123.  
  4124. Explanation: 
  4125.  
  4126. A loop has been detected in the definitions of the source masks and target 
  4127. masks of the actions. The message box shows the actions and masks that caused 
  4128. the loop. 
  4129.  
  4130. Because of the loop, the order in which the actions need to be processed is 
  4131. unclear. Therefore, the make file generated by MakeMake may not be valid with 
  4132. respect to these actions. 
  4133.  
  4134. For example, suppose you have a project where: 
  4135.  
  4136.  1. The compiler creates object files (*.OBJ) from source code (*.CPP). 
  4137.  
  4138.  2. The IMPLIB utility is used to create an import library (*.LIB) from a 
  4139.     definition file (*.DEF). 
  4140.  
  4141.  3. The linker is used to create a dynamic link library (*.DLL) using the 
  4142.     object files from the first step and the import library from the second 
  4143.     step. 
  4144. You would then expect a make file with the steps shown below: 
  4145.  
  4146.  
  4147.   *.CPP ΓöÇΓöÇΓöÇΓöÇ *.OBJ ΓöÇΓöÇΓöÇΓöÇΓöÉ
  4148.                         
  4149.                       *.DLL
  4150.                         
  4151.   *.DEF ΓöÇΓöÇΓöÇΓöÇ *.LIB ΓöÇΓöÇΓöÇΓöÇΓöÿ
  4152.  
  4153. However, the IMPLIB utility can also build import libraries from DLLs. 
  4154. Therefore, the definition of the source masks within the action settings for 
  4155. the IMPLIB utility could have *.DLL as a valid source mask. In this case, 
  4156. MakeMake would internally build the following flow diagram as it tries to 
  4157. determine the order in which the actions should be invoked in order to make the 
  4158. project: 
  4159.  
  4160.  
  4161.   *.CPP ΓöÇΓöÇΓöÇΓöÇ *.OBJ ΓöÇΓöÇΓöÇΓöÇΓöÉ
  4162.                         
  4163.                 ΓöîΓöÇΓöÇΓöÇΓöÇ *.DLL
  4164.                        
  4165.   *.DEF ΓöÇΓöÇΓöÇΓöÇ *.LIB ΓöÇΓöÇΓöÇΓöÇΓöÿ
  4166.  
  4167. Unlike the previous diagram, there is no clear end to the order of actions. 
  4168. MakeMake has detected this and issued a message. 
  4169.  
  4170. Recovery: 
  4171.  
  4172. There are two methods of dealing with this situation. 
  4173.  
  4174. The first method (strongly recommended) is to remove the loop by deleting one 
  4175. of the source masks or target masks listed in the loop above. In the above 
  4176. scenario, you could go to the action settings where the IMPLIB action is 
  4177. defined and delete the *.DLL entry from the source masks' list. Although 
  4178. removing a valid mask may seem unwise, you need to clarify the order of actions 
  4179. for MakeMake (If you prefer, you could duplicate the action that needs to be 
  4180. changed and then alter the name and masks of the duplicate. This way, you will 
  4181. have both generic and customized forms of the action. Then you can use the 
  4182. customized form only when required.) 
  4183.  
  4184. The second method is to continue with the processing and correct the two types 
  4185. of errors that may occur within the make file. Check for and correct these 
  4186. errors manually in the Change window. 
  4187.  
  4188. The first type of error is that the order in which the actions are processed is 
  4189. not valid, a situation that may result in incomplete file lists. For each 
  4190. action listed in the message, verify that it is dependent on all the required 
  4191. source files with the source mask also indicated in the message. 
  4192.  
  4193. The other type of error is that the .ALL dependency statement may be 
  4194. incomplete. Because of the loop, makemake may be unable to determine which 
  4195. files are final products. In the above example, the import library is as valid 
  4196. a final output as the dynamic link library is. Complete the .ALL statement 
  4197. manually. 
  4198.  
  4199.  
  4200. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4201.  
  4202. Explanation: 
  4203.  
  4204. When MakeMake is creating a make file, it first creates a list of potential 
  4205. source files for each action. This list is based on the source types and masks 
  4206. listed for the action. The list is passed to the support dynamic link library 
  4207. (DLL) that is used to set options for the action. If none of the files is 
  4208. selected by the actions support DLL, then MakeMake reports that no files have 
  4209. been selected for that action. 
  4210.  
  4211. This may occur if the set of source masks listed in the action's settings does 
  4212. not match the list of types maintained internally by the DLL. For example, an 
  4213. options DLL for the Link action might require that files with the extension OBJ 
  4214. (object files) be passed to it. However, if object files are not one of the 
  4215. types of files listed as source in the action's settings, no files can be 
  4216. selected. 
  4217.  
  4218. Recovery: 
  4219.  
  4220. Check the action's settings and ensure that the source types listed for the 
  4221. action are valid source types (type class "File Mask" or "Logical-OR") and that 
  4222. they apply to the action and to the files that exist in the project. 
  4223.  
  4224.  
  4225. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4226.  
  4227. Explanation: 
  4228.  
  4229. The MakeMake utility tried to use the project's parts access method (PAM) to 
  4230. list the project files, but the PAM could not provide the information. 
  4231.  
  4232. Recovery: 
  4233.  
  4234. Verify that the PAM is defined correctly for the project. 
  4235.  
  4236. If it is not defined correctly, close the MakeMake utility then reopen it.  Try 
  4237. to recreate the make file. 
  4238.  
  4239. If the error persists, contact your IBM Service representative. If the project 
  4240. access method you are using was not supplied by IBM, contact the PAM supplier. 
  4241.  
  4242.  
  4243. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4244.  
  4245. Explanation: 
  4246.  
  4247. One or more of the selected actions is independent of the other actions.  Each 
  4248. of the selected actions must be dependent on another selected action.  The 
  4249. dependency between actions is defined by the source and target masks defined in 
  4250. the actions' settings. 
  4251.  
  4252. For example, if the following three actions are selected: 
  4253.  
  4254. o Compile (compiles source code into object code) 
  4255.  
  4256. o Link (links object files to build an executable file) 
  4257.  
  4258. o IPFCompile (compiles help files into help library files used by the 
  4259.   executable file) 
  4260.  
  4261. and they have defined source and target masks as shown in the following table: 
  4262.  
  4263. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4264. ΓöéAction         ΓöéSource mask    ΓöéTarget mask    Γöé
  4265. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4266. ΓöéCompile        Γöé*.c            Γöé*.obj          Γöé
  4267. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4268. ΓöéLink           Γöé*.obj          Γöé*.exe          Γöé
  4269. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4270. ΓöéIPFCompile     Γöé*.ipf          Γöé*.hlp          Γöé
  4271. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4272. Based on the above information, two project targets could be built: 
  4273.  
  4274. o An executable file: 
  4275.  
  4276.     ΓöîΓöÇΓöÇΓöÉ          ΓöîΓöÇΓöÇΓöÇΓöÇΓöÉ              ΓöîΓöÇΓöÇΓöÇΓöÇΓöÉ
  4277.     Γöé.CΓö£ΓöÇΓöÇiccΓöÇΓöÇΓöÇΓöñ.OBJΓö£ΓöÇΓöÇΓöÇΓöÇlinkΓöÇΓöÇΓöÇΓöÇΓöñ.EXEΓöé
  4278.     ΓööΓöÇΓöÇΓöÿ          ΓööΓöÇΓöÇΓöÇΓöÇΓöÿ              ΓööΓöÇΓöÇΓöÇΓöÇΓöÿ
  4279.  
  4280. o Or a help file: 
  4281.  
  4282.     ΓöîΓöÇΓöÇΓöÉ          ΓöîΓöÇΓöÇΓöÇΓöÇΓöÉ              ΓöîΓöÇΓöÇΓöÇΓöÇΓöÉ
  4283.     Γöé.CΓö£ΓöÇΓöÇiccΓöÇΓöÇΓöÇΓöñ.OBJΓö£ΓöÇΓöÇΓöÇΓöÇlinkΓöÇΓöÇΓöÇΓöÇΓöñ.EXEΓöé
  4284.     ΓööΓöÇΓöÇΓöÿ          ΓööΓöÇΓöÇΓöÇΓöÇΓöÿ              ΓööΓöÇΓöÇΓöÇΓöÇΓöÿ
  4285.  
  4286. However, because you can have only one target for every project, the MakeMake 
  4287. utility cannot create the make file. 
  4288.  
  4289. Recovery: 
  4290.  
  4291. Review the list of selected actions and ensure that those actions that are 
  4292. required to make the project target are selected.  Also, ensure that no action 
  4293. is selected which is not required to make the project target. 
  4294.  
  4295. If you need to build another target that is related to the project target (for 
  4296. example, the help library in the example above), create another project for 
  4297. that target, and then nest it into the first project by dragging it into the 
  4298. project's parts container.  You can then create a separate make file for the 
  4299. Help Project.  By doing this, you have established a dependency relationship 
  4300. between the .EXE project and the .HLP project.  You can then use the Build 
  4301. utility to build both projects in sequence (the Help Project first, then the 
  4302. .EXE project). 
  4303.  
  4304.  
  4305. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4306.  
  4307. Explanation: 
  4308.  
  4309. There are no source files for the action indicated in the message. 
  4310.  
  4311. Every selected action needs to have one or more files corresponding to the 
  4312. Source masks specified in the action's settings.  These files can either be 
  4313. part of the project's source files or be produced by another selected action. 
  4314. The MakeMake utility has determined that there are no project source files 
  4315. matching the action's source masks and that no other selected action will 
  4316. produce files with the required source masks. 
  4317.  
  4318. Recovery: 
  4319.  
  4320. If the action indicated in the message is not required to make the project, 
  4321. deselect it in the Actions list. Otherwise, determine if no source files can be 
  4322. found for one or more of the following reasons: 
  4323.  
  4324. o Do more files need to selected in the Files list? If so, select more files. 
  4325.  
  4326. o Is the action that is supposed to create the source files selected? If not, 
  4327.   select the action. 
  4328.  
  4329. o If the action that is supposed to create the source files is selected, are 
  4330.   its options set so that it will create the missing source files? (For 
  4331.   example, a compiler's options could be set so that only the preprocessor is 
  4332.   run.) If not, set the options. 
  4333.  
  4334.  
  4335. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4336.  
  4337. Explanation: 
  4338.  
  4339. The MakeMake utility has discovered that running the indicated action with its 
  4340. options will generate a file that does not correspond to any of the action's 
  4341. target types. 
  4342.  
  4343. Recovery: 
  4344.  
  4345. Add the correct type or mask to the action's Target types field in the action's 
  4346. settings. 
  4347.  
  4348.  
  4349. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4350.  
  4351. Explanation: 
  4352.  
  4353. This message tells you that the MakeMake utility has stopped creating the make 
  4354. file, as you requested. 
  4355.  
  4356.  
  4357. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4358.  
  4359. Explanation: 
  4360.  
  4361. The MakeMake utility requires that each selected action result in the creation 
  4362. of at least one file. However, the indicated action will not create any files. 
  4363.  
  4364. Recovery: 
  4365.  
  4366. Ensure that the action's options and the files selected for it would actually 
  4367. create files with the target mask indicated.  An option may have been set that 
  4368. prevents the action from doing so.  For example, an option could be set that 
  4369. causes the action to simply list the command line syntax without producing any 
  4370. files. 
  4371.  
  4372.  
  4373. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4374.  
  4375. Explanation: 
  4376.  
  4377. An options string with incorrect substitution variables was returned to the 
  4378. MakeMake utility. 
  4379.  
  4380. Recovery: 
  4381.  
  4382. Ensure that the invocations string supplied by the action's support DLL in the 
  4383. message returns an invocation string with valid WorkFrame substitution 
  4384. variables. 
  4385.  
  4386.  
  4387. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4388.  
  4389. Explanation: 
  4390.  
  4391. A make file cannot be produced unless the project has an action available to 
  4392. it.  The action must also operate on the project's parts. 
  4393.  
  4394.  
  4395. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4396.  
  4397. Explanation: 
  4398.  
  4399. The MakeMake utility has created the make file successfully but cannot fully 
  4400. display it in the Results window because the file is too large. 
  4401.  
  4402. As much of the make file as possible is displayed, but you cannot edit the file 
  4403. within the MakeMake utility. Save the make file and use a text editor to view 
  4404. the whole file and make any changes. 
  4405.  
  4406.  
  4407. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4408.  
  4409. Explanation: 
  4410.  
  4411. You selected a control that removes some or all of the changes you have made to 
  4412. the make file. 
  4413.  
  4414. Recovery: 
  4415.  
  4416. Select Yes if you want to discard your changes. Otherwise, select No. 
  4417.  
  4418.  
  4419. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4420.  
  4421. Explanation: 
  4422.  
  4423. You are about to close the MakeMake utility without saving the make file. 
  4424.  
  4425. Recovery: 
  4426.  
  4427. Select Yes if you want to exit without saving the make file. To save the make 
  4428. file, select No, then select Save make file from the File pulldown menu, and 
  4429. exit. 
  4430.  
  4431.  
  4432. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4433.  
  4434. Explanation: 
  4435.  
  4436. Another make file with the same name already exists. 
  4437.  
  4438. Recovery: 
  4439.  
  4440. Select Yes if you want to overwrite the existing make file. Otherwise, select 
  4441. No. 
  4442.  
  4443.  
  4444. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4445.  
  4446. Explanation: 
  4447.  
  4448. You are being asked to verify that you want to stop the creation of the make 
  4449. file. 
  4450.  
  4451. Recovery: 
  4452.  
  4453. Select Yes to stop the creation of the make file. Select No to continue 
  4454. processing. 
  4455.  
  4456.  
  4457. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4458.  
  4459. Explanation: 
  4460.  
  4461. One of the files selected in the Files list is both a target for one of the 
  4462. selected actions and a dependency on another selected file. 
  4463.  
  4464. For example, suppose you selected an action Compile which can operate on the 
  4465. files with extensions .C and .H. If you also selected the files TEST.C and 
  4466. TEST.H (which is included by TEST.C), you would get this message. 
  4467.  
  4468. Recovery: 
  4469.  
  4470. Modify your selections in the Actions and Files list boxes so that no file is 
  4471. both a target for one of the selected actions and a dependency on another 
  4472. selected file. 
  4473.  
  4474. Because your choices are saved between invocations of the MakeMake utility, you 
  4475. do not have to reselect the changes you made in this session in future 
  4476. sessions. 
  4477.  
  4478.  
  4479. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4480.  
  4481. Explanation: 
  4482.  
  4483. WorkFrame could not load the project files because it could not access the 
  4484. working directory.  The working directory may be incorrect or inaccessible. 
  4485.  
  4486. Recovery: 
  4487.  
  4488. Ensure that the working directory is correct and that you have access, then 
  4489. retry the operation. 
  4490.  
  4491.  
  4492. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4493.  
  4494. Explanation: 
  4495.  
  4496. The parameter you specified is not valid. 
  4497.  
  4498. Recovery: 
  4499.  
  4500. Ensure that the parameters you specified are correct. To obtain a list of 
  4501. allowed parameters, type: 
  4502.  
  4503.    iwfmmake /? >filename
  4504.  
  4505. on the command line, or refer to the User's Guide. 
  4506.  
  4507.  
  4508. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4509.  
  4510. Explanation: 
  4511.  
  4512. Changes have been made to the make file since it was last generated by MakeMake 
  4513. for this project. 
  4514.  
  4515. Recovery: 
  4516.  
  4517. Select Yes if you want to continue. If MakeMake is completed successfully, the 
  4518. old make file will be replaced. Select No if you want to stop MakeMake. 
  4519.  
  4520.  
  4521. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4522.  
  4523. Explanation: 
  4524.  
  4525. Not enough memory is available for MakeMake to operate. 
  4526.  
  4527. Recovery: 
  4528.  
  4529. Stop any large processes that are running and ensure that your swap path is 
  4530. large enough.  Retry the operation. 
  4531.  
  4532.  
  4533. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4534.  
  4535. Explanation: 
  4536.  
  4537. You cancelled the loading of the project. 
  4538.  
  4539. Recovery: 
  4540.  
  4541. No action is required. 
  4542.  
  4543.  
  4544. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4545.  
  4546. Explanation: 
  4547.  
  4548. The system could not handle an exception that was thrown. 
  4549.  
  4550. Recovery: 
  4551.  
  4552. Shut down your system and restart it.  Restart the program. If the problem 
  4553. persists, contact your IBM Service Representative. 
  4554.  
  4555.  
  4556. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4557.  
  4558. Explanation: 
  4559.  
  4560. For project portability, MakeMake requires a Rexx Script file for every 
  4561. project, but it could not find a Rexx Script for this project. The Rexx Script 
  4562. file name is specified in the build options dialog. 
  4563.  
  4564. Recovery: 
  4565.  
  4566. Ensure that the Rexx Script file name is specified in the directory contained 
  4567. in your PATH statement. The default Rexx Script file is IWFMMGEN.CMD, which is 
  4568. supplied with the WorkFrame. 
  4569.  
  4570.  
  4571. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4572.  
  4573. Explanation: 
  4574.  
  4575. The indicated file name is not allowed for the file system in use, or the 
  4576. working directory of the project is on a read-only drive. 
  4577.  
  4578. Recovery: 
  4579.  
  4580. Ensure that the file name is in an allowed format, and that the working 
  4581. directory can be written to. 
  4582.  
  4583.  
  4584. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  4585.  
  4586. Explanation: 
  4587.  
  4588. MakeMake requires a working directory for the project, but you have not 
  4589. specified one. The working directory is specified in the project's Settings 
  4590. pages. 
  4591.  
  4592. Recovery: 
  4593.  
  4594. Specify a working directory for the project, then retry the operation. 
  4595.  
  4596.  
  4597. ΓòÉΓòÉΓòÉ 9. Terms used in this document ΓòÉΓòÉΓòÉ
  4598.  
  4599. action    A description of a tool or function that can be used to manipulate a 
  4600.           project's parts, or build a project's target. 
  4601.  
  4602. action class A grouping of actions that perform a similar function. 
  4603.  
  4604. actions support DLL A dynamic link library that provides such support for an 
  4605.           action as determining dependencies and targets if the action is to 
  4606.           participate in a build, providing a user interface for setting 
  4607.           options, and integration with the monitor and editor. 
  4608.  
  4609. base project A project from which another project inherits its tools setup. 
  4610.           Distinguished from parent project. 
  4611.  
  4612. build     An action that invokes the WorkFrame Build tool.  The Build tool 
  4613.           manages the project's make file, as well as build dependencies 
  4614.           between projects in a project hierarchy. 
  4615.  
  4616. build actions A series of actions that are invoked to build a project's target. 
  4617.           These actions are set in the Build options window, or in MakeMake, 
  4618.           WorkFrame's make file creation utility. 
  4619.  
  4620. default action Each action class has a default action.  It is defined as the 
  4621.           first action listed for the class. 
  4622.  
  4623. working directory The directory where files that are copied or dragged into the 
  4624.           project are stored.  Actions are also executed in this directory, so 
  4625.           this directory is where many output files are placed. 
  4626.  
  4627. default editor The editor that is first in the list of editors in the Tools 
  4628.           setup window.  This editor is invoked when you double-click on an 
  4629.           error message in the monitor, or when another tool requests an Edit 
  4630.           action to be invoked. 
  4631.  
  4632. environment variable In a WorkFrame project, an environment variable is an 
  4633.           operating system variable, like PATH and DPATH, and any other 
  4634.           environment variables that are defined using the OS/2 SET command, 
  4635.           such as TMP. 
  4636.  
  4637. file-scoped action Distinguished from a project-scoped action in that it is 
  4638.           invoked on files.  Only file-scoped actions can participate in a 
  4639.           project build. 
  4640.  
  4641. filter    In WorkFrame, the value of a type.  The filter of a type can be 
  4642.           expressed as a file mask, regular expression, a logical-OR, a 
  4643.           logical-AND, or logical-NOT of a list of types, or a filter 
  4644.           determined by a PAM. 
  4645.  
  4646. inheritance In WorkFrame, refers to the mechanism in which the tools setup of a 
  4647.           project is shared by another project. 
  4648.  
  4649. make      An action in which a project's target is built from a make file by a 
  4650.           make utility. 
  4651.  
  4652. MakeMake  WorkFrame's make file generation utility. 
  4653.  
  4654. Monitor   A window that displays output from monitored actions. The Monitor 
  4655.           window is attached to the project container. 
  4656.  
  4657. monitored action An action that has been set to run in the monitor window, and 
  4658.           outputs to standard out.  Actions may also run in full-screen and 
  4659.           windowed sessions. 
  4660.  
  4661. nested project A project that appears inside another project.  Nesting 
  4662.           expresses a dependency of the parent project on the child project's 
  4663.           target.  This dependency is managed by WorkFrame's Build utility. 
  4664.  
  4665. parent project A project that contains other projects.  Distinguished from 
  4666.           child project. 
  4667.  
  4668. project   The central WorkFrame model of the complete set of data and actions 
  4669.           required to build a single target, such as a dynamic link library 
  4670.           (DLL) or other executable.  A project consists of a set of project 
  4671.           parts and a Tools setup.. 
  4672.  
  4673. Project Access Method (PAM) A dynamic link library that contains a set of 
  4674.           methods through which a simple abstraction of a file system or 
  4675.           repository is provided to WorkFrame.  PAMs enable a WorkFrame project 
  4676.           to contain any kind of object that a PAM can support, for example a 
  4677.           version of a file in a source control library, or another file system 
  4678.           like MVS or AIX. 
  4679.  
  4680. project hierarchy A project tree that represents dependencies between projects. 
  4681.           The WorkFrame project paradigm requires that one project should be 
  4682.           created for every target.  Dependencies between projects and their 
  4683.           targets should be expressed in a project hierarchy.  That is, if a 
  4684.           project's build depends on the target of another project, the 
  4685.           dependent project should contain the project it depends on. The 
  4686.           dependent project is then said to nest the other project.  This 
  4687.           enables the Build tool to perform Builds in a depth-first search 
  4688.           manner from anywhere in the project hierarchy. 
  4689.  
  4690. project-scoped action An action that applies to a project as a whole, or to a 
  4691.           project's specially designated parts.  Specially designated project 
  4692.           parts are the project's make file and target.  An example of a 
  4693.           project-scoped action is Debug, which is invoked on the project's 
  4694.           target. 
  4695.  
  4696. Project Smarts A project catalog that contains templates for common types of 
  4697.           applications. 
  4698.  
  4699. Project Smarts application A skeletal application that consists of template 
  4700.           source code and a configured project revolving around an application 
  4701.           theme. It serves as a starting point for similar applications. 
  4702.  
  4703. source directory A directory where a project's parts are physically stored. A 
  4704.           project may have many source directories. 
  4705.  
  4706. source type A source type appears in an action's list of source types. An 
  4707.           action's list of source types specifies the kind of parts or files to 
  4708.           which the action applies. 
  4709.  
  4710. target    A project's target is the file that is produced as a result of a 
  4711.           project build. 
  4712.  
  4713. target type A target type appears in an action's list of target types. Target 
  4714.           types only apply to actions that participate in a project build, such 
  4715.           as Compile and Link.  The Build tool and MakeMake utility use the 
  4716.           source and target types of build actions to determine the order in 
  4717.           which the actions should be run to produce the project's target. 
  4718.  
  4719. template  An object that you can use as a model to create other objects. When 
  4720.           you drag a template, you create a copy of the original object.  The 
  4721.           new object has the same settings and contents as the original 
  4722.           template object. 
  4723.  
  4724. Tools setup A view of a project where you can see and manipulate the actions, 
  4725.           types, and environment variables available to the project.  From this 
  4726.           view, you can add, delete, and change actions, types, and variables. 
  4727.           You can also set the options for any action in this view. 
  4728.  
  4729. type      In WorkFrame, describes a group of project files of parts in terms of 
  4730.           an expression, such as file masks, regular expressions, or a list of 
  4731.           other types, logical-OR'd. 
  4732.  
  4733. type class In WorkFrame, represents the method by which an object is determined 
  4734.           to be a member of a type.  "File mask" is an example of a type class. 
  4735.           Membership to a "File mask" type is determined by matching the file 
  4736.           mask filter to the object's name. Other examples of type classes are 
  4737.           "Regular expression", and "PAM Name", where the named Project Access 
  4738.           Method determines membership to a type. 
  4739.  
  4740.  
  4741. ΓòÉΓòÉΓòÉ <hidden> IDD_IWFOPT_UTIL_ERRLBOX ΓòÉΓòÉΓòÉ
  4742.  
  4743. Help for IDD_IWFOPT_UTIL_ERRLBOX, RES ID 212. 
  4744.  
  4745. No help text is available at this time. 
  4746.  
  4747.  
  4748. ΓòÉΓòÉΓòÉ <hidden> Prompt dialog ΓòÉΓòÉΓòÉ
  4749.  
  4750. Enter a command-line options string to be passed to the action. This string can 
  4751. contain substitution variables. 
  4752.  
  4753. If the action is file-scoped, the files that are selected when the action is 
  4754. executed are displayed in the Source files to use for this invocation list box. 
  4755. You can select which files are passed as command-line options by entering 
  4756. substitution variables in the options string and selecting one or more files in 
  4757. the list box. For example, if the options string uses the %f substitution 
  4758. variable, you can select one file name. If the options string uses the %a %z 
  4759. substitution variable, you can select multiple file names. 
  4760.  
  4761.  
  4762. ΓòÉΓòÉΓòÉ 10. Organizing projects ΓòÉΓòÉΓòÉ
  4763.  
  4764. Organizing your projects well is key to using the WorkFrame environment 
  4765. effectively.  The organization of your projects determines the way in which 
  4766. they are built, and the way in which make files are generated for your 
  4767. applications. 
  4768.  
  4769. Most of your applications will most likely consist of a hierarchy of projects, 
  4770. rather than a single project, unless they are very simple. It is important that 
  4771. your project hierarchy reflects the project targets and dependencies between 
  4772. components for builds to be performed correctly.  Follow these guidelines for a 
  4773. well-defined project hierarchy: 
  4774.  
  4775.  1. Create a separate project for each target or build path in your 
  4776.     application.  A target is defined as a single part or file that the project 
  4777.     will build, such as an executable file, dynamic link library, or help file. 
  4778.     A build path is a sequential processing of actions, with no conditional or 
  4779.     alternative routes, that produces a single target file.  Intermediate files 
  4780.     may also be produced during the processing of a build. 
  4781.  
  4782.     If your application consists of a two DLLs, a LIB, an EXE, and a HLP file, 
  4783.     for example, you should create a separate project for each DLL, the EXE, 
  4784.     the LIB, and the HELP file.  If LIBs are also produced from the DLLs, the 
  4785.     DLL and the LIB can be part of the same project.  The LIB would be the 
  4786.     designated target of the project, and the DLL is considered an intermediate 
  4787.     file.  In this example, you would create five projects in all. 
  4788.  
  4789.  
  4790.         Five projects in a sample application
  4791.  
  4792.  2. After you have created the projects, determine the dependencies that exist 
  4793.     between them. 
  4794.  
  4795.     For example, the DLLs may depend on the LIB, and the EXE depends on the 
  4796.     DLLs.  Also determine the project that is at the root of the dependency 
  4797.     hierarchy, that is, the project that has no dependents.  In this example, 
  4798.     it is the EXE. 
  4799.  
  4800.  3. Nest the projects to reflect the dependency tree.  That is, if a project 
  4801.     EXE depends on another project DLL, place project DLL into project EXE. 
  4802.     Project DLL is then said to be nested within project EXE.  A project is 
  4803.     nested in another project when its physical file is located in one of the 
  4804.     source directories of the nesting project. 
  4805.  
  4806.     You can move a project into another project by dragging it or by selecting 
  4807.     Move from its pop-up menu. 
  4808.  
  4809.     Note: 
  4810.  
  4811.     a. When you move a project into another project, you are actually moving 
  4812.        the nested project's physical file into the nesting project's working 
  4813.        directory.  So if you move a project into another project using the Move 
  4814.        pop-up menu item, you will need to specify one of the parent project's 
  4815.        source directories as the target in the Move dialog. 
  4816.  
  4817.     b. When you move a project, you don't need to move its parts as well 
  4818.        because the project does not actually contain its parts, but only a 
  4819.        reference to their location. 
  4820.  
  4821.     In a situation where two or more projects (say First DLL/LIB and Second 
  4822.     DLL/LIB) depend on the same project LIB, nest one of the two depending 
  4823.     projects within the other (say, nest Second DLL/LIB within First DLL/LIB), 
  4824.     and then nest the mutual dependency project LIB within project Second 
  4825.     DLL/LIB. 
  4826.  
  4827.  
  4828.         Projects First DLL/LIB and Second DLL/LIB depend on project LIB
  4829.  
  4830.     The root project in the dependency tree will directly or indirectly contain 
  4831.     all the other projects in the application. 
  4832.  
  4833.     Example 
  4834.  
  4835.     Consider the example application that consists of an EXE, two DLLs, a LIB, 
  4836.     and a HLP file.  The two DLLs depend on the LIB, the EXE depends on the 
  4837.     DLLs and the HLP file.  The LIB and HLP files do not depend on any other 
  4838.     targets.  The project hierarchy would look like the one in the following 
  4839.     figure. 
  4840.  
  4841.  
  4842.         Project hierarchy of a sample application
  4843.  
  4844.     The EXE project is the root project that contains all the other projects. 
  4845.     First DLL/LIB and Second DLL/LIB both depend on the LIB, so one nests the 
  4846.     other before nesting the LIB project.  The two DLLs also produce a LIB file 
  4847.     each, so the specified target of each DLL project is a LIB file, because it 
  4848.     is the final file produced by a build. 
  4849.  
  4850.     You should nest projects this way because the WorkFrame Build utility 
  4851.     infers the build sequence from the project hierarchy.  When you use the 
  4852.     Build utility to build a project, you have the option of having it build 
  4853.     descendant projects first. Following this scheme ensures that a project's 
  4854.     descendants contain the current project's dependencies. 
  4855.  
  4856.  4. All the files used by the projects in your application can be stored in one 
  4857.     or more directories.  For example, all the source files to build the DLLs 
  4858.     and LIBs could be stored in one directory, all the source files for the EXE 
  4859.     in another, and all the HLP files in a third or fourth directory. 
  4860.  
  4861.     Nesting Note  If you store the files for each project in a different 
  4862.                   directory, the target of a nested project is not 
  4863.                   automatically considered a part of the nesting project.  You 
  4864.                   must include the directory that contains the required target 
  4865.                   in the source directories list of the nesting project.  As a 
  4866.                   better alternative, you could define an environment variable 
  4867.                   in the nesting project so that the required target is 
  4868.                   available.  For example, the EXE project could define the LIB 
  4869.                   environment variable in its Tools setup to contain the 
  4870.                   working directory path of the LIB project whose target it 
  4871.                   depends on. 
  4872.  
  4873.     For example, if the First DLL/LIB project's files are stored in a different 
  4874.     directory from the EXE project, say in D:\MYAPP\LIB1, the EXE project must 
  4875.     define the LIB environment variable to contain that directory so that the 
  4876.     Link action is able to find the required library file: 
  4877.  
  4878.           LIB=D:\MYAPP\DLL1;%LIB%
  4879.  
  4880.      Tip 
  4881.  
  4882.      Your project's directory structure does not have to mimic your project 
  4883.      organization.  A project can contain source files that are stored in 
  4884.      multiple directories.  For example, two projects that build two different 
  4885.      targets from the same source files can share one or more source 
  4886.      directories, but have separate working directories. 
  4887.  
  4888.      If your project has any header files that are stored in directories other 
  4889.      than the project's working directory, you should define the INCLUDE 
  4890.      environment variable to reference the header files.  Add the INCLUDE 
  4891.      variable to the project's Tools setup so that it is set in any 
  4892.      WorkFrame-generated make files. 
  4893.  
  4894. Project Geometry 
  4895.  
  4896. To put things into perspective for you, this section discusses three different, 
  4897. but simultaneous structures that a project can maintain: two conceptual, and 
  4898. one physical. 
  4899.  
  4900. Inheritance 
  4901.      An inheritance graph of all the projects in your system would connect 
  4902.      lines between the projects that inherit their Tools setup from each other. 
  4903.      If you can think of a project's actions, types, and environment variables 
  4904.      as its "behavior", you can say that the projects in an inheritance graph 
  4905.      borrow their behavior from one another. 
  4906.  
  4907. Nesting 
  4908.      A nesting graph of all the projects in your system would be in the form of 
  4909.      a tree, and would connect lines between projects and their subprojects. 
  4910.      The organization of a project expresses the interdependency relationships 
  4911.      that exist between itself and its descendants.  This kind of project 
  4912.      structure is very important for setting up project builds using the 
  4913.      WorkFrame Build utility. 
  4914.  
  4915.      The Build utility allows its options to be passed to a project's 
  4916.      descendants, or borrowed from a parent project. Although this resembles an 
  4917.      inheritance relationship, it is distinct from it.  Build settings can only 
  4918.      be passed down to nested projects, or assumed from a containing project. 
  4919.      The projects participating in an inheritance relationship with the current 
  4920.      project are not involved. 
  4921.  
  4922. Directories 
  4923.      The source directories of a project determine a project's parts. The 
  4924.      source directories of a project can mimic its nesting structure, or serve 
  4925.      a different organizational purpose, such as grouping files by type.  For 
  4926.      example, private and public header files could be stored in separate 
  4927.      directories from the rest of the source. 
  4928.