home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / owf.zip / wf.HLP (.txt) < prev    next >
OS/2 Help File  |  1997-05-04  |  43KB  |  1,310 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About Object WorkFrame ΓòÉΓòÉΓòÉ
  3.  
  4. Object WorkFrame 
  5.  
  6. Version 2.0 
  7.  
  8. Object WorkFrame is a workframe for C++/Java-programmers, HTML-developers and 
  9. others who use projects based on files. It contains a MakeMake utility which 
  10. creates makefiles automaticaly and a class browser for C++ and Java code. 
  11.  
  12. To get full access to the fuctionality of Object WorkFrame an editor is needed 
  13. which support DDE (like EPM 6.x or Mr. Ed 1.16 or higher). 
  14.  
  15. You can customize Object WorkFrame in a simple way using a PM-utility. Error 
  16. messages from 
  17.  
  18.      EMX/GCC-compiler 
  19.      VisualAge C++ / CSet ++ compiler ICC 
  20.      Resource compiler (RC) 
  21.      Compiler for online documents (IPFC) 
  22.      VisualAge make utility (NMake) 
  23.      other make utilities like DMake, GNU Make 
  24.      Java compiler 
  25.  are supported (see monitor-window). 
  26.  
  27.  Object WorkFrame is developed with the Open Object Library (OOL), a C++ 
  28.  class-library which makes PM-programming a little bit easier. Object WorkFrame 
  29.  needs Warp 3 or higher. 
  30.  
  31.  Object WorkFrame is SHAREWARE until you have registered: 
  32.  
  33.      You are not allowed to sell or commercially distribute the Object 
  34.       WorkFrame or any part of it. If you want to distribute the Object 
  35.       WorkFrame commercialy you have to apply the authors permission. 
  36.  
  37.      You have a time-limit of one month to test/use Object WorkFrame. After 
  38.       one month testing you are not allowed to use Object WorkFrame. 
  39.       Additionaly the class browser is restricted, only 10 classes are parsed, 
  40.       more than 10 classes are not displayed. 
  41.  
  42.      Only registered users of Object WorkFrame will receive help from the 
  43.       author. 
  44.  
  45.  In some dialogs of Object WorkFrame a few windows are disabled. These windows 
  46.  are only enabled in Object WorkFrame Pro which contains a REXX-interface for 
  47.  programming Object WorkFrame. 
  48.  
  49.  Please send your bug-reports via EMail to: sbrauk@gwdg.de 
  50.  
  51.  (c)opyright Stefan von Brauk, 1996,1997 
  52.  
  53.  
  54. ΓòÉΓòÉΓòÉ 2. Register Object WorkFrame ΓòÉΓòÉΓòÉ
  55.  
  56. If you are a registered user of Object WorkFrame: THANK YOU! 
  57.  
  58. If you are not and wan╤Åt to become a registered user do the following: 
  59.  
  60.    1. Send 50 US$, 80 DM or 80 SFR to the author (check or money, money 
  61.       prefered): 
  62.  
  63.         Stefan von Brauk 
  64.         Lotzestr. 53 
  65.         37083 Goettingen 
  66.         Germany 
  67.  
  68.    2. or transfer 50 US$, 80 DM or 80 SFR to my acount at 
  69.         Postbank Hannover (Germany) 
  70.         BLZ 250 100 30 
  71.         Konto 568515307 
  72.  
  73.    3. Additionaly you send your EMail-adress and you will get the next 2 
  74.       updates of Object WorkFrame via EMail (SnailMail no Update). 
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ 3. Program setup ΓòÉΓòÉΓòÉ
  78.  
  79. If you start Object WorkFrame the first time, you have to: 
  80.  
  81.      Specify your text editor 
  82.      Edit the menu entrys 
  83.      Edit the list file 
  84.      Configurate class browser files 
  85.      Setup your compiler settings 
  86.      Changing fonts 
  87.  
  88.  You cannot start Object WorkFrame directly (e.g. with a double-click on the 
  89.  icon of the program). Object WorkFrame only starts with a double click on a 
  90.  Object WorkFrame datafile created with the Object WorkFrame template! 
  91.  
  92.  
  93. ΓòÉΓòÉΓòÉ 3.1. Specify Editor Settings ΓòÉΓòÉΓòÉ
  94.  
  95. To change the settings for your editor you open the editor settings dialog 
  96. (menuentry Options\Editor Settings). In the dialog you have to: 
  97.  
  98.      Enter the name of your editors exe-file, you should enter the full 
  99.       qualified path. 
  100.  
  101.      Enter the arguments your editor need. You can also enter the joker "%s" 
  102.       so all files selected in the file window will be passed to the editor. 
  103.  
  104.      Check if your editor is EPM 6.x or Mr. Ed 1.16 or higher or an other 
  105.       editor. If you use EPM Mr. Ed 1.16 you should check the related buttons 
  106.       so Object WorkFrame can communicate with the editor (e.g. show 
  107.       errormessages from the compiler). 
  108.  
  109.  Additionaly it is possible to enter special DDE-commands, the default values 
  110.  should work with EPM/Mr.Ed 
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ <hidden> Menus ΓòÉΓòÉΓòÉ
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 3.2. Setup menus ΓòÉΓòÉΓòÉ
  117.  
  118. You can customize the menus and the toolbar of the Object WorkFrame with a tool 
  119. you access under <Options\Menu Setup>. On default Object WorkFrame has only a 
  120. few menu entrys, all other menu entrys you see are inserted with MenuSetup. 
  121. This entrys are saved in a configuration file of Object WorkFrame. 
  122.  
  123. If you see a lot of menu entrys (I hope you do so) an example configuration 
  124. file of Object WorkFrame is loaded which shows you how to involve tools, 
  125. applications and online-documentation in the Object WorkFrame. In this case the 
  126. tools and documentation involved by Object WorkFrame are from IBMs Visual Age 
  127. C++, so if you use a different development environment read the following 
  128. carefuly to invoke your development tools in a correct manner. Because the 
  129. sample configuration uses paths it is nessecary you modify the menu entrys to 
  130. make Object Workframe work with your development tools. 
  131.  
  132. An example to invoke EMX/GCC into Object WorkFrame is also avaible. To use this 
  133. example instead the VisualAge C++ example you have to: 
  134.  
  135.    1. Close all instances of Object WorkFrame 
  136.    2. Rename the file <WF.CFG> to <WF.SAV> 
  137.    3. Rename the file <EMX.CFG> to <WF.CFG> 
  138.    4. Start Oject WorkFrame 
  139.  
  140.  There is also a sample file how to use Java-tools (the JDK must be installed), 
  141.  if you want to work with this configuration: 
  142.  
  143.    1. Close all instances of Object WorkFrame 
  144.    2. Rename the file <WF.CFG> to <WF.SAV> 
  145.    3. Rename the file <JAVA.CFG> to <WF.CFG> 
  146.    4. Start Oject WorkFrame 
  147.  
  148.  It is possible to use multiple configurations. Usualy the configuration is 
  149.  loaded from WF.CFG in the install-directory. You can specify a configuration 
  150.  for a single project by 
  151.  
  152.      Edit the menu 
  153.  
  154.       Closing the menu-editor you will be asked to save your changes "global" 
  155.       or for the project only. In the second case a configuration-file will be 
  156.       created for your project. 
  157.  
  158.      Copy a configuration 
  159.  
  160.       You can also copy a configuration from another project. E.g. if you have 
  161.       a project with "sample1.mak" as the makefile and want to copy the 
  162.       configration to a project with "sample2.mak", copy the file "sample1.cfg" 
  163.       to the directory of the second project and rename there "sample1.cfg" to 
  164.       "sample2.cfg". 
  165.  
  166.  The following entrys describe how to 
  167.  
  168.      Modify an entry 
  169.      Add an entry 
  170.      Delete an entry 
  171.      Save the menus 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 3.2.1. Modify an entry ΓòÉΓòÉΓòÉ
  175.  
  176. The first thing you might want to do is to change an entry, perhaps the make 
  177. utility. The menu entry which is created for this case in the configuration 
  178. file is <Action/Make>. 
  179.  
  180. To change the entry, open MenuSetup. You see two trees (the main menu and the 
  181. context-menu). Three trees show all menu items in the hirarchy of the original 
  182. menus. Now expand the tree for the main menu until you see <Make>. Open the 
  183. entry with a double click (you can only edit menuentrys which are displayed 
  184. with a green key). You╤Åll get a dialog which shows the current settings of the 
  185. menu entry. In this example the menu title <Make> is displayed, the program 
  186. which is called is NMake. Now you can change the given options to values you 
  187. need. 
  188.  
  189. For details of the options please reffer to the online help of the dialog. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ 3.2.2. Add an entry ΓòÉΓòÉΓòÉ
  193.  
  194. In the second step you may want to add a menu entry. You have three methods to 
  195. add one: 
  196.  
  197.      Separators 
  198.  
  199.       You can add a separator line to the menu. Select an entry, open the popup 
  200.       menu and select <New/Separator>. A separator will be inserted behind the 
  201.       selected entry. 
  202.  
  203.      Siblings 
  204.  
  205.       You can add a sibling separator. Select an entry an select <New/Sibling 
  206.       entry> from the popup menu. The dialog for item settings appears and you 
  207.       can enter the settings you need. For details of the settings please 
  208.       reffer to the online help of the dialog. If the new entry should be a 
  209.       submenu (means it will get child entrys), its only nessecary to enter the 
  210.       title of the new entry. 
  211.  
  212.      Childs 
  213.  
  214.       You can add child entrys. Select an entry and select <New/Child entry> 
  215.       from the popup menu and perform like above. The selected menu entry will 
  216.       get an arrow, the new entry will be displayed in the submenu. 
  217.  
  218.  
  219. ΓòÉΓòÉΓòÉ 3.2.3. Delete an entry ΓòÉΓòÉΓòÉ
  220.  
  221. To delete a menu entry, select the entry and chose <Delete> from the popup 
  222. menu. You can only delete menu items which are displayed with a green key. 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 3.2.4. Save the menus ΓòÉΓòÉΓòÉ
  226.  
  227. if you have edited the menus you will be asked if you want to save your 
  228. changes. You have the choice to save the settings as: 
  229.  
  230.      Project configuration 
  231.  
  232.       Save the settings local. All settings are only in use for your opened 
  233.       project. The settings are saved in a file named like your makefile with 
  234.       the suffix "*.CFG" in your project directory. If you rename your makefile 
  235.       you must rename the "*.CFG"-file too to access your menu setup. Otherwise 
  236.       Object WorkFrame will start up with your global settings. 
  237.      Global configuration 
  238.  
  239.       Save the settings global. All settings are avaible in every project which 
  240.       does not have a local configuration file. 
  241.  
  242.  Changes to the toolbar will be visible when you restart Object WorkFrame. 
  243.  
  244.  
  245. ΓòÉΓòÉΓòÉ 3.3. Edit the Listfile ΓòÉΓòÉΓòÉ
  246.  
  247. You can edit the list-file (file WF.LST in the installation directory of Object 
  248. WorkFrame) to chose which filemask should be displayed in the combobox of the 
  249. toolbar. An entry in WF.LST has the following format: 
  250.  
  251. name\mask1;mask2;... 
  252.  
  253. where name is the title to display in the combobox, mask1;mask2;... are the 
  254. filemasks for files to display in the file-window, for example: 
  255.  
  256. HTML\*.htm;*.html 
  257.  
  258. shows an entry "HTML" in the combobox, if selected, all files of your 
  259. project-directory(s) matching *.htm and *.html are displayed. 
  260.  
  261. If you have edited the list file you must restart Object WorkFrame. 
  262.  
  263.  
  264. ΓòÉΓòÉΓòÉ 3.4. Configurate class browser files ΓòÉΓòÉΓòÉ
  265.  
  266. C++ only: The class browser of Object WorkFrame uses a helping file which 
  267. contains filenames of standard header files not to scan like files of the 
  268. C-library (stdio.h etc) and the include files for PM-programming (os2.h...), 
  269. this is usefull to improve performance. 
  270.  
  271. If you want to specify files which should not be scaned too to make the browser 
  272. faster (or you don╤Åt need that information) you can add the filenames to the 
  273. file "neglist.lst" which you can find in the install-directory of Object 
  274. WorkFrame. Add the filename(s) using CAPITALS, each file on a separate line. 
  275.  
  276. If you use one or more class-librarys on default they will be scaned and 
  277. displayed too. Because a class library contains lot of header files which must 
  278. be added to the "neglist.lst" to supress scanning, a litle tool called 
  279. "neglist.exe" is shiped with Object WorkFrame. On the commandline change to the 
  280. include-path of the library and call "neglist.exe" which one argument like 
  281. "*.h" or "*.h*". "neglist.exe" will produce a file called "neglist.tmp" which 
  282. contains all files found. Just add the content of the file with a text editor 
  283. to "neglist.lst" so the library will not be scanned any longer. If the browser 
  284. still shows the content of the library you should delete the class browser file 
  285. (the name of the makefile  with suffix "*.cw") and rebuild your application. 
  286.  
  287. Warning: Some librarys resolve name of header files with defines like 
  288.  
  289. #define Application_i  "app.h" 
  290.  
  291. In this case there exists a file which contains these definitions. That file 
  292. shouldn╤Åt be added to "neglist.lst", otherwise Object WorkFrame may throw some 
  293. errors when scanning files which use these defines. 
  294.  
  295.  
  296. ΓòÉΓòÉΓòÉ 3.5. Setup your compiler settings ΓòÉΓòÉΓòÉ
  297.  
  298. Object WorkFrame and MakeMake are working compiler independent. From this 
  299. reason the programs are using INI-files for the compiler/linker settings, you 
  300. can find them in the installation directory of Object WorkFrame and edit them 
  301. with a text-editor. 
  302.  
  303. These INI-files give you the chance to 
  304.  
  305.    1. decide yourself (eg. to optimize) which compiler and/or linker switch is 
  306.       enabled by MakeMake when an option in the compiler/linker settings 
  307.       notebook of MakeMake is enabled 
  308.  
  309.    2. You can invoke a compiler of your choice: copy the IBM_CPP.INI file and 
  310.       replace the settings made there with the settings needed for your 
  311.       compiler 
  312.  
  313.  On default the settings follow this format: 
  314.  
  315.  VARNAME=CFLAGS(/option) LINK(/option) 
  316.  
  317.  where the options in the brakets are used for the compiler / linker. You can 
  318.  enter both statements, one or none of them. If you don╤Åt enter a statement you 
  319.  cannot select this option in the notebook for compiler/linker settings. If you 
  320.  want to select the option but nothing should be added to the compiler/linker 
  321.  settings, enter the following line 
  322.  
  323.  VARNAME=EMPTY 
  324.  
  325.  There are some lines in the INI-file which are a little bit more complicated: 
  326.  
  327.      NAME='IBM ICC' 
  328.       this is the name which is displayed in the compilers combobox 
  329.  
  330.      COMPILER=icc.exe 
  331.       the 'true' name (the compilers exe-file) 
  332.  
  333.      LINKER='icc.exe /B"%options"' 
  334.       the linker. In this case icc does the job to invoke the linker. 
  335.       '%options' will be replaced with the linkers settings selected in the 
  336.       notebook 
  337.  
  338.      DEFAULT_CFLAGS = /C 
  339.       flags for the compiler which should always be used 
  340.  
  341.      LIB=LIB 
  342.       the name of the environment variable of your config.sys which shows the 
  343.       path for librarys to use 
  344.  
  345.      INCLUDE=INCLUDE 
  346.       the name of the environment variable of your config.sys which shows the 
  347.       path for header-files to use 
  348.  
  349.  
  350. ΓòÉΓòÉΓòÉ 3.6. Changing fonts ΓòÉΓòÉΓòÉ
  351.  
  352. You can change the used fonts of the file-, monitor- or classbrowser windows by 
  353. drag/drop a font on it, the settings will be stored. 
  354.  
  355.  
  356. ΓòÉΓòÉΓòÉ <hidden> Project ΓòÉΓòÉΓòÉ
  357.  
  358.  
  359. ΓòÉΓòÉΓòÉ 4. Create a new project ΓòÉΓòÉΓòÉ
  360.  
  361. To create a new project drop the Object WorkFrame template on a place of your 
  362. workplace and open it with a double-click. A dialog for a new project will 
  363. apear where you can select: 
  364.  
  365.      The AppAssistant lets you select one new project from a list of 
  366.       predefined projects 
  367.  
  368.      With Import it is possible to import a project or to create an empty 
  369.       project 
  370.  
  371.  
  372. ΓòÉΓòÉΓòÉ 5. AppAssistant ΓòÉΓòÉΓòÉ
  373.  
  374. The AppAssistant shows a list of predefined applications (project templates) 
  375. which can be used for building a new application/project. The list of 
  376. predefined projects is currently a litle bit small (if you don╤Åt use the Open 
  377. Objects Library) but you can create your own project templates. 
  378.  
  379. AppAssistant lets you 
  380.  
  381.    1. select the type of application 
  382.  
  383.    2. select if menus and/or online-help is needed 
  384.  
  385.    3. set the name and required paths 
  386.  
  387.  For more information see the online-help of AppAssistant. 
  388.  
  389.  
  390. ΓòÉΓòÉΓòÉ 6. Create project templates ΓòÉΓòÉΓòÉ
  391.  
  392. Currently the Object WorkFrame brings only a few project templates. From this 
  393. reason you may want to create new project-templates, please read the folowing 
  394. carefully: 
  395.  
  396.      Each project template resides in a single directory, this directorys must 
  397.       reside in the subdirectory <\template> which is created during the 
  398.       installation of Object WorkFrame. 
  399.  
  400.      Each project has a <KEYWORD> which is defined by the name of the 
  401.       directory the template resides in, e.g. the project templates delivered 
  402.       with this packages have the <KEYWORDS> pm1, pm2 etc. If the user ceates a 
  403.       new prroject with this project the content of the directory will be 
  404.       copied to the new directory, the <KEYWORDS> will be replaced the name of 
  405.       the new project! 
  406.  
  407.      The <KEYWORDS> are also used for filenames and in the files themselfs, 
  408.       e.g. to identify a process or window. Example: 
  409.  
  410.         1. In the subdirectory pm1 you find pm1.cpp, pm1.h etc 
  411.         2. If copied to a new directory the files are renamed with the new 
  412.            title eg. MyApp so you have now MyApp.cpp, MyApp.h etc 
  413.         3. Fiinished that the files are scaned for the keyword pm1, this text 
  414.            will be replaced with MyApp. If there is eg. pm1Win it is now 
  415.            MyAppWin, pm1File changes to MyAppFile etc. 
  416.  
  417.      There are also some information files in the directorys 
  418.  
  419.        <KEYWORD>.bmp is the bitmap shown in the listbox of AppAssistant 
  420.  
  421.        <KEYWORD>.dsc contains following information which is used by 
  422.       AppAssistant: 
  423.  
  424.         1. In the first line are keywords which shows which options for the 
  425.            project are supported, keywords are 
  426.              a. HELP online help supported 
  427.              b. MENU menus supported 
  428.         2. The text of the second line is shown in the listbox of AppAssistant 
  429.         3. The text of the third line following is shown if the user press the 
  430.            button <Info> in the AppAssistant-dialog 
  431.  
  432.      Depending of the users selection some code-blocks are removed 
  433.  
  434.         1. If the user didnt select HELP from AppAssisstant, code-blocks 
  435.            beginning with the keyword /HELP are removed until keyword HELP/, if 
  436.            the user selected HELP theis keywords are removed from the source. 
  437.         2. If the user didnt select MENU from AppAssisstant, code-blocks 
  438.            beginning with the keyword /MENU are removed until keyword MENU/, if 
  439.            the user selected MENU theis keywords are removed from the source. 
  440.  
  441.  
  442. ΓòÉΓòÉΓòÉ 7. Import an existing project ΓòÉΓòÉΓòÉ
  443.  
  444. To import a project drop the Object WorkFrame template on a place of your 
  445. workplace and open it with a double-click. A dialog for a new project will 
  446. apear, select <Import>. In the next dialog select <Browse> to open the 
  447. file-select dialog. Select the directory and the makefile of the project which 
  448. should be imported. The name of the makefile and the path will be shown int the 
  449. dialog. Now you have to 
  450.  
  451.      Enter the name of the compilers output-file (e.g sample1.exe, test.dll), 
  452.       optional if you dont work with a makefile. 
  453.  
  454.      Enter the arguments to start the output-file with (optional). 
  455.  
  456.      Specify directorys to display additionaly (optional). See using multiple 
  457.       directories for details 
  458.  
  459.  Close the dialog by pushing <OK>, Object WorkFrame will scan the directory for 
  460.  files and show them in the file window. Now you should create a basic 
  461.  makefile: 
  462.  
  463.    1. Select "Debug" in the second combobox of the toolbar 
  464.  
  465.    2. Call "MakeMake" 
  466.  
  467.    3. Select there your compiler, your make utility, the files to use in the 
  468.       makefile, actions to perform etc. 
  469.  
  470.    4. Push <Settings> to select there the compiler/linker settings to use for 
  471.       DEBUG mode 
  472.  
  473.    5. Select <Create> to build a new makefile and save it. 
  474.  
  475.    6. Close "MakeMake" and select "Release" in the second combobox of the 
  476.       toolbar 
  477.  
  478.    7. Call "MakeMake" again, the actions and files you have selected will be 
  479.       displayed 
  480.  
  481.    8. Push <Settings> to select there the compiler/linker settings to use for 
  482.       RELEASE mode 
  483.  
  484.    9. Save the makefile and close "MakeMake" 
  485.  
  486.  Now you can switch between DEBUG, BETA and RELEASE before calling your make 
  487.  utility, it will automaticaly use the correct compiler/linker settings (see 
  488.  DEBUG/BETA/RELEASE for details). 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 8. Using multiple projects/directorys ΓòÉΓòÉΓòÉ
  492.  
  493. If you are creating more complex applications Object WorkFrame can support you 
  494. in two ways 
  495.  
  496.    1. Show multiple directorys 
  497.  
  498.       On default only the content of the main directory (the directory where 
  499.       the makefile resides) is shown. To show the contents of more directorys 
  500.       open the project settings where you can enter other directorys to display 
  501.       additionaly (slows down performance of Object WorkFrame). 
  502.  
  503.       If you drop files ont the file-window the dropped files will always be 
  504.       moved/copied to the main directory! 
  505.  
  506.    2. Using mulitple makefiles 
  507.  
  508.       MakeMake allows you to invoke other makefiles to the project makefile. 
  509.       These makefiles are executed before any other action of the project 
  510.       makefile is executed. So it is possible to create at first one or more 
  511.       simple project, where each of it creates a single part of your target 
  512.       application, eg. a library/DLL. Finaly you create the main project and 
  513.       include the makefiles of the projects created before. 
  514.  
  515.       You can also create the main project first and then include/create new 
  516.       makefiles for parts of your project without creating single project (see 
  517.       help from MakeMake for details). 
  518.  
  519.  
  520. ΓòÉΓòÉΓòÉ 9. Window Functions ΓòÉΓòÉΓòÉ
  521.  
  522. The main window contains a main menu, a toolbar, and a client area. The client 
  523. area is split in a file window and a monitor window. 
  524.  
  525.  
  526. ΓòÉΓòÉΓòÉ 9.1. Main Menu ΓòÉΓòÉΓòÉ
  527.  
  528. On default the main menu contains only a few menu items 
  529.  
  530.      "Project Settings" shows the dialog for the project-setup 
  531.      "MakeMake" is the utility shipped with Object WorkFrame to create 
  532.       make-files 
  533.      "Editor Settings" shows the dialog for the editor-setup 
  534.      "Menu Setup" shows the dialog to edit the menus 
  535.      Som help-entries 
  536.  
  537.  All other menu entys are created with MenuSetup, see there to create you own 
  538.  menu entrys. 
  539.  
  540.  
  541. ΓòÉΓòÉΓòÉ 9.2. Toolbar ΓòÉΓòÉΓòÉ
  542.  
  543. The toolbar of Object WorkFrame contains on default this controls: 
  544.  
  545.    1. A combobox with different entrys for often used filetypes, every entry 
  546.       hides one or more filemasks (e.g. Bitmap = *.bmp, CSource = *.c, *.cpp). 
  547.       You can select one of these entrys and every file in your 
  548.       project-directory which matchs the filemask will be shown in the 
  549.       file-window. 
  550.       You can also enter one or more filemasks in the combobox directly: 
  551.  
  552.       *.c 
  553.  
  554.       *.c;*.cpp;*.h;*.hpp 
  555.  
  556.       The default file-masks displayed in the combo-box are defined in WF.LST, 
  557.       to customize Object WorkFrame you can edit the list-file. 
  558.  
  559.    2. The second combo box allows you to switch from debug-mode, beta-mode, 
  560.       release-mode and back. To do so the MakeMake utility shiped with Object 
  561.       WorkFrame defines a macro in the makefile, the make-utility is called 
  562.       with a statement which shows the make-utility, if it should chose the 
  563.       settings for debug-, beta- or release mode building your application. See 
  564.       DEBUG/RELEASE/BETA for details. 
  565.  
  566.    3. The stop-button is used for programs started with Object Workframe 
  567.       monitored. To stop the monitored program you just need to press the 
  568.       stop-button and the monitored programm will be terminated. 
  569.  
  570.  All other toolbar buttons are created with MenuSetup, see there to create you 
  571.  own toolbar buttons. 
  572.  
  573.  
  574. ΓòÉΓòÉΓòÉ 9.3. File Window ΓòÉΓòÉΓòÉ
  575.  
  576. The file window displays the files found with the filemask selected in the 
  577. combo-box. The window supports drag/drop, direct editing for filenames 
  578. (ALT+mousebutton 1) and offers a context menu. You can open displayed files 
  579. with following methods: 
  580.  
  581.      With a double-click on a file the editor is started to load the file 
  582.       except exe-files which are executed directly. 
  583.  
  584.      Select Open\default from the context-menu of the file window will start 
  585.       the file on the way your operating-system prefers (e.g. if you have 
  586.       associated *.htm-files with the WebExplorer and select a *.htm file the 
  587.       WebExplorer will start to show the file). 
  588.  
  589.  See using multiple directories for details if you have specified multiple 
  590.  directories to display. 
  591.  
  592.  
  593. ΓòÉΓòÉΓòÉ 9.3.1. Context Menu ΓòÉΓòÉΓòÉ
  594.  
  595. You acccess the context-menu of the file-window on default with your right 
  596. mouse-button. The context-menu has following entrys: 
  597.  
  598. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  599. ΓöéOpen         Γöéopens a selected    Γöé
  600. Γöé             Γöéfile with the editorΓöé
  601. Γöé             Γöé(default)           Γöé
  602. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  603. ΓöéOpen\Editor  Γöéopens a selected    Γöé
  604. Γöé             Γöéfile with the editorΓöé
  605. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  606. ΓöéOpen\default Γöéopens a selected    Γöé
  607. Γöé             Γöéfile with the       Γöé
  608. Γöé             Γöéassociated program  Γöé
  609. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  610. ΓöéSettings     Γöéopens the           Γöé
  611. Γöé             Γöésettings-notebook ofΓöé
  612. Γöé             Γöéthe selected file   Γöé
  613. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  614. ΓöéRefresh      Γöérescans the projet  Γöé
  615. Γöé             Γöédirectory for files Γöé
  616. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  617. ΓöéSelect\All   Γöéall displayed files Γöé
  618. Γöé             Γöéare selected        Γöé
  619. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  620. ΓöéSelect\None  Γöéall displayed files Γöé
  621. Γöé             Γöéare de-selected     Γöé
  622. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  623. ΓöéView\Icon    Γöéfiles are displayed Γöé
  624. Γöé             Γöéin icon-view        Γöé
  625. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  626. ΓöéView\Name    Γöéfiles are displayed Γöé
  627. Γöé             Γöéin name-view        Γöé
  628. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  629. ΓöéView\Text    Γöéfiles are displayed Γöé
  630. Γöé             Γöéin text-view        Γöé
  631. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  632. ΓöéView\Detail  Γöéfiles are displayed Γöé
  633. Γöé             Γöéin detail-view      Γöé
  634. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  635. ΓöéView\Toolbar Γöéshow/hide the       Γöé
  636. Γöé             Γöétoolbar             Γöé
  637. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  638. ΓöéFind...      Γöéenables the Finder  Γöé
  639. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  640.  
  641. You can add menu-entrys to the context-menu with MenuSetup 
  642.  
  643.  
  644. ΓòÉΓòÉΓòÉ 9.4. Monitor Window ΓòÉΓòÉΓòÉ
  645.  
  646. The monitor-window displays the output from programs which are started 
  647. monitored (e.g. compilers). The window contents will be erased every time you 
  648. start such a program. 
  649.  
  650. Object WorkFrame supports error-messages if you use EPM 6.x or Mr.Ed 1.16 (or 
  651. higher) from: 
  652.  
  653.      ICC (IBM╤Ås C/C++ compiler) 
  654.      EMX/GCC (GNU C/C++ compiler-port from E. Mattes) 
  655.      RC, the resource-compiler 
  656.      IPFC, the IPF-compiler 
  657.      NMake/GNU Make/DMake if the message contains a line number 
  658.      Javac, the Java compiler 
  659.  
  660.  That means if you double-click on an error-message which contains a 
  661.  line-number, Object WorkFrame tells the editor to show the file and the line 
  662.  where the error occured, additionaly the editor shows the compiler╤Ås 
  663.  error-message in the status-line. 
  664.  
  665.  
  666. ΓòÉΓòÉΓòÉ 9.5. Class browser window ΓòÉΓòÉΓòÉ
  667.  
  668. The class browser shows the recognized classes and their member-functions. The 
  669. bitmaps shown in the window have the following meaning: 
  670.  
  671. Class 
  672. Abstract class (Java) 
  673. Abstract member function (Java) 
  674. Public member function 
  675. Protected member function 
  676. Private member function 
  677. Static member function 
  678. Included project 
  679.  
  680. With a double-click on a class the definition of the class will be loaded in 
  681. the editor, a double-click on a member function will load the implementation 
  682. code. 
  683.  
  684. The class browser 
  685.  
  686.      cannot show local/global variables 
  687.  
  688.      cannot show non-member functions 
  689.  
  690.      cannot show local classes 
  691.  
  692.      has problems with the STL (Standard Template Library) and other intesive 
  693.       usage of C++-templates 
  694.  
  695.      has problems with #defines, because it is no compiler it does not resolve 
  696.       your defines, eg. if the following code is given: 
  697.  
  698.       #ifdef _BLA_BLA_ 
  699.         void myFunc( void * param1) 
  700.       #else 
  701.         void myFunc( ) 
  702.       #endif 
  703.       you see both functions in the class brower. 
  704.  
  705.  For other actions you can access a local popup menu 
  706.  
  707.  To invoke the class browsers utilitys which generats the needed information 
  708.  see creating class browser information. See also configurate class browser 
  709.  files. 
  710.  
  711.  
  712. ΓòÉΓòÉΓòÉ 9.5.1. Context menu ΓòÉΓòÉΓòÉ
  713.  
  714. The class browser window has its own context menu, you access it with a click 
  715. with the right mouse-button on an item. The context menu has following 
  716. contents: 
  717.  
  718. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  719. ΓöéShow         ΓöéShow the            Γöé
  720. Γöédefinition   Γöéimplementation of a Γöé
  721. Γöé             Γöémember function     Γöé
  722. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  723. ΓöéShow         ΓöéShow the declarationΓöé
  724. Γöédeclaration  Γöéof the class/member Γöé
  725. Γöé             Γöéfunction (obsolete  Γöé
  726. Γöé             Γöéfo Java)            Γöé
  727. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  728. ΓöéList         ΓöéShow the list of allΓöé
  729. Γöé             Γöéscanned classes     Γöé
  730. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  731. ΓöéTree         ΓöéShow the derivation Γöé
  732. Γöé             Γöéof all scanned filesΓöé
  733. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  734.  
  735.  
  736. ΓòÉΓòÉΓòÉ <hidden> using DEBUG/RELEASE/BETA ΓòÉΓòÉΓòÉ
  737.  
  738. The toolbar shows a combobox where you can select if you are working in debug-, 
  739. beta- or release-mode. This means that Object WorkFrame can start applications 
  740. like the compiler with options depending on your selection, e.g. if you have 
  741. selected DEBUG the compiler is started with the flags nessecary to debug your 
  742. application. 
  743.  
  744. From this reason there must be three statements in the makefile with 
  745. compiler/linker flags, one for debug code, one for release mode and one for 
  746. beta-code. To create the needed statements it is recommended if you use the 
  747. MakeMake utility. In this utility you can select the compiler/linker flags for 
  748. debug- and release-mode seperatly. It is recomended if you work in this manner: 
  749.  
  750.    1. Create a project by droping the template on the workplace shell 
  751.    2. Enter the project settings in the project dialog 
  752.    3. Select DEBUG in the combobox 
  753.    4. Start MakeMake, select your compiler and make-utility 
  754.    5. Open the compiler settings and select the switches for DEBUG-code 
  755.    6. Let Makemake create a makefile 
  756.    7. Now select RELEASE in the combobox 
  757.    8. Start MakeMake again 
  758.    9. Open the compiler settings and select the switches for RELEASE-code 
  759.   10. Let MakeMake overwrite the makefile 
  760.   11. Select BETA and redo the actions from nr. 8 
  761.  
  762.  Now the makefile contains all needed statements for debug, beta and 
  763.  release-code and you can select before starting the make-utility or the 
  764.  comiler, if debug, beta or release-code should be created. 
  765.  
  766.  For BETA-code there is a special flag in the compilers INI-file (/DBETA). This 
  767.  flag is passed to the compiler when BETA is selected and has the same function 
  768.  like '#define BETA' in your sourcecode, so it is simple to write BETA-specific 
  769.  code 
  770.  
  771.  #ifdef BETA 
  772.    logFile.Write("some beta-information"); 
  773.  #endif 
  774.  
  775.  You don╤Åt need to define BETA yourself, BETA is automaticaly defined if you 
  776.  select BETA from the combobox. 
  777.  
  778.  The macros used are in the file <WF.DF>, you may edit them or implement new 
  779.  macros in this file. Every macro must be on a single line, the line starts 
  780.  with a name which is shown in the combobox, it is followed by a semicolon and 
  781.  the macro(s) which are passed to the make-utility, e.g. 
  782.  
  783.  Debug;"debug=TRUE" 
  784.  
  785.  If you create new macros you need to modify your makefiles, beware of editing 
  786.  the modified makefiles with MakeMake, your changes will be overridden in this 
  787.  case. 
  788.  
  789.  
  790. ΓòÉΓòÉΓòÉ 10. The MakeMake Utility ΓòÉΓòÉΓòÉ
  791.  
  792. To develop programs you often need to use make-files. Writing makefiles is a 
  793. little bit boring so a utility should do it for you. To call the 
  794. MakeMake-utility open a project with Object WorkFrame and select 
  795. Project\MakeMake. Now select 
  796.  
  797.      the target make-utility (GNU Make and IBM NMake supported, most other 
  798.       make utilitys should work like one of these) 
  799.  
  800.      the used compiler 
  801.  
  802.      settings for the compiler/linker 
  803.  
  804.      actions to control by the make-utility 
  805.  
  806.      additional librarys to use 
  807.  
  808.      additional projects/makfiles to include 
  809.  (see online-help from MakeMake for details) 
  810.  
  811.  When you╤Åve finished, MakeMake will create a makefile. Before you save the 
  812.  makefile you can edit it directly. 
  813.  
  814.  Warning: MakeMake overwrites the makefile! 
  815.  
  816.  Because MakeMake works compiler independent it may be nessacary to edit/create 
  817.  the INI-file for your compiler, see compiler settings for details. 
  818.  
  819.  MakeMake works dependent on your DEBUG/RELEASE/BETA-selection, refer to 
  820.  DEBUG/RELEASE/BETA for details. 
  821.  
  822.  
  823. ΓòÉΓòÉΓòÉ 11. Class browser utilitys ΓòÉΓòÉΓòÉ
  824.  
  825. The class browser needs informations about the used classes, theirefore two 
  826. utilitys are needed. This utilities are invoked automaticaliy in your makefile 
  827. if you are using the MakeMake utility, just select "Create browser information" 
  828. from the actions window. 
  829.  
  830. If you don╤Åt use MakeMake you have to invoke the utilities yourself. The 
  831. creation of browser information is done in two steps. The first step is to add 
  832. all files which are compiled to a temporary file which is done by 
  833. "addfile.exe". The second step is to create the browser information 
  834. ("browse.exe"), it uses the information of the temporary file. The filenames of 
  835. the browser information and the temporary file are identified by the name of 
  836. the makefile, eg. if your makefile is "make.mak", the temporary file is 
  837. "make.ctw", the browser information is in the file "make.cw". 
  838.  
  839. To use the utilities in your makefile follow these steps: 
  840.  
  841.    1. Your makefile contains code which creates object-files from C++ files 
  842.       like 
  843.  
  844.       ".cpp.obj: 
  845.       compiler.exe $(CFLAGS) %s" 
  846.  
  847.       Enter the following line after that statement: 
  848.  
  849.       "@<WorkFramePath>\addfile %s <MakeFile>" 
  850.  
  851.       where: 
  852.  
  853.           <WorkFramePath> is the full qualified path where you have installed 
  854.            Object WorkFrame 
  855.           <MakeFile> is the name of the current makefile 
  856.  
  857.    2. The second step is to invoke the browser when the application is created. 
  858.       Your makefile contains code like: 
  859.  
  860.       "makemake.exe: $(OBJS) 
  861.       ilink /Fe"app.exe" $(OBJS) $(LIBS)" 
  862.  
  863.       Add the following line: 
  864.  
  865.       "@<WorkFramePath>\browse.exe <MakeFile>" 
  866.  
  867.       where: 
  868.  
  869.           <WorkFramePath> is the full qualified path where you have installed 
  870.            Object WorkFrame 
  871.           <MakeFile> is the name of the current makefile 
  872.  
  873.  You can also create browser information for one or multiple source files. 
  874.  Therfore call the browser utility with the name of the makefile and the files 
  875.  to scan: 
  876.  
  877.  <WorkFramePath>\browse.exe <MakeFile> file1 file2 ... 
  878.  
  879.  where: 
  880.  
  881.      <WorkFramePath> is the full qualified path where you have installed 
  882.       Object WorkFrame 
  883.      <MakeFile> is the name of the current makefile 
  884.      file1... are the files to scan (no jokers allowed) 
  885.  
  886.  "addfile.exe" suports one option: 
  887.  
  888.      -nologo  don╤Åt display the logo 
  889.  
  890.  Additonaly "browse.exe" supports following options: 
  891.  
  892.      -nologo  don╤Åt display the logo 
  893.      -struct  use structs and unions like classes (C++ only) 
  894.      -java   run in Java-mode 
  895.  
  896.  Eg. the invokation of "browse.exe" in your makfile looks like: 
  897.  
  898.  c:\wf\browse.exe MyMake.mak -nologo -struct 
  899.  
  900.  See also configurate class browser files. 
  901.  
  902.  
  903. ΓòÉΓòÉΓòÉ 12. History ΓòÉΓòÉΓòÉ
  904.  
  905. Version 2.0 
  906.  
  907.      WorkFrame 
  908.  
  909.         -  New class browser 
  910.         -  New Finder utility 
  911.         -  The toolbar use smaller bitmaps 
  912.         -  File-handling uses now case-sensitive filenames 
  913.         -  Problems with different drives fixed 
  914.         -  The file window supports direct editing 
  915.         -  Bug fixed at minimizing the window 
  916.         -  Bugs fixed in drag/drop 
  917.         -  PM-tool to setup the menus 
  918.         -  Support for Debug/Release/Beta settings 
  919.         -  Changed to OOL Beta 1 
  920.  
  921.      MakeMake 
  922.  
  923.         -  Notebook support for compiler/linker settings 
  924.         -  uses INI-files for comilers, compiler independent 
  925.         -  MakeMake reads the settings you╤Åve made the last time and initialize 
  926.            the windows with these settings 
  927.         -  scans resource files for dependencies (bitmaps, icons, dialog- and 
  928.            include files) 
  929.         -  Bugs fixed in building the makefile 
  930.         -  Support for Debug/Release/Beta settings 
  931.         -  Changed to OOL Beta 1 
  932.  
  933.  
  934. ΓòÉΓòÉΓòÉ <hidden> Monitored Programms ΓòÉΓòÉΓòÉ
  935.  
  936. You can start programs from Object WorkFrame monitored which is useful for 
  937. command-line applications (e.g. compiler, linker...). The programs output is 
  938. shown in the monitor-window where you can inspect it. 
  939.  
  940. In the case of the supported compiler (ICC, EMX/GCC, IPF, RC) you can switch 
  941. with a double-click on an error-message in the monitor window to the file and 
  942. line given there (if you use EPM or Mr. Ed 1.16 or higher). 
  943.  
  944.  
  945. ΓòÉΓòÉΓòÉ <hidden> Editor ΓòÉΓòÉΓòÉ
  946.  
  947. Insert here the name of your editors exe-file. You should enter the full 
  948. qualified path. 
  949.  
  950.  
  951. ΓòÉΓòÉΓòÉ <hidden> EPM ΓòÉΓòÉΓòÉ
  952.  
  953. Check if your editor is EPM or not. If you use EPM you should check this button 
  954. so Object WorkFrame can communicate with EPM (e.g. show errormessages from the 
  955. compiler). 
  956.  
  957.  
  958. ΓòÉΓòÉΓòÉ <hidden> Mr. Ed ΓòÉΓòÉΓòÉ
  959.  
  960. Check if your editor is Mr. Ed or not. If you use Mr. Ed you should check this 
  961. button so Object WorkFrame can communicate with Mr. Ed (e.g. show errormessages 
  962. from the compiler). 
  963.  
  964.  
  965. ΓòÉΓòÉΓòÉ <hidden> other ΓòÉΓòÉΓòÉ
  966.  
  967. Check this button if your editor is neither EPM nor Mr. Ed. DDE-communication 
  968. will be disabled. 
  969.  
  970.  
  971. ΓòÉΓòÉΓòÉ <hidden> Application name ΓòÉΓòÉΓòÉ
  972.  
  973. You can edit the DDE-application name which your comiler uses. The default 
  974. settings should work with EPM/Mr. Ed without any changes. 
  975.  
  976.  
  977. ΓòÉΓòÉΓòÉ <hidden> Topic name ΓòÉΓòÉΓòÉ
  978.  
  979. You can edit the DDE-topic name which your comiler uses. The default settings 
  980. should work with EPM/Mr. Ed without any changes. 
  981.  
  982.  
  983. ΓòÉΓòÉΓòÉ <hidden> Command ΓòÉΓòÉΓòÉ
  984.  
  985. You can edit the DDE-command which your comiler uses. The default settings 
  986. should work with EPM/Mr. Ed without any changes. 
  987.  
  988.  
  989. ΓòÉΓòÉΓòÉ <hidden> Editor arguments ΓòÉΓòÉΓòÉ
  990.  
  991. Enter here the arguments which should be passed to you editor. You can also use 
  992. the joker "%s". In this case the editor is started with all selected files from 
  993. the file window. 
  994.  
  995.  
  996. ΓòÉΓòÉΓòÉ <hidden> Editor Settings ΓòÉΓòÉΓòÉ
  997.  
  998. Specify here your text-editor. Make following entrys: 
  999.  
  1000.      Editor 
  1001.      Editor arguments 
  1002.      EPM 
  1003.      Mr. Ed 
  1004.      other 
  1005.      Appname 
  1006.      Topic name 
  1007.      Command 
  1008.  
  1009.  
  1010. ΓòÉΓòÉΓòÉ <hidden> Location ΓòÉΓòÉΓòÉ
  1011.  
  1012. Insert here the location of your project as a full qualified path. 
  1013.  
  1014.  
  1015. ΓòÉΓòÉΓòÉ <hidden> Output File ΓòÉΓòÉΓòÉ
  1016.  
  1017. Enter the name of the compilers output-file (e.g sample1.exe, test.dll), 
  1018. optional. 
  1019.  
  1020.  
  1021. ΓòÉΓòÉΓòÉ <hidden> Run Options ΓòÉΓòÉΓòÉ
  1022.  
  1023. Enter the arguments to start the output-file with (optional). 
  1024.  
  1025.  
  1026. ΓòÉΓòÉΓòÉ <hidden> Makefile ΓòÉΓòÉΓòÉ
  1027.  
  1028. Insert here the name of your makefile of this project if you use one 
  1029. (optional). If you don╤Åt use a makefile but want to use the class-browser you 
  1030. must enter a "virtual" makefile-name like "dummy.mak". This file don╤Åt need to 
  1031. exist. 
  1032.  
  1033. You can also press the browse-button to select a makefile from the file-dialog. 
  1034.  
  1035.  
  1036. ΓòÉΓòÉΓòÉ <hidden> Multiple directorys ΓòÉΓòÉΓòÉ
  1037.  
  1038. On default the file window of Object WorkFrame shows only the files found in 
  1039. the path you entered as the projects path in the projects-setting dialog. If 
  1040. you build a more complex project it may be possible you want to invoke other 
  1041. directories, eg. directories which contains source for DLLs. In this case you 
  1042. can specify in the project-settings dialog one or more directories to display 
  1043. additionaly in the file-window. 
  1044.  
  1045. Therefore you open the project settings and enter the path(s) for the 
  1046. directories in the multiline-control, each directory on a new line. 
  1047.  
  1048. Warning: If you have specified drectories in the projects settings, drag/drop 
  1049. actions will always be performed on the project directory, eg. if you drop a 
  1050. file on the file window the file will be copied/moved to the project directory. 
  1051.  
  1052.  
  1053. ΓòÉΓòÉΓòÉ <hidden> Dircetorys ΓòÉΓòÉΓòÉ
  1054.  
  1055. You can insert multiple directorys which contents are displayed in the 
  1056. file-window. Every line of the mle can only contain one directory. See using 
  1057. mulitple directorys for details. 
  1058.  
  1059.  
  1060. ΓòÉΓòÉΓòÉ <hidden> Finder ΓòÉΓòÉΓòÉ
  1061.  
  1062. To find strings in one or more files do the following: 
  1063.  
  1064.    1. Enter a string which to find in the files 
  1065.    2. Select if the finder should search 
  1066.         a. in the directory 
  1067.         b. or in the selected files 
  1068.         c. or in files which have a file extension specified in the entry field 
  1069.    3. Select if the search should performed case-sensitive or not 
  1070.  
  1071.  The finder does not search in files with the following extension (even if you 
  1072.  have selected them): 
  1073.  
  1074.      *.BMP 
  1075.      *.CLASS 
  1076.      *.DLL 
  1077.      *.EXE 
  1078.      *.HLP 
  1079.      *.ICO 
  1080.      *.INF 
  1081.      *.LIB 
  1082.      *.RES 
  1083.      *.O 
  1084.      *.OBJ 
  1085.      *.TMP 
  1086.  
  1087.  
  1088. ΓòÉΓòÉΓòÉ <hidden> Results of searching ΓòÉΓòÉΓòÉ
  1089.  
  1090. In this list you see the results of the search, on the left the filenames and 
  1091. on the right the linennumber where the string was found. In the titlebar you 
  1092. see the count of matches. 
  1093.  
  1094. To view a found topic just double-click on the line which is of your interest 
  1095. (EPM 6.x or Mr. Ed 1.16 or higher required). 
  1096.  
  1097.  
  1098. ΓòÉΓòÉΓòÉ <hidden> Menu Setup ΓòÉΓòÉΓòÉ
  1099.  
  1100. You can customize Object WorkFrame by using this window. You can add 
  1101. menu-entrys to the popup-menu and the main-menu of the frame window, associate 
  1102. this menu-entrys with applications, set separators or delete menuentrys you╤Åve 
  1103. added. 
  1104.  
  1105. The control shows the menu-entrys of the main- and popup-menu: red bitmaps show 
  1106. you that the menu-entrys are program defined so you cannot edit or remove them. 
  1107. Green bitmaps show that you can edit the entrys (with the right mouse button 
  1108. you access the local popup-menu): 
  1109.  
  1110.      To edit an entry double-click on the entry of your interest or click for 
  1111.       the local popup-menu on that entry 
  1112.      To delete, add sibling or child-entrys or add separators click for the 
  1113.       local popup-menu on that entry 
  1114.  
  1115.  
  1116. ΓòÉΓòÉΓòÉ <hidden> Joker ΓòÉΓòÉΓòÉ
  1117.  
  1118. Joker are signs which are filled by Object WorkFrame if they are used in the 
  1119. menu settings. E.g. if you use the Joker %s in the arguments of a program, 
  1120. Object WorkFrame replaces this joker with the filenames you╤Åve selected in the 
  1121. file-window. 
  1122.  
  1123.  
  1124. ΓòÉΓòÉΓòÉ <hidden> Menu Title ΓòÉΓòÉΓòÉ
  1125.  
  1126. Enter at <Menu title> the title of the menu entry. 
  1127.  
  1128.  
  1129. ΓòÉΓòÉΓòÉ <hidden> Program ΓòÉΓòÉΓòÉ
  1130.  
  1131. Enter at <Program> the application which should start when this menu entry is 
  1132. selected. It can be nessacary to enter a full qualified path. 
  1133.  
  1134.  
  1135. ΓòÉΓòÉΓòÉ <hidden> Arguments ΓòÉΓòÉΓòÉ
  1136.  
  1137. Enter the arguments which should be passed to the started application. 
  1138.  
  1139. You can also enter Jokers. Valid jokers are: 
  1140.  
  1141. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1142. Γöé%c   ΓöéThe compiler-settings (CFLAGS) from the makefile. The  Γöé
  1143. Γöé     Γöésettings are inserted depending of the debug/release   Γöé
  1144. Γöé     Γöéselection.                                             Γöé
  1145. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1146. Γöé%cc  ΓöéThe compiler which is identified in your makefile by   Γöé
  1147. Γöé     Γöéthe macro CC= (e.g. CC=gcc.exe)                        Γöé
  1148. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1149. Γöé%d   ΓöéIf you are in debug mode a macro ("debug=TRUE") is     Γöé
  1150. Γöé     Γöépassed to the program, in release mode nothing is      Γöé
  1151. Γöé     Γöépassed.                                                Γöé
  1152. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1153. Γöé%e   ΓöéThe output-file you specified in the project-settings. Γöé
  1154. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1155. Γöé%m   ΓöéThe makefile you specified in the project-settings.    Γöé
  1156. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1157. Γöé%p   ΓöéThe path of the project.                               Γöé
  1158. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1159. Γöé%r   ΓöéThe run-options you specified in the project-settings. Γöé
  1160. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1161. Γöé%s   ΓöéAll selected files from the file-window. If no file is Γöé
  1162. Γöé     Γöéselected the program is not started.                   Γöé
  1163. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1164. Γöé%S   ΓöéAll selected files from the file-window. If no file is Γöé
  1165. Γöé     Γöéselected the program is started anyway.                Γöé
  1166. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1167.  
  1168.  
  1169. ΓòÉΓòÉΓòÉ <hidden> Hotkey ΓòÉΓòÉΓòÉ
  1170.  
  1171. Select a Hotkey for the menu entry. All hotkeys for user defines menu-entrys 
  1172. must be used with <Ctrl+Shift+HOTKEY> 
  1173.  
  1174.  
  1175. ΓòÉΓòÉΓòÉ <hidden> Toolbar Button ΓòÉΓòÉΓòÉ
  1176.  
  1177. You can select the button <Toolbar Button> to create a toolbar-button. 
  1178.  
  1179. Changes to the toolbar will be visible if you restart Object WorkFrame. 
  1180.  
  1181.  
  1182. ΓòÉΓòÉΓòÉ <hidden> Bitmap ΓòÉΓòÉΓòÉ
  1183.  
  1184. On default the toolbar button displays only text. You can enter at <Bitmap> a 
  1185. full qualified path to a bitmap-file which should be displayed int the toolbar 
  1186. button instaed of text. 
  1187.  
  1188. Changes to the toolbar will be visible if you restart Object WorkFrame. 
  1189.  
  1190.  
  1191. ΓòÉΓòÉΓòÉ <hidden> New Group ΓòÉΓòÉΓòÉ
  1192.  
  1193. Check the button <New Group> if the toolbar button should start a new group of 
  1194. buttons. 
  1195.  
  1196. Changes to the toolbar will be visible if you restart Object WorkFrame. 
  1197.  
  1198.  
  1199. ΓòÉΓòÉΓòÉ <hidden> Change Path ΓòÉΓòÉΓòÉ
  1200.  
  1201. If the program need to be started from a special directory check the button 
  1202. <Change Path> and enter the path in the field below. 
  1203.  
  1204.  
  1205. ΓòÉΓòÉΓòÉ <hidden> Path ΓòÉΓòÉΓòÉ
  1206.  
  1207. Enter at <Path> the path Object WorkFrame should switch to before the 
  1208. application is started. 
  1209.  
  1210.  
  1211. ΓòÉΓòÉΓòÉ <hidden> Run monitored ΓòÉΓòÉΓòÉ
  1212.  
  1213. Check this button if the programs output should be displayed in the Object 
  1214. WorkFrame monitor window. Very useful for all command-line applications. 
  1215.  
  1216.  
  1217. ΓòÉΓòÉΓòÉ <hidden> Refresh File-window ΓòÉΓòÉΓòÉ
  1218.  
  1219. Check this button if the content of the project directory will changed by the 
  1220. program which is started (e.g. compiler). In this case the file window from 
  1221. Object WorkFrame will be updated if the started program has finished. 
  1222.  
  1223.  
  1224. ΓòÉΓòÉΓòÉ <hidden> Remove .class-extension ΓòÉΓòÉΓòÉ
  1225.  
  1226. Some Java-utilities don╤Åt like to work if an overgiven filename contains 
  1227. ".class". Check this button so the file-extension ".class" will not be 
  1228. overgiven. 
  1229.  
  1230.  
  1231. ΓòÉΓòÉΓòÉ <hidden> Remove .class-extension ΓòÉΓòÉΓòÉ
  1232.  
  1233. Some Java-utilities don╤Åt like to work if an overgiven filename contains the 
  1234. complete path. Check this button so the path will not be overgiven. 
  1235.  
  1236.  
  1237. ΓòÉΓòÉΓòÉ <hidden> Item Settings ΓòÉΓòÉΓòÉ
  1238.  
  1239. Here you can associate your menu-entry to applications. Therefore you can: 
  1240.  
  1241.      Enter the title of the menu-item 
  1242.      Select a program to start 
  1243.      Enter arguments to pass to the program 
  1244.      Select a hotkey 
  1245.      Select if a toolbar button should be created 
  1246.      Enter a bitmap the toolbar button should display 
  1247.      Select if the toolbar-button should lead a new Group 
  1248.      Select if path must be set 
  1249.      Enter a path if it must be changed 
  1250.      Select if the program runs monitored 
  1251.      Select if window content must be refreshed 
  1252.      Select if file extensions must be removed 
  1253.      Select if paths must be removed 
  1254.  
  1255.  
  1256. ΓòÉΓòÉΓòÉ <hidden> Save Menu Settings ΓòÉΓòÉΓòÉ
  1257.  
  1258. Select how to save the menu settings: 
  1259.  
  1260.      Project configuration 
  1261.  
  1262.       Save the settings local. All settings are only in use for your opened 
  1263.       project. The settings are saved in a file named like your makefile with 
  1264.       the suffix "*.CFG". If you rename your makefile you must rename the 
  1265.       "*.CFG"-file too. 
  1266.  
  1267.      Global configuration 
  1268.  
  1269.       Save the settings global. All settings are avaible in every project which 
  1270.       does not have a local settings-file. 
  1271.  
  1272.  Changes to the toolbar will be visible when you restart Object WorkFrame. 
  1273.  
  1274.  
  1275. ΓòÉΓòÉΓòÉ <hidden> Project Settings ΓòÉΓòÉΓòÉ
  1276.  
  1277. Speciy here your project. Make the following entrys: 
  1278.  
  1279.      Project Location 
  1280.      Makefile 
  1281.      Output File 
  1282.      Run Options 
  1283.      Directorys 
  1284.  
  1285.  
  1286. ΓòÉΓòÉΓòÉ <hidden> AppAssistant ΓòÉΓòÉΓòÉ
  1287.  
  1288. AppAssitant helps you to create a simple new application. Therfore it shows in 
  1289. the list on the left side application-templates from which an application can 
  1290. be created. With the button <Info> you access more information about every 
  1291. application. if you have selected an application to create 
  1292.  
  1293.    1. Select it from the list 
  1294.  
  1295.    2. Enter the name of the new application 
  1296.  
  1297.    3. Enter the directory where it should be created or use the browse-button 
  1298.  
  1299.    4. If an application-template supports online-help and/or menus checkbuttons 
  1300.       for this support are enabled. Select that button if you want this 
  1301.       support. 
  1302.  
  1303.  When finished the application will be created and MakeMake starts where you 
  1304.  have select your compiler etc. 
  1305.  
  1306.  Currently only a few templates are delivered with Object WorkFrame, if you 
  1307.  don╤Åt want to use this templates cancel the dialog and create a application on 
  1308.  the usual way. 
  1309.  
  1310.  You can also create your own templates.