home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / greed223.zip / GreedX.INF (.txt) < prev    next >
OS/2 Help File  |  1998-01-27  |  74KB  |  965 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5.      (C) Copyright 1995, 1997 by Janosch R. Kowalczyk. All rights reserved 
  6.      Template Controller (GreedX) is a universal source code controller from 
  7.      Janosch R. Kowalczyk. 
  8.      This version of Templates Controller is free of charge -> but it isn't 
  9.      FREEWARE. You are allowed to use this program as an "evaluation copy" for 
  10.      private puposes only. With this present version you are not able to change 
  11.      any of the contents except the contents of the *.FNC files. 
  12.      If you like to use this application for education or commercial purposes, 
  13.      contact the  Author for license agreement and pricing. 
  14.      Please send all bug reports and improvement suggestions to the author . 
  15.      See Author for details. 
  16.      Disclaimer 
  17.  
  18.  
  19. ΓòÉΓòÉΓòÉ 2. Trademarks ΓòÉΓòÉΓòÉ
  20.  
  21.       The following terms are trademarks of the IBM Corporation: 
  22.  
  23.          Common User Access (CUA) 
  24.          Database 2 OS/2 (DB2/2) 
  25.          Extended Services for IBM 
  26.          IBM 
  27.          Operating System/2 (OS/2) 
  28.          Warp 
  29.          Presentation Manager 
  30.          Systems Aplication Architecture (SAA) 
  31.  
  32.  
  33. ΓòÉΓòÉΓòÉ 3. Disclaimer ΓòÉΓòÉΓòÉ
  34.  
  35.       This package is provided as is, without any guarantees or warrantees 
  36.      whatsoever. The author is not liable or responsible for any loss or damage 
  37.      of any kind whatsoever, including, but not limited to, losses of a 
  38.      financial, physical, emotional, marital, social, or mental nature that may 
  39.      result from the use or the purported use of anything in this package, for 
  40.      any purpose whatsoever. 
  41.  
  42.      Thanks to Michael Shillingford for this wording. 
  43.  
  44.  
  45. ΓòÉΓòÉΓòÉ 4. System Requirments ΓòÉΓòÉΓòÉ
  46.  
  47.          System Requirments 
  48.      If you want to install Template Controller separately (outside of GREED), 
  49.      you should: 
  50.  
  51.        1. Create an Installation Directory 
  52.        2. Copy all GREEDX.*, *.FNC and INSTALL.* files into this directory 
  53.        3. Call the installation program INSTALL 
  54.        4. Select or suggest the destination directory 
  55.        5. Confirm the installation 
  56.        6. Delete all unused Objects from the Greed Folder Object. 
  57.      Template Controller requires approximately 1,5 MB (additional 150 kB for 
  58.      the installation program) of disk space for the full installation. This 
  59.      installation includes six files (about 500 kB) with predefined templates 
  60.      for: 
  61.  
  62.          Rexx (two versions: short - GREED.FNC and extended - GREEDX.FNC), 
  63.          HTML (in HTML.FNC), 
  64.          IPF (in GREEDX.FNC), 
  65.          VpRexx (in VPREXX.FNC - only VpRexx-Add-On), 
  66.          TSO/ISPF with RACF commands (for MVS, in TSOISPF.FNC), 
  67.          Summary of all these files (GLOBAL.FNC). 
  68.  
  69.  
  70. ΓòÉΓòÉΓòÉ 5. Motto ΓòÉΓòÉΓòÉ
  71.  
  72. No windows, No gates, No bill!
  73.  
  74.  
  75. ΓòÉΓòÉΓòÉ 6. Introduction ΓòÉΓòÉΓòÉ
  76.  
  77.  
  78.           Templates Controller (GreedX) is a programmer's tool. It has come 
  79.           into existence as a supplement to the General Rexx Extended Editor 
  80.           (Greed), that simplifies the usage and storage of programmer's own 
  81.           code templates. However, it is an independent unit and it can be used 
  82.           separately. 
  83.           This product is an extensible text storing system which provides 
  84.           two-levels of classification of templates: 
  85.  
  86.               Application level, which arrange templates in groups (such as: 
  87.                programming languages, systems, functions packages, functions 
  88.                groups and others) 
  89.               Function level, which consists of code templates themselves. 
  90.  
  91.           Templates Controller transfers information via the OS/2 clipboard and 
  92.           can be used with any editor that supports standard cut and paste 
  93.           clipboard operations. Of course, you must then call the Templates 
  94.           Controller separately. If you use Greed as the editor, you get the 
  95.           menu option to select Templates Controller window. 
  96.           Templates Controller provides many built-in and separate utilities to 
  97.           designe and maintain the collection of the user's templates. 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 6.1. How to use Templates Controller? ΓòÉΓòÉΓòÉ
  101.  
  102.  
  103.           After you have called Templates Controller, it reads the templates 
  104.           from the current function file and builds the tree structure of the 
  105.           available applications. One click with the mouse button 1 on the '+' 
  106.           symbol opens the function path. 
  107.           They are four ways to copy a template into the clipboard: 
  108.  
  109.             1. Select an item and use the accelerator key: Ctrl+Ins. 
  110.             2. Select an item, open the Edit main menu option and click on the 
  111.                Copy to clipboard option. 
  112.             3. Select an item, open the Pop-up menu (via the click on the 
  113.                backgound with the mouse button 2) and click on the Copy to 
  114.                clipboard option. 
  115.             4. Double click on the item with the mouse button 1. 
  116.  
  117.           You can see the name of the last clipboard copied function in the 
  118.           information field named Clipboard at the top of the Templates 
  119.           Controller' window. 
  120.           Paste clipboard at the current cursor position in the editor you are 
  121.           using. 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 6.2. Design and maintenance ΓòÉΓòÉΓòÉ
  125.  
  126.  
  127.           The Database for the templates uses a file in the format of the 
  128.           OS/2-INI-file. This solution is benefitial in many ways. The most 
  129.           important of these are: 
  130.  
  131.               Standard OS/2 APIs - you need not any Data Base engine, 
  132.               Quick search for items, 
  133.               Simple and clearly arranged structure of items, 
  134.               Simple control of files and items (i.e. excludes), 
  135.               Possibility to write and to use the template files for the 
  136.                specific tasks only. 
  137.               Many INI-Editors, which exist as shareware or freeware products 
  138.                on the software market, can be used to edit and maintain 
  139.                templates, 
  140.  
  141.           The packaging for Templates Controller includes an external Template 
  142.           Editor for this purpose. You can also use the built-in template 
  143.           editor or clipboard editor for the selected template from the Edit 
  144.           Option. Both have the possibility to change, save or rename the 
  145.           current template into the current template file. 
  146.           See Settings and Utilities for more information. 
  147.  
  148.  
  149. ΓòÉΓòÉΓòÉ 7. Settings ΓòÉΓòÉΓòÉ
  150.  
  151.  
  152.           The menu option Settings opens the Settings Notebook with 2 pages: 
  153.  
  154.               Template Files 
  155.               Excludes 
  156.               Options 
  157.               Attributes 
  158.  
  159.           These pages allow you to customize and personalize the usage of the 
  160.           template files and it's applications. 
  161.           The OK key closes the Settings Notebook. The container contents will 
  162.           be rebuilt. 
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ 7.1. Template Files ΓòÉΓòÉΓòÉ
  166.  
  167.  
  168.           After you have opened this notebook page, you get the list of all 
  169.           *.FNC files from the Templates Controller' home directory. The name 
  170.           of the currently (last) used template file is highlighted. 
  171.           You have following actions possibilities for this list: 
  172.  
  173.               Single mouse click with button 1 - to change the file selection. 
  174.               Double mouse click with button 1 - the Template Editor for the 
  175.                selected file will be called. 
  176.               Push Button Add - the standard OS/2 dialog box to select a file 
  177.                will be displayed. You can add any other file as an additional 
  178.                template file. This selection is valid for the current session 
  179.                only if it was not saved. 
  180.               Push Button Clear - to clear the file entry from the list. The 
  181.                file will not be deleted! 
  182.               Push Button Default - to select the file GREEDX.FNC as the 
  183.                current template file. 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 7.2. Excludes ΓòÉΓòÉΓòÉ
  187.  
  188.  
  189.           The page named Excludes displays the list of all applications from 
  190.           the current template file. 
  191.           You can select from the list all those applications which you do not 
  192.           want actually work with. 
  193.           All selected items will not appear in the Templates Controller' 
  194.           container. 
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 7.3. Options ΓòÉΓòÉΓòÉ
  198.  
  199.  
  200.           At the moment following General options are placed at your's disposal 
  201.           in Templates Controller: 
  202.  
  203.               Show lines number - shows, how much of lines has the current 
  204.                code template. It's very helpful if your editor don't work in 
  205.                the insert mode such as the TSO Editor or K- (X-) Edit. 
  206.               Open built-in editor after start. - Templates Controller has a 
  207.                buil-in editor, that you can call from the menu option 
  208.                Utilities. If you set this option, it will be started together 
  209.                with the Controller. 
  210.               Copy template into built-in editor. - Set this option if you 
  211.                wish, that the selected template will be copied direct into the 
  212.                built-in editor at the current cursor position. If you set the 
  213.                suboption Don't copy to clipboard, the template won't be copied 
  214.                into the clipboard. 
  215.  
  216.  
  217. ΓòÉΓòÉΓòÉ 7.4. Attributes ΓòÉΓòÉΓòÉ
  218.  
  219.  
  220.           The Attributes page allows you to change the color or font of the 
  221.           container object. If you changed the color or font, the values you 
  222.           selected will appear in the test field and in the container 
  223.           simultaneously. 
  224.           To change the current font, complete the following steps: 
  225.  
  226.               Select the Font... push button. 
  227.               Specify the font type, size and attributes you want to use. 
  228.               Select OK 
  229.  
  230.           To change the current color of the container, select the arrows of 
  231.           the spin buttons. The Foreground field changes the text color. The 
  232.           Background field changes the color of the containers background. 
  233.           The Undo push button resets your changes. The  Default push button 
  234.           sets the applications default value. 
  235.  
  236.  
  237. ΓòÉΓòÉΓòÉ 7.5. Save template ΓòÉΓòÉΓòÉ
  238.  
  239.  
  240.           You can save just edited template under the new name or into an 
  241.           another Templates file (*.FNC). In the window Save template you can 
  242.           set these new save parameters. 
  243.           If these values (file, application and function) don't yet exist, 
  244.           they will be created. 
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ 8. Utilities ΓòÉΓòÉΓòÉ
  248.  
  249.  
  250.           Templates Controller gives you the possibilities of maintenence and 
  251.           customization of the template files. You can do this via both the 
  252.           functions in the menu option Edit and the functions in the menu 
  253.           option Utilities. Following is the list of these functions. 
  254.  
  255.               Edit template (Edit) 
  256.               Add template - to add a new template to the application. (Edit) 
  257.               Edit clipboard (Edit) 
  258.               Editor (Edit) 
  259.               Move template - to move a template to the other application 
  260.                and/or template. (Edit) 
  261.               Delete (Edit) 
  262.               Template Editor (Utilities) 
  263.               File Browser (Utilities) 
  264.               Collaps all trees - to close all applications. (Utilities) 
  265.               Reload - to load the FNC file once more (i.e. after you have 
  266.                changed this file outside of Templates Controller. (Utilities) 
  267.  
  268.           The Template Editor and File Browser are external functions and they 
  269.           are enabled only if the executable files are present in the home 
  270.           directory. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 8.1. Edit clipboard ΓòÉΓòÉΓòÉ
  274.  
  275.  
  276.           This option of Edit allows you to see and change the clipboard 
  277.           contents. You can call the clipboard editor only if a function was 
  278.           selected. You will get the following Push Buttons if you edit the 
  279.           clipboard: 
  280.  
  281.               Cancel - to end the work with the editor. 
  282.               Re-Load - to load the clipboard contents once more into the 
  283.                editor. 
  284.               Save & Exit - to write the edited text into the clipboard and to 
  285.                exit the editor. 
  286.               As Template - to write the edited text into the current template 
  287.                file. You can (via the displayed window) change both the 
  288.                Application Name and the Function Name. If they do not exist, 
  289.                they will be created. The clipboard contents will not be 
  290.                affected. 
  291.  
  292.  
  293. ΓòÉΓòÉΓòÉ 8.2. Edit template ΓòÉΓòÉΓòÉ
  294.  
  295.  
  296.           This option shows a small editor to directly edit the code template. 
  297.           You can only use it for a selected function. You don't need to fetch 
  298.           the code template into the clipboard but you can work with the 
  299.           clipboard functions (copy, paste). 
  300.           You can write the edited text back into the current template file. 
  301.           You can (via the displayed window) change both the Application Name 
  302.           and the Function Name. If they do not exist, they will be created. 
  303.           The clipboard contents will not be affected by these saving options. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 8.3. Template Editor ΓòÉΓòÉΓòÉ
  307.  
  308.  
  309.           Via this option you can call the external Template Editor to edit the 
  310.           FNC-files. Refer to it's help for more information. 
  311.  
  312.  
  313. ΓòÉΓòÉΓòÉ 8.4. File Browser ΓòÉΓòÉΓòÉ
  314.  
  315.  
  316.           Via this option you can call the external File Browser. Refer to it's 
  317.           help for more information. 
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 8.5. Delete ΓòÉΓòÉΓòÉ
  321.  
  322.  
  323.           This option allows you to delete the currently selected code template 
  324.           (function) or the application from the template file. You will be 
  325.           prompted to confirm the delete request. 
  326.  
  327.                     CAUTION:
  328.           If you delete the application, all its code templates will be 
  329.           deleted. 
  330.  
  331.  
  332. ΓòÉΓòÉΓòÉ 9. What is GREED ? ΓòÉΓòÉΓòÉ
  333.  
  334.       GREED - General Rexx Extended EDitor - is a universal source code 
  335.      generator to work with user defined code templates. It has a modular 
  336.      structure and consists of three independent modules: 
  337.  
  338.          Templates Controller, the universal code controller. 
  339.          Template Editor to edit the templates for Greed and  Greed Templates 
  340.           Controller. 
  341.          Browser  - the small file viewer with both text and hexadecimal mode. 
  342.  
  343.      The menu bar option Rexx of the main window is the interface to the code 
  344.      templates for Rexx, RexxUtil, VRexx and mciRexx functions from either the 
  345.      'greed.fnc' or 'greedx.fnc' file. 
  346.      The calls for extended modules are built-in into the main window menu 
  347.      options, but you can call these out of the main program too. 
  348.  
  349.      Copyright | Trademaks | Disclaimer | System Requirements | Motto | Thanks 
  350.      | Author | 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 9.1. Last change. ΓòÉΓòÉΓòÉ
  354.  
  355.      GREED's last change at Jan, 26, 98 
  356.  
  357.      Current Version: 2.23 
  358.  
  359.  
  360. ΓòÉΓòÉΓòÉ 9.2. General information ΓòÉΓòÉΓòÉ
  361.  
  362.  
  363. The following section describes general features of Greed. 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 9.2.1. Standard buttons. ΓòÉΓòÉΓòÉ
  367.  
  368.      In most of Greed's windows you'll find the keys (Push Buttons) which have 
  369.      same meaning everywhere: 
  370.  
  371.          Undo - all changes are suspended. 
  372.          Default - the affected options are set to their standard values. 
  373.          Help - the context sensitive help will be displayed. 
  374.          Back - all changes will be saved and the window closed. 
  375.          Save - all changes will be saved but the window will be not closed. 
  376.  
  377.      All other buttons, if present,  have their own description in the context 
  378.      sensitive help windows. 
  379.  
  380.  
  381. ΓòÉΓòÉΓòÉ 9.2.2. Call parameters line ΓòÉΓòÉΓòÉ
  382.  
  383.  
  384.      The Call Parameters Line is situated on the top of Greed's window. It is a 
  385.      combination box with the list of all up to now entered commands and/or 
  386.      call parameters for run the just edited Rexx procedure. 
  387.      The contents of the Call Parameters Line will be interpreted as call 
  388.      parameter(s) when you have pressed the push button Run. If you use the 
  389.      Execute push button instead, it will be interpreted as OS/2 Command. 
  390.  
  391.      You can call from the Call Parameters Line Entry Field all OS/2 Commands 
  392.      and all programs. The current working directory is this one of the file 
  393.      just edited. 
  394.  
  395.      Enter the required Command in the Call Parameters Line and click the 
  396.      button Execute or press the Enter key on the Keyboard . 
  397.      The Command output will be directed into the file $EXECUTE.$$$ and showed 
  398.      in the Editor and the File Manager as Execute command output The Command 
  399.      output file will be deleted after you exit Greed. 
  400.      You can fetch one of the up to now used call parameters or commands from 
  401.      the Call Parameters Line's Combination Box. 
  402.  
  403.  
  404. ΓòÉΓòÉΓòÉ 9.2.3. Greed's Features ΓòÉΓòÉΓòÉ
  405.  
  406.      The most important (but not all) features of GREED are: 
  407.  
  408.        1. Switch between 2 template files for the simple or extended code 
  409.           generation. This Option needs the file named GREED.FNC for simple 
  410.           templates and the file GREEDX.FNC for extended templates. If you are 
  411.           using these files for Greed Extents be sure you don't delete any 
  412.           function from them; they are templates for the main menu option Rexx. 
  413.  
  414.           Note:  The menu options have same names as the functions in the 
  415.           template files. 
  416.        2. Generation of frames for a Rexx program with: 
  417.               Comment , 
  418.               Exception handling, 
  419.               Registration of other Rexx functions (default: RexxUtil, VRexx, 
  420.                mciRexx). 
  421.        3. Ability to insert the contents of any other text file into the source 
  422.           code just edited. 
  423.        4. Test run for the edited source without the necessity to store it. 
  424.        5. Print control functions: 
  425.               Choice of the Print port. 
  426.               Spool control. 
  427.        6. Work with the clipboard: 
  428.               Copy/Cut to clipboard. 
  429.               Paste from clipboard. 
  430.               Edit clipboard. 
  431.        7. Set comment for selected textstring. 
  432.        8. Find and change textstrings. 
  433.        9. Notebook for settings: 
  434.               Code and Clipboard control functions. 
  435.               Font and Color change functions. 
  436.               Store settings (upper case, lower case, free). 
  437.               File information and attributes change function. 
  438.               Internal Greed Options. 
  439.       10. Call of Info files (if existant) for Rexx, Vrexx, mciRexx and ORexx 
  440.           and OS/2 Command References from the help menu. 
  441.  
  442.  
  443. ΓòÉΓòÉΓòÉ 9.2.4. Greed Templates Controller. ΓòÉΓòÉΓòÉ
  444.  
  445.  
  446.      Greed Templates Controller is an Add-On product for GREED. You can use it 
  447.      to work with the templates that are written into either your own templates 
  448.      files or standard GREED-templates files, but they are out of reach the 
  449.      main menu option Rexx 
  450.  
  451.      It is a container with a tree-view of template applications. You can copy 
  452.      the template's code into the clipboard either via the pop-up menu or via 
  453.      the double mouse click (button 1) on the function name. 
  454.  
  455.      This kind of work allows you to use Greed Templates Controller for all 
  456.      possible editors which can paste from the clipboard. 
  457.  
  458.      See help of Greed Templates Controller for more information. 
  459.  
  460.  
  461. ΓòÉΓòÉΓòÉ 9.2.5. Template Editor. ΓòÉΓòÉΓòÉ
  462.  
  463.      Template Editor is a universal editor for the text-string Values of the 
  464.      INI-files. 
  465.  
  466.      The Greed's functions files (usually but not always with the extent *.FNC) 
  467.      are stored into this file type. The structure of this file is used as 
  468.      follows: 
  469.  
  470.           application is the group of functions, 
  471.           key is the name of the function 
  472.           value is the template by itself. 
  473.  
  474.      The benefits of the usage of this file structure are: 
  475.  
  476.          prompt search for the value in a large template file, 
  477.          switch between different template files, 
  478.          exclude functions which you will not actually use, 
  479.          ascending sort for functions and their groups, 
  480.          selective edit of the template value. 
  481.  
  482.      You can write the templates directly into the template file by using the 
  483.      Template Editor or you can edit the function groups using control 
  484.      characters (like VisPro addon files): 
  485.  
  486.           @ - for function group, 
  487.           % - for function name, 
  488.           $ - for function value. 
  489.  
  490.      as a Text file and then translate it to the INI-format. See help of 
  491.      Template Editor for more information. 
  492.  
  493.  
  494. ΓòÉΓòÉΓòÉ 9.2.6. Browser. ΓòÉΓòÉΓòÉ
  495.  
  496.      PM Browser is a program to view all sorts of files in both: 
  497.  
  498.          text mode or 
  499.          hexadecimal mode. 
  500.  
  501.      You can't directly edit the already viewed file, although you can call the 
  502.      OS/2 system editor to do that. 
  503.  
  504.      In the hexadecimal mode, the hex digit will be showed verticaly below the 
  505.      character line: 
  506.  
  507.          zone in the first line after and 
  508.          numeric in the second line. 
  509.  
  510.      See help of PM Browser for more information. 
  511.  
  512.  
  513. ΓòÉΓòÉΓòÉ 9.3. File related functions. ΓòÉΓòÉΓòÉ
  514.  
  515. This chapter describes all file related functions of Greed. The most of these 
  516. functions are accessed over the menu option File. Others such as Switch, direct 
  517. over the dedicated push button. 
  518.  
  519.  
  520. ΓòÉΓòÉΓòÉ 9.3.1. Edit a new program. ΓòÉΓòÉΓòÉ
  521.  
  522.      With the menu option New from the main menu option File you can open a new 
  523.      file for edit. This file, named NEWREXX.CMD, will be situated in the 
  524.      current working directory. 
  525.  
  526.      This file gets the frame that is dependent on the current frame settings 
  527.      in the options-notebook. 
  528.  
  529.  
  530. ΓòÉΓòÉΓòÉ 9.3.2. Open edit file. ΓòÉΓòÉΓòÉ
  531.  
  532.      To open an existing file for edit, use menu option Open from the main 
  533.      option File. You get the standard OS/2 dialog box to open a file. You can 
  534.      select the drive, the directory and file you want to open. 
  535.  
  536.      Use the OK button to confirm or Cancel to suspend your choice. 
  537.  
  538.      Greed allows you to edit up to 256 files simultaneous (in parallel). You 
  539.      can switch between edited files either in the File Manager (in the menu 
  540.      option File or the push button File Mgr.) or by using the push buttons << 
  541.      (backward) and >> (to the front). You will be prompted to save all 
  542.      modified files at the Greed close time. 
  543.  
  544.  
  545. ΓòÉΓòÉΓòÉ 9.3.3. Switch. ΓòÉΓòÉΓòÉ
  546.  
  547.      Greed allows you to edit up to 256 files simultaneous (in parallel). When 
  548.      you open an existing file or create a new file to edit, the currently 
  549.      edited file will be hidden. You can switch between edited files either in 
  550.      the File Manager (in the menu option File or the push button File Mgr.) or 
  551.      by using the push buttons << (backward) and >> (to the front). 
  552.  
  553.      You will be prompted to save all modified files at the Greed close time. 
  554.  
  555.  
  556. ΓòÉΓòÉΓòÉ 9.3.4. Test run. ΓòÉΓòÉΓòÉ
  557.  
  558.      You can start the test run of the currently edited file. The menu option 
  559.      Run allows you to start the Rexx procedure either: 
  560.  
  561.          in PMRexx window or 
  562.          in-Storage routine or 
  563.          as Traced with Result in PMRexx window. 
  564.      The Run push button started the Rexx procedure in a PMRexx window. You 
  565.      always run the newest release of your file without the necessity to save 
  566.      it. 
  567.  
  568.      The test file gets the temporary name RUNxxxxx.CMD, where 'xxxxx' is a 
  569.      5-digit random integer. This temporary File will be created in the current 
  570.      directory and always deleted if you run the next test or you end the Greed 
  571.      session. 
  572.  
  573.      Note:  You get no output on the Screen if you use the in-Store run method. 
  574.  
  575.  
  576. ΓòÉΓòÉΓòÉ 9.3.5. Print functions. ΓòÉΓòÉΓòÉ
  577.  
  578.  
  579.      You can send the file just edited or the selected text to a printer. Refer 
  580.      to the operator's manual of your printer for more information. 
  581.      The function Cancel print allows you to delete the current print job. 
  582.  
  583.      Other function: Spool delete clears the print spool from all actually 
  584.      queued jobs 
  585.  
  586.       Printer options 
  587.  
  588.  
  589. ΓòÉΓòÉΓòÉ 9.3.6. Insert file. ΓòÉΓòÉΓòÉ
  590.  
  591.      The file option with the same name (Insert file) provides the possibility 
  592.      to insert an external file into your currently edited file. You get the 
  593.      standard OS/2 dialog box to open a file to insert. 
  594.  
  595.      If you confirm your choice with the OK-key, the new file will be inserted 
  596.      at the current cursor possition. 
  597.  
  598.  
  599. ΓòÉΓòÉΓòÉ 9.3.7. File Manager. ΓòÉΓòÉΓòÉ
  600.  
  601.      Greed allows you to edit up to 256 files simultaneous (in parallel). When 
  602.      you open an existing file or create a new file to edit, the currently 
  603.      edited file will be hidden. You can switch between edited files either in 
  604.      the File Manager (in the menu option File or the push button File Mgr.) or 
  605.      by using the push buttons << (backward) and >> (to the front). 
  606.      File Manager help you to manage already opened and open new files. You 
  607.      have following options to do it: 
  608.  
  609.          Open - Opens a new file to edit. 
  610.          Save - Saves currently selected file. 
  611.          Save as - Saves currently selected file under other name. 
  612.          Free - Closes current file and free it from the File Manager. 
  613.          Cancel - Closes the File Manager without any changes. 
  614.  
  615.      You will switch to an another file, if you select a file name from the 
  616.      File Manager's List Box. 
  617.      You will be prompted to save all modified files at the Greed close time. 
  618.  
  619.  
  620. ΓòÉΓòÉΓòÉ 9.4. Edit functions. ΓòÉΓòÉΓòÉ
  621.  
  622. This chapter describes all editor functions of Gredd. The most of these 
  623. functions are accessed over the menu option Edit. Others such as Copy or Paste, 
  624. additional over the dedicated push buttons. 
  625.  
  626.  
  627. ΓòÉΓòÉΓòÉ 9.4.1. Clipboard. ΓòÉΓòÉΓòÉ
  628.  
  629.      You can use the Clipbord in the same manner as used by other editors: 
  630.  
  631.           Cut 
  632.           Copy 
  633.           Paste. 
  634.  
  635.      Additionally you have a tiny Clipboard editor which helps you to edit the 
  636.      contents of the clipboard separately. 
  637.  
  638.      In this editor you can: 
  639.  
  640.           Paste from clipboard to multiply its contents, 
  641.           Undo the last change, 
  642.           Delete the Clipboards contents and 
  643.           Save the edited text back. 
  644.  
  645.  
  646. ΓòÉΓòÉΓòÉ 9.4.2. Find and change text. ΓòÉΓòÉΓòÉ
  647.  
  648.      This function allows you to search for and change a text in your actually 
  649.      edited file. It works (like other editors) with the following options and 
  650.      buttons: 
  651.  
  652.          Find - the button that starts the search process (at the current 
  653.           cursor position). This button is only enabled if you have already 
  654.           entered the string to be searched for. 
  655.          Change then Find - the button to carry out the change action and to 
  656.           start the search for the next occurance of the search string. This 
  657.           button is enabled if at least one searcheded string was found. 
  658.          Change - the button to carry out the change action. This button is 
  659.           enabled if at least one searcheded string was found. 
  660.          Change all - the button to carry out the change action for all 
  661.           occurances of the searched string. This button is enabled if at least 
  662.           one searcheded string was found. 
  663.          Cancel - end this function. 
  664.          Case sensitive - use this check box to search for exactly equal 
  665.           strings. 
  666.          Wrap - use this check box to start the search again at the beginning 
  667.           of your file. 
  668.  
  669.  
  670. ΓòÉΓòÉΓòÉ 9.4.3. Clear text. ΓòÉΓòÉΓòÉ
  671.  
  672.  
  673.      They are two options that allow you to clear a portion of or the total 
  674.      text you are editing: 
  675.  
  676.          Clear - to delete the selected portion of the text, 
  677.          Clear all - to delete the entire (selected) text. 
  678.  
  679.      Note:  If you have cleared the total text and saved your file - the empty 
  680.      file will be saved. 
  681.  
  682.  
  683. ΓòÉΓòÉΓòÉ 9.4.4. Set comment. ΓòÉΓòÉΓòÉ
  684.  
  685.      With this option you can set comment characters around the selected text: 
  686.  
  687.           "/*" at the beginning and 
  688.           "*/" at the end of selection. 
  689.  
  690.  
  691. ΓòÉΓòÉΓòÉ 9.5. Greed's options. ΓòÉΓòÉΓòÉ
  692.  
  693.      With the menu option Settings you can personify your Greed installation. 
  694.      This option displays an Settings Notebook to change or set Greed's 
  695.      properties. Following Notebook pages are for your disposal: 
  696.  
  697.          Options 
  698.          Attributes 
  699.          File 
  700.  
  701.      All pages of the options notebook have at least two buttons: 
  702.  
  703.           Undo - to undo your current changes 
  704.           Default - to set the default values for these options. 
  705.  
  706.  
  707. ΓòÉΓòÉΓòÉ 9.5.1. Editors settings ΓòÉΓòÉΓòÉ
  708.  
  709.  
  710.      There are three arrows of options for the editor. All these options you 
  711.      can set on the Options pge of the Settings Notebook: 
  712.  
  713.        1. Backup - this option allows you to made a backup for the just opened 
  714.           file. The default is NO. If you selected this option, you can decide 
  715.           what extent will you use for the backup file. The default is .G~D. 
  716.  
  717.        2. Save options - you have three kinds of save options to choose: 
  718.  
  719.                Case free (default) - the text will be saved in this form, you 
  720.                have used, 
  721.                Uppercase - the text will be saved in upper case, 
  722.                Lowercase - the text will be saved in lower case. 
  723.  
  724.        3. Auto saving - you can set the auto saving interval between 1 and 60 
  725.           seconds. 
  726.  
  727.      Additional you can set following general options on this page: 
  728.  
  729.          Exit confirm - if this option is ON, you will be prompted for 
  730.           confirmation befor the editor will close. 
  731.          Use alternate templates file - this option switches between both 
  732.           standard templates files: greed.fnc and greedx.fnc. 
  733.  
  734.      You can select and change the active port for your print output. This is 
  735.      possible via the settingss notebook, page Options 
  736.  
  737.      You have 4 possibles ports to select from: 
  738.  
  739.        1. LPT1 (default), 
  740.        2. LPT2, 
  741.        3. LPT3 or. 
  742.        4. PRN. 
  743.  
  744.      Print functions 
  745.  
  746.  
  747. ΓòÉΓòÉΓòÉ 9.5.2. Change colours. ΓòÉΓòÉΓòÉ
  748.  
  749.  
  750.      Although you can change the color settings using the systems color 
  751.      palette, you can also use internal Greed possibilities too. 
  752.  
  753.      To change the current color, select the arrows of the spin buttons: 
  754.  
  755.          Foreground to change the color of the text, 
  756.          Background to change the color of the editor's window, 
  757.  
  758.      and select the required RGB values. 
  759.  
  760.      The changes can be immediately seen in the test field of this pages and in 
  761.      Greed's edit window. 
  762.  
  763.  
  764. ΓòÉΓòÉΓòÉ 9.5.3. Change font. ΓòÉΓòÉΓòÉ
  765.  
  766.      You can change the font settings using the systems font palette but you 
  767.      can also use internal Greed possibilities too. 
  768.  
  769.      Greed allows you to set only the monospaced fonts to edit. This make sense 
  770.      because Greed is really an editor to write the source code of programs. 
  771.  
  772.      To change a font select the desired font name and font size on the Font 
  773.      page of the options notebook. 
  774.  
  775.      The changes can immediately be seen in the pages test field and in Greed's 
  776.      edit window. 
  777.  
  778.  
  779. ΓòÉΓòÉΓòÉ 9.5.4. General settings ΓòÉΓòÉΓòÉ
  780.  
  781.      They are three arrows of options for the editor: 
  782.  
  783.        1. Suppress exit confirm. You will be asked for confirmation before you 
  784.           exit Greed. The default value is NO. If you select this option, the 
  785.           confirmation message will not be displayed. 
  786.  
  787.        2. Save options - you have three kinds of save options to choose from: 
  788.  
  789.                Case free (default) - your text will be saved without changes, 
  790.                Upper case - your text will be set to upper case befor saving, 
  791.                Lower case - your text will be set to lower case befor saving, 
  792.  
  793.        3. Auto save. You can cause your text to be saved automatically after 
  794.           the timer expiration. This time is set in seconds. Default is no 
  795.           save. For save the timer default is set to 25 sec. 
  796.  
  797.  
  798. ΓòÉΓòÉΓòÉ 9.5.5. File attributes ΓòÉΓòÉΓòÉ
  799.  
  800.  
  801.      This notebook page allows you to show the following files information: 
  802.  
  803.        1. File size in Bytes 
  804.        2. EA size in Bytes 
  805.        3. Last access date - for HPFS only 
  806.        4. Last change date - for HPFS only 
  807.        5. Create date 
  808.        6. Standard Attributes (these Attributes can you change directly from 
  809.           this page): 
  810.               Archive, 
  811.               Hidden, 
  812.               Read only 
  813.               System 
  814.  
  815.  
  816. ΓòÉΓòÉΓòÉ 9.5.6. Printer options. ΓòÉΓòÉΓòÉ
  817.  
  818.  
  819.      You can select and change the active port for your print output. This is 
  820.      possible via the settingss notebook, page Options 
  821.  
  822.      You have 4 possibles ports to select from: 
  823.  
  824.        1. LPT1 (default), 
  825.        2. LPT2, 
  826.        3. LPT3 or. 
  827.        4. PRN. 
  828.  
  829.      Print functions 
  830.  
  831.  
  832. ΓòÉΓòÉΓòÉ 9.5.7. Save settings ΓòÉΓòÉΓòÉ
  833.  
  834.      The current settings are always saved after you end work with Greed. These 
  835.      settings are standard settings for the next call. 
  836.  
  837.      You can save your current settings from the Options notebook, using the 
  838.      Push Button OK, without the need to exit Greed. This is very useful to 
  839.      protect your settings from a crash. 
  840.  
  841.  
  842. ΓòÉΓòÉΓòÉ 9.6. Rexx option. ΓòÉΓòÉΓòÉ
  843.  
  844.      The menu option Rexx includes templates for the following subjects: 
  845.  
  846.          Constructs, 
  847.          API, 
  848.          Rexx built-in functions, 
  849.          RexxUtil, 
  850.  
  851.  
  852. ΓòÉΓòÉΓòÉ 9.6.1. Rexx API. ΓòÉΓòÉΓòÉ
  853.  
  854.      Rexx API is a Rexx interface to manage the external functions packages and 
  855.      data queues for OS/2. Following functions are at your disposal: 
  856.  
  857.        1. RxFuncAdd, 
  858.        2. RxFuncDrop, 
  859.        3. RxFuncQuery, 
  860.        4. RxQueue: 
  861.               Create, 
  862.               Delete, 
  863.               Get, 
  864.               Set. 
  865.  
  866.      Refer to Rexx Information for details.  ΓöögA 
  867.  
  868.  
  869. ΓòÉΓòÉΓòÉ 9.6.2. Rexx built-in functions. ΓòÉΓòÉΓòÉ
  870.  
  871.      Rexx built-in functions are part of the Rexx language definition. They are 
  872.      subdivided in Greed as follows: 
  873.  
  874.        1. Boolean, 
  875.        2. Data conversion, 
  876.        3. Date and time, 
  877.        4. Environment, 
  878.        5. File system, 
  879.        6. Numeric, 
  880.        7. String, 
  881.        8. Word, 
  882.        9. Miscellaneous. 
  883.  
  884.  
  885. ΓòÉΓòÉΓòÉ 9.6.3. Rexx Utilities. ΓòÉΓòÉΓòÉ
  886.  
  887.      The most interesting property of the Rexx Language is the ability to work 
  888.      with external functions packages. The standard function package for Rexx 
  889.      is RexxUtil. The following are function groups for RexxUtil in Greed's 
  890.      menu: 
  891.  
  892.        1. SysLoadFuncs, 
  893.        2. Console related functions, 
  894.        3. File system related functions, 
  895.        4. Functions to control the objects, 
  896.        5. Functions to read and write the INI files and object's EA's, 
  897.        6. System related functions, 
  898.        7. SysDropFuncs. 
  899.  
  900.  
  901. ΓòÉΓòÉΓòÉ 9.6.4. VRexx and mciRexx functions. ΓòÉΓòÉΓòÉ
  902.  
  903.  
  904.      The function templates for VRexx and mciRexx are only within reach of the 
  905.      Templates Controller. They are to find in the standard templates file 
  906.      (greed.fnc and greedx.fnc). 
  907.  
  908.      Refer to the VRexx and mciRexx documentation for more information. 
  909.  
  910.  
  911. ΓòÉΓòÉΓòÉ 9.7. Rexx books. ΓòÉΓòÉΓòÉ
  912.  
  913.      In the menu option Help you can see the follwing INF files directly: 
  914.  
  915.          Rexx, 
  916.          Vrexx, 
  917.          mciRexx, 
  918.          ORexx. 
  919.          OS/2 References. 
  920.  
  921.      Note:  Only if the INF files can be found in the HELP path of the file 
  922.      CONFIG.SYS, are these menu options enabled. 
  923.  
  924.  
  925. ΓòÉΓòÉΓòÉ 10. Credits to ... ΓòÉΓòÉΓòÉ
  926.  
  927.       Especially great thanks to Heribert Josef Gruenbauer 
  928.      (76155.3335@compuserve.com), for many new ideas, improvement suggestions 
  929.      (some of these you can see already in this release) and encouragement to 
  930.      further developement of Greed. Moreover, he is the author of the new Greed 
  931.      Icons, all Bitmaps and the main co-author of this information file. 
  932.      David L. White for his help in testing this product. He had new ideas and 
  933.      did some improvement suggestions and the correction of many texts. 
  934.      Moreover, he is the author of the HTML Code templates. That is a part of 
  935.      this packaging (html.fnc). 
  936.      Peter MacCarthy-Morrogh for correction of this help and info files and for 
  937.      his help in testing this product. 
  938.      Uwe Aust for his help in testing this product. 
  939.      To all the following GREED users thanks for draw my attention to some bugs 
  940.      and problems, for some im provement suggestions and requests and for 
  941.      praising of my job. I hope, with this version, to fulfil the most of these 
  942.      requests. 
  943.  
  944.           - Tobias Herp         100073.3563@compuserve.com
  945.           - Peter Adeberg        101456.3332@compuserve.com
  946.           - Gerald Goertzel       70740.503@compuserve.com
  947.           - Gottfried Enderer      Gottfried.Enderer@lessons.sesom.de
  948.   ╤ÇwA 
  949.  
  950.  
  951. ΓòÉΓòÉΓòÉ 11. Author ΓòÉΓòÉΓòÉ
  952.  
  953.           Janosch R. Kowalczyk
  954.           Oberwaldstrasse 42
  955.           D-63538 Grosskrotzenburg
  956.           GERMANY
  957.  
  958.           Telephone:  0049 6186 201676
  959.           CompuServe:  Janosch
  960.           Internet:   Janosch@compuserve.com
  961.  
  962.           Please send your improvement suggestions
  963.           and your bug reports via email.
  964.  
  965.