home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rcf2102i.zip / RCF2.HLP (.txt) < prev    next >
OS/2 Help File  |  1999-03-13  |  85KB  |  1,920 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. REXX Code Formatter/2 is, for registered users, a full-function REXX code 
  5. formatter written in REXX and using the facilities of VisPro/REXX and 
  6. VisPro/Reports. 
  7.  
  8. The purpose of this program is to provide users with the ability to format 
  9. their REXX programs in a style that best suits their desires. 
  10.  
  11. While it is possible that some user's may wish to format their code in a manner 
  12. not accommodated by RCF/2, most user's should find that this program will 
  13. handle their needs. 
  14.  
  15. For more on the facilities provided by REXX Code Formatter/2 and how to use it, 
  16. see: 
  17.  
  18.       Description 
  19.  
  20.       Configuring RCF/2 
  21.  
  22.       Formatting a REXX Source Program 
  23.  
  24.  
  25. ΓòÉΓòÉΓòÉ 1.1. Limitations ΓòÉΓòÉΓòÉ
  26.  
  27. The REXX Code Formatter/2 is not a syntax checker or code preprocessor. It 
  28. assumes that the program being formatted is a reasonably checked program, and 
  29. it follows the general rules of REXX coding. While it can, by the nature of its 
  30. processing of the REXX statements, detect certain errors, such as a Do or 
  31. Select statement without a corresponding End statement, it is not the purpose 
  32. of RCF/2 to find coding errors. 
  33.  
  34. It may be possible to code a REXX program in a highly unconventional manner 
  35. such that RCF/2 will not properly format a REXX statement. Such deficiencies 
  36. should be reported to RKE Software, and every effort will be made to provide 
  37. for the desired coding preference. RKE Software does not guarantee that all 
  38. coding styles will be handled, and no warranty of future corrections or 
  39. additions to handle all coding styles is implied or should be assumed. 
  40.  
  41. Since the possible styles of coding REXX programs is almost unlimited, it is 
  42. possible that some styles may not be completely handled by RCF/2. However, 
  43. within reason, and based on the viability of this product, every effort will be 
  44. made to accommodate the desires of the users of RCF/2. 
  45.  
  46. Notices 
  47.  
  48. Requirements 
  49.  
  50. Registration 
  51.  
  52.  
  53. ΓòÉΓòÉΓòÉ 1.2. Support ΓòÉΓòÉΓòÉ
  54.  
  55.       Technical Support 
  56.  
  57.       Support for RCF/2 is provided to all registered users. Questions and 
  58.       problems should be sent via E-mail to rke_software@ibm.net. 
  59.  
  60.       Errors 
  61.  
  62.       If you believe that you have found a defect in RCF/2, please report it to 
  63.       Technical Support at the E-mail address given above. 
  64.  
  65.       To report an error, please send a copy of the code that fails to format 
  66.       correctly, either as an attachment to the note or in the note using cut 
  67.       and paste. Include a description of the error, noting where the program 
  68.       fails to properly format, and the configuration settings used. 
  69.  
  70.       Enhancement 
  71.  
  72.       Suggestions for improvements and additional features are welcomed. 
  73.       Subject only to the reasonable acceptance of this product, and the 
  74.       resulting viability, all such suggestions will be carefully considered 
  75.       and, when possible, added to RCF/2. 
  76.  
  77.       Send all suggestions and requests via E-mail to RKE_Software@ibm.net. 
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ 1.3. Notices ΓòÉΓòÉΓòÉ
  81.  
  82. Every effort has been made to insure that this program runs as documented, but 
  83. RKE Software is in no way liable or responsible for any loss of time or data 
  84. associated with the use of this product. 
  85.  
  86. OS/2 is a registered trademark of International Business Machines. 
  87.  
  88. VisPro/REXX and VisPro/Reports are trademarks of HockWare, Inc. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 1.4. Requirements ΓòÉΓòÉΓòÉ
  92.  
  93. RCF/2 is coded to run in an OS/2 environment, 3.0 or higher, under the IBM 
  94. supplied classical or Object REXX. In addition, this program makes use of the 
  95. IBM RexxUtils functions that come with OS/2, and it assumes they have not been 
  96. removed. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 2. Description ΓòÉΓòÉΓòÉ
  100.  
  101. REXX Code Formatter/2 was developed to address three important areas of program 
  102. development: Consistency of Style, Maintained and Inherited code, and Final 
  103. Documentation 
  104.  
  105. Consistency of Style 
  106.  
  107. All programmers, novice or professional, develop a style of coding that they 
  108. like to use when writing a program.  Often times, however, in the haste to 
  109. complete a program, or simply because they are concentrating on the logic and 
  110. not the format, the style used is not always consistent.  For example, comments 
  111. are not aligned alike for easier reading and statements under a DO or SELECT 
  112. are not properly or consistently indented. 
  113.  
  114. Maintained and Inherited Code 
  115.  
  116. Some programs are inherited and some contain code that was included from other 
  117. sources.  In both cases, the style is often different, and in some instances, 
  118. very different from that used by the person maintaining the code.  A program 
  119. with the END statement aligned with the other code under a DO statement is very 
  120. difficult to maintain by a programmer used to having the END align with the DO 
  121. statement, itself. 
  122.  
  123. Final Documentation 
  124.  
  125. Finally, when a person has completed a program and wants to turn it over to 
  126. maintenance, give it to the customer for whom it was done, or simply show to 
  127. others, there is a natural desire, if not a need, to make it neat, consistent, 
  128. and professional looking.  Even the best of programs can look a bit sloppy if 
  129. functions and REXX keywords are sometimes in one case and sometimes in another. 
  130.  
  131. Time does not always allow programmers to go back over their work to "clean" it 
  132. up, and even when there is time, the task, by its nature, is a very boring one, 
  133. and all inconsistencies are seldom removed. 
  134.  
  135. The purpose of REXX Code Formatter/2 is to handle this formatting chore for the 
  136. programmer. RCF/2 has been written to allow a wide range of programming styles 
  137. (and even ones we probably have never heard of). 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 2.1. The Main RCF/2 Window ΓòÉΓòÉΓòÉ
  141.  
  142. All the work done with REXX Code Formatter/2 occurs using the main RCF/2 
  143. window. 
  144.  
  145. Below is a sample of an RCF/2 window after it has processed a REXX source 
  146. program file using a style defined by the programmer. 
  147.  
  148. Note:  To get a brief description of the purpose of the various parts of this 
  149.        window, point and click to the area of interest.
  150.  
  151.  
  152. ΓòÉΓòÉΓòÉ 2.2. Formatting a REXX Source Program ΓòÉΓòÉΓòÉ
  153.  
  154. To format a REXX source program, you must do the following: 
  155.  
  156.    1. Configure RCF/2 according to the style of formatting desired. 
  157.  
  158.    2. Identify the REXX source file to be formatted. 
  159.  
  160.    3. Activate the formatting facility of RCF/2. This may be done either by 
  161.       formatting a single REXX program, or formatting the REXX programs in a 
  162.       directory. 
  163.  
  164.  The first step is done usually once. Some times the defaults meet with the 
  165.  user's desires, and formatting a program may begin immediately, but you should 
  166.  review the RCF/2 configuration just to be sure it does, indeed, satisfy your 
  167.  needs. 
  168.  
  169.  The other two steps are performed as needed. 
  170.  
  171.  Afterwards you may print a listing of the formatted program, save the 
  172.  formatted program, edit it, or reformat it. 
  173.  
  174.  
  175. ΓòÉΓòÉΓòÉ 3. Configuring RCF/2 ΓòÉΓòÉΓòÉ
  176.  
  177. RCF/2 allows you to configure it according to your style of coding. 
  178.  
  179. Configuring RCF/2 is not done often since a user's style changes slowly over 
  180. time, if at all. At most, you should find that you will alter your RCF/2 
  181. configuration based on a project or major application. 
  182.  
  183. For whatever reason, defining or changing the configuration of RCF/2 to match 
  184. your style is easy. 
  185.  
  186. To configure RCF/2, open the configuration notebook by doing the following: 
  187.  
  188.    1. Click on Configure on the RCF/2 main window menu bar. 
  189.  
  190.    2. Click on Settings on the resulting pull-down menu. 
  191.  
  192.  After opening the configuration notebook, make any changes desired and close 
  193.  the notebook by clicking on the Save, Exit, or Cancel button at the bottom of 
  194.  the notebook page. 
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 3.1. Configuration Notebook Options ΓòÉΓòÉΓòÉ
  198.  
  199. The configuration notebook allows you to define how you want your REXX programs 
  200. formatted. 
  201.  
  202. The notebook is divided into: 
  203.  
  204.       General 
  205.  
  206.       These are the formatting parameters that apply to the general formatting 
  207.       of the input program, such as whether you want to split lines at 
  208.       semicolons or edit out redundant spaces. 
  209.  
  210.       Indentation 
  211.  
  212.       This part of the configuration notebook defines how much indentation you 
  213.       want for different types of statements. For example, Indentation can 
  214.       occur from such things as the nesting of statements under a Do or Select 
  215.       and because of a statement continuation. 
  216.  
  217.       Format 
  218.  
  219.       You may define how the various symbols in the program, such as variable 
  220.       and function names, are to be formatted. 
  221.  
  222.       Comments 
  223.  
  224.       RCF/2 allows you to define how your various types of comments are to be 
  225.       formatted. This part of the configuration notebook defines your 
  226.       preference for comment alignment. 
  227.  
  228.       Special 
  229.  
  230.       In this section, you may select some special formatting options that do 
  231.       not fall into the normal REXX formatting capabilities.
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ 3.1.1. General Settings ΓòÉΓòÉΓòÉ
  235.  
  236. The General Settings page of the configuration notebook allows you to define 
  237. some general rules about the formatting of REXX source programs and the 
  238. behavior of RCF/2. 
  239.  
  240. General Editing 
  241.  
  242. The General Editing options pertain to the overall editing.  They are options 
  243. that apply to the general look of the formatted program and the general 
  244. behavior of RCF/2 when editing a REXX program. 
  245.  
  246.  Split lines at semicolons 
  247.            When this box is checked, any semicolons found in a REXX statement 
  248.            will cause the semicolon to be dropped and the text following the 
  249.            semicolon to start a new line. 
  250.  
  251.  Edit Spacing 
  252.            RCF/2 will attempt to keep the same spacing of the source text. 
  253.            However, if this box is checked, multiple blanks in a REXX statement 
  254.            will be reduced to a single blank unless such blanks are needed for 
  255.            indentation and comment alignment, or they are contained within a 
  256.            comment of literal string. 
  257.  
  258.  Start new line with keywords Then or Else 
  259.            When this box is checked, any Then or Else keywords found which at 
  260.            not already the first REXX program statement word on a line will 
  261.            cause a new line to be started with the found Then\Else keyword. 
  262.  
  263.  Start new line after keywords Then or Else 
  264.            When this box is checked, any program statement text that follow 
  265.            Then and Else keywords will begin on a new line. 
  266.  
  267.  Indent Keyword End 
  268.            By default, End keyword statements are indented the same amount as 
  269.            the corresponding Do or Select statement. Checking this box, 
  270.            however, causes the End keyword statements to be aligned with the 
  271.            same indentation as the other statements under the corresponding Do 
  272.            and Select. 
  273.  
  274.  Ignore any comment alignment problems 
  275.            It is possible that, in spite of what RCF/2 may "say" about comment 
  276.            alignment problems, the resulting alignment is satisfactory to you, 
  277.            or for the time being, you may want to concentrate only on code 
  278.            formatting problems. For whatever reason, you may ask RCF/2 not to 
  279.            display any comment alignment problems by checking this box. 
  280.  
  281.  Cross-reference 
  282.  
  283.  While not a part of the formatting of a REXX program, RCF/2 is capable of 
  284.  gathering information about the formatted program as it is processed. For 
  285.  example, RCF/2 can record where a label, variable, or function is used. 
  286.  
  287.  If you would like to find where a label, variable, or function is used, or you 
  288.  want to print a cross-reference listing for one of these types of REXX 
  289.  symbols, you should check the appropriate box on this page of the 
  290.  configuration settings. 
  291.  
  292.  Labels 
  293.            RCF/2 will record and make available a list of all the labels in the 
  294.            formatted program and the line number where each label is defined. 
  295.  
  296.  Variables 
  297.            RCF/2 will record and make available a list of all the variables in 
  298.            the formatted program, and it will include a list the line numbers 
  299.            where each of the variables are referenced. 
  300.  
  301.  Functions 
  302.            RCF/2 will record and make available a list of all the functions 
  303.            referenced in the formatted program, and it will include a list of 
  304.            the line numbers where each of the functions are referenced. 
  305.  
  306.            Note:  A call to a labelled statement in the program is treated as a 
  307.                   call to a function. Because RCF/2 is a one-pass formatting 
  308.                   program, it cannot always recognize a call to a function as 
  309.                   being, in reality, a call to a labelled statement. For 
  310.                   consistency, RCF/2 treats all calls or function invocations 
  311.                   as function references, whether or not they are actually 
  312.                   references to a labelled statement. 
  313.  
  314.  
  315. ΓòÉΓòÉΓòÉ 3.1.2. Indentation ΓòÉΓòÉΓòÉ
  316.  
  317. Use this page of the RCF/2 configuration notebook to set the amount of 
  318. indentation that is to occur when formatting a REXX program. 
  319.  
  320.  General Indentation 
  321.            Unless otherwise noted in the configuration notebook settings, all 
  322.            statements in the REXX source program will be formatted beginning in 
  323.            column 1 plus the amount given here. 
  324.  
  325.  Continuation indentation 
  326.            Continuation of a statement, explicitly noted by the use of a comma 
  327.            or implicitly when a line ends with Then or Else, will be indented 
  328.            by the current indentation plus the amount specified here. 
  329.  
  330.  Indentation amount per Do/Select 
  331.            When a Do or Select statement is processed, the statements that 
  332.            follow, and are associated with that Do/Select, will be indented by 
  333.            the amount used for the Do/Select statement plus the amount 
  334.            specified here. 
  335.  
  336.  Indentation for lines starting with Then/Else 
  337.            When a line begins with the keywords Then or Else, that line is 
  338.            indented by the current indentation amount plus the amount specified 
  339.            here. 
  340.  
  341.  One-byte indentation threshold 
  342.            When a large number of nested Do and Select statements occur, the 
  343.            accumulated indentation may become large. If you wish, you may 
  344.            specify a "threshold" value here. Whenever the current indentation 
  345.            exceeds this amount, for all indentations beyond the threshold, one 
  346.            byte will be used instead of the amount specified above. 
  347.  
  348.  
  349. ΓòÉΓòÉΓòÉ 3.1.3. Formatting Options ΓòÉΓòÉΓòÉ
  350.  
  351. The Formatting Options pages of the configuration notebook allow you to specify 
  352. how certain REXX symbols will be explicitly formatted. In particular, you may 
  353. specify how to format the names of: 
  354.  
  355.       REXX Keyword Instructions, 
  356.  
  357.       Keywords,, 
  358.  
  359.       Variables,, 
  360.  
  361.       Functions, and 
  362.  
  363.       Labels. 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 3.1.3.1. REXX Keyword Instructions & Variables ΓòÉΓòÉΓòÉ
  367.  
  368. This page of the Formatting Options allows you to specify how RCF/2 is to 
  369. format REXX Keyword Instructions and Variable names. 
  370.  
  371. REXX Keyword instructions 
  372.  
  373. The top part of this Formatting Options page allows you to define how keyword 
  374. instructions are to be formatted. 
  375.  
  376.  No formatting 
  377.            No formatting will be performed on any REXX keyword instruction. 
  378.            They will appear on the resulting output exactly as they appear in 
  379.            the input source program. 
  380.  
  381.  All lower case 
  382.            All REXX keyword instructions will appear entirely in lower case 
  383.            letters in the resulting output. 
  384.  
  385.  Mixed case 
  386.            All REXX keyword instructions will appear as proper nouns. That is, 
  387.            the first letter will be capitalized and the other letters will be 
  388.            in lower case. 
  389.  
  390.  All upper case 
  391.            All REXX keyword instructions will be appear entirely in upper case 
  392.            letters in the resulting output. 
  393.  
  394.  Indent any un-nested Return 
  395.            This option is meaningful only if the general indentation is not 
  396.            zero, and it only applies to Return statements that are not 
  397.            subordinate to some previous Do or Select statement. That is, when 
  398.            the Return occurs, there is no Do or Select statement that has not 
  399.            been completed by a corresponding End clause. 
  400.  
  401.            If this box is checked, a Return statement will be indented by the 
  402.            general indentation amount. Otherwise, Return statements will be 
  403.            aligned on column 1 of the formatted output. 
  404.  
  405.  Indent any un-nested Exit 
  406.            This option is meaningful only if the general indentation is not 
  407.            zero, and it only applies to Exit statements that are not 
  408.            subordinate to some previous Do or Select statement. That is, when 
  409.            the Exit occurs, there is no Do or Select statement that has not 
  410.            been completed by a corresponding End clause. 
  411.  
  412.            If this box is checked, a Exit statement will be indented by the 
  413.            general indentation amount. Otherwise, Exit statements will be 
  414.            aligned on column 1 of the formatted output. 
  415.  
  416.  Variables 
  417.  
  418.  The bottom part of this Formatting Options page allows you to define how 
  419.  variable names are to be formatted. 
  420.  
  421.  No formatting 
  422.            No formatting will be performed on any variable name. They will 
  423.            appear on the resulting output exactly as they appear in the input 
  424.            source program. 
  425.  
  426.  All lower case 
  427.            All variable names will appear entirely in lower case letters in the 
  428.            resulting output. 
  429.  
  430.  Mixed case 
  431.            All variables will appear as proper nouns. That is, the first letter 
  432.            will be capitalized and the other letters will be in lower case. 
  433.  
  434.  All upper case 
  435.            All variable names will be appear entirely in upper case letters in 
  436.            the resulting output. 
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ 3.1.3.2. Keyword Names Formatting ΓòÉΓòÉΓòÉ
  440.  
  441. Technically, the first clause of a keyword instruction begins with a keyword. 
  442. For RCF/2, the initial keyword is handled by the formatting configuration given 
  443. for REXX Keyword Instructions. The Keyword Names Formatting portion of the 
  444. configuration notebook handles all the other keywords within a REXX keyword 
  445. instruction. For example, If is formatted according to the configuration under 
  446. REXX Keyword Instructions, while the formatting rules for Then and Else are 
  447. defined here. 
  448.  
  449.  No formatting 
  450.            No formatting will be performed on any REXX keyword. They will 
  451.            appear on the resulting output exactly as they appear in the input 
  452.            source program. 
  453.  
  454.  All lower case 
  455.            All REXX keywords will appear entirely in lower case letters in the 
  456.            resulting output. 
  457.  
  458.  Mixed case 
  459.            All REXX keywords will appear as proper nouns. That is, the first 
  460.            letter will be capitalized and the other letters will be in lower 
  461.            case. 
  462.  
  463.  All upper case 
  464.            All REXX keywords will be appear entirely in upper case letters in 
  465.            the resulting output. In other words, they will appear as they 
  466.            normally do in REXX documentation. 
  467.  
  468.  Sometimes it is desirable to have certain keywords in upper case and others in 
  469.  mixed case. For example, some programmers like the Then and Else keywords to 
  470.  be in mixed case while the VALUE keyword, in the Address and Signal REXX 
  471.  Instructions, to be in upper case. 
  472.  
  473.  The bottom part of Keyword Names Formatting page of the configuration notebook 
  474.  allows you to specify Upper Case for all keywords of selected instructions. 
  475.  These specifications will override any specifications given above. 
  476.  
  477.  To make all keywords upper case for the Address, Call, Numeric, Options, or 
  478.  Signal keyword instructions, check the corresponding box. 
  479.  
  480.  
  481. ΓòÉΓòÉΓòÉ 3.1.3.3. Function Names ΓòÉΓòÉΓòÉ
  482.  
  483. In REXX, functions may be external or internal, and when RCF/2 recognizes a 
  484. function invocation it will format the function name according to the 
  485. specifications noted in the Function Names Formatting and Function Names 
  486. Sources pages of the configuration notebook. 
  487.  
  488. A number of formatting options are allowed, including the ability to have upper 
  489. and lower case letters intermixed within the function name. For example, 
  490. function names RxMessageBox, SysCurState, and MyFavoriteFunction are all 
  491. possible. 
  492.  
  493. You can even have RCF/2 make note of the labels in your program, and on 
  494. subsequent passes, format the calls to those routines to match the correspond 
  495. label. (For more on this facility, see: Label Names Formatting.) 
  496.  
  497.  
  498. ΓòÉΓòÉΓòÉ 3.1.3.3.1. Function Names Formatting ΓòÉΓòÉΓòÉ
  499.  
  500. How function names are to be formatted is specified on this and the following 
  501. page of the RCF/2 configuration notebook. 
  502.  
  503. Default Format 
  504.  
  505. The top portion of this configuration notebook page defines how all function 
  506. names are to be formatted by default. That is, the formatting rules to be used 
  507. for all function names not identified elsewhere. Functions that are identified 
  508. elsewhere are the REXX Built-In Functions, below, and those specified through 
  509. Other Function Names Sources. 
  510.  
  511.  No formatting 
  512.            No formatting will be performed on a function name. They will appear 
  513.            on the resulting output exactly as they appear in the input source 
  514.            program. 
  515.  
  516.  All lower case 
  517.            All function names will appear entirely in lower case letters in the 
  518.            resulting output. 
  519.  
  520.  Mixed case 
  521.            All function names will appear as proper nouns. That is, the first 
  522.            letter will be capitalized and the other letters will be in lower 
  523.            case. 
  524.  
  525.  All upper case 
  526.            All function names will be appear entirely in upper case letters in 
  527.            the resulting output. 
  528.  
  529.  Notify if function name unknown 
  530.  
  531.  In addition to being able to format function names not identified elsewhere, 
  532.  you may request that you be notified if such a function name occurs. That is, 
  533.  you can ask that you be told when a function name occurs that requires use of 
  534.  the default formatting rule. 
  535.  
  536.  To activate this feature, check this box. 
  537.  
  538.  REXX Built-In Functions 
  539.  
  540.  RCF/2 includes a built-in list of the standard REXX functions, function names 
  541.  such as ABBREV, DATATYPE, LINEIN, or SUBSTR which are part of the defined REXX 
  542.  language. The bottom portion of this configuration notebook page defines how 
  543.  all of these particular function names are to be formatted. 
  544.  
  545.  No formatting 
  546.            No formatting will be performed on any of these function names. They 
  547.            will appear on the resulting output exactly as they appear in the 
  548.            input source program. 
  549.  
  550.  All lower case 
  551.            All standard REXX function names will appear entirely in lower case 
  552.            letters in the resulting output. 
  553.  
  554.  Mixed case 
  555.            All standard REXX function names will appear as proper nouns. That 
  556.            is, the first letter will be capitalized and the other letters will 
  557.            be in lower case. 
  558.  
  559.  All upper case 
  560.            All standard REXX function names will be appear entirely in upper 
  561.            case letters in the resulting output. 
  562.  
  563.  
  564. ΓòÉΓòÉΓòÉ 3.1.3.3.2. Other Function Names Sources ΓòÉΓòÉΓòÉ
  565.  
  566. Many REXX programs include the use of functions that are not part of the 
  567. standard REXX language. RCF/2, as an example, makes use of functions provided 
  568. by the REXXUTIL functions provided as part of OS/2 Warp. 
  569.  
  570. This page of the configuration settings notebook allows you to ask RCF/2 to 
  571. format these additional function names according to a given specification or by 
  572. their respective documentation. 
  573.  
  574. Built-in Formats 
  575.  
  576. Some REXX functions are well known, and RCF/2 provides for these functions 
  577. explicitly so that you need not expend the effort to define them using the 
  578. Additional Function Names procedure described below. To specify that RCF/2 
  579. should format these function names, if found, according to their documentation, 
  580. check the appropriate box. 
  581.  
  582. Note:  If you wish to format the associated functions differently from the 
  583.        documentation and the default, you may still do so using the Additional 
  584.        Function Names procedure described below.
  585.  
  586.  RexxUtil 
  587.            All of the REXX Utility Functions defined in The OS/2 Procedures 
  588.            Language 2/REXX documentation will be formatted according to the 
  589.            format given in the on-line documentation table of contents. (These 
  590.            are the functions that, except for RxMessageBox, begin with Sys, 
  591.            such as SysCls and SysCopyObject.) 
  592.  
  593.  RxUtil 
  594.            All of the miscellaneous REXX utility functions defined in RxUtils 
  595.            documentation (RxUtils version 1.73) will be formatted according to 
  596.            the format given in the on-line documentation table of contents. 
  597.            (These are the functions that begin with Rx, such as RxAddGroup and 
  598.            RxAddProgram.) 
  599.  
  600.  VisPro/REXX 
  601.            All of the REXX functions defined in VisPro/REXX (version 3.0) and 
  602.            VisPro/Reports (version 2.0) are formatted according the HockWare, 
  603.            Inc. documentation provided for those programs. 
  604.  
  605.  In addition to, or in place of, the default formatting and REXX functions 
  606.  formatting defined on the Function Names Formatting page of the configuration 
  607.  notebook, and the Built-In formats noted above, you may specify up to three 
  608.  files that contain a list of function names that are in the format to be used. 
  609.  When RCF/2 finds a function name in a program that matches one of the function 
  610.  names in a provided file, it will format the function name to match that given 
  611.  in the file. Thus, if "MyFunction" appears in one of the specified function 
  612.  names files, any reference to "myfunction," for example, would become a 
  613.  reference to "MyFunction." 
  614.  
  615.  In addition to specifying the function names file, you may specify whether the 
  616.  file is to be used. This option is provided to speed look-up processing if a 
  617.  large function names file is not referenced for a given program. 
  618.  
  619.  Note:  The option to use a file is automatically turned OFF if, at a later 
  620.         time, RCF/2 is invoked and the function name file no longer exists.
  621.  
  622.  Use associated label file 
  623.  
  624.  If you have created an Associated Label Names File using the Create associated 
  625.  label names file option (see: Label Names Formatting), you may specify that 
  626.  this file be used as a Function Names Source. 
  627.  
  628.  Additional Function Names 
  629.  
  630.  To use this feature of RCF/2, do the following: 
  631.  
  632.    1. Enter the fully qualified name of the function file to be used, or click 
  633.       on the "Find..." button to locate the file to be used. 
  634.  
  635.    2. If the named file exists, the Use this file box will become active, and 
  636.       you may indicate if it is desirable to begin using the file. 
  637.  
  638.  
  639. ΓòÉΓòÉΓòÉ 3.1.3.3.2.1. Function Names File Format ΓòÉΓòÉΓòÉ
  640.  
  641. A function names file is a simple flat file containing a list of names of 
  642. functions as they are to appear when used to format a function name in a source 
  643. program. 
  644.  
  645. Each record in this file either contains one or more function names, separated 
  646. by one or spaces, or it is a comment. 
  647.  
  648. Any record in the file that begins with an asterisk (*) is considered a 
  649. comment, and such a record may contain any alphanumeric character that appears 
  650. normally on a keyboard. 
  651.  
  652. Any record not starting with a asterisk is considered to contain one or more 
  653. function names. All such names must conform to REXX function naming rules. 
  654.  
  655. A Function Names File may be stored anywhere on your system since the fully 
  656. qualified name of the file is required by RCF/2. 
  657.  
  658.  
  659. ΓòÉΓòÉΓòÉ 3.1.3.4. Label Names Formatting ΓòÉΓòÉΓòÉ
  660.  
  661. Like other types of symbols processed by RCF/2, labels may also be formatted. 
  662. In addition, you may check for duplicate labels, offset labels to the general 
  663. indentation, and force all labels to start a new line. 
  664.  
  665. Labels 
  666.  
  667. The first part of the Label Names Formatting configuration defines how labels, 
  668. themselves, will appear. 
  669.  
  670.  No formatting 
  671.            No formatting will be performed on any label. They will appear on 
  672.            the resulting output exactly as they appear in the input source 
  673.            program. 
  674.  
  675.  All lower case 
  676.            All labels will appear entirely in lower case letters in the 
  677.            resulting output. 
  678.  
  679.  Mixed case 
  680.            All labels will appear as proper nouns. That is, the first letter 
  681.            will be capitalized and the other letters will be in lower case. 
  682.  
  683.  All upper case 
  684.            All labels will be appear entirely in upper case letters in the 
  685.            resulting output. 
  686.  
  687.  Label Names File 
  688.  
  689.  If you would like to format all the references to the labelled statements in 
  690.  your program, you may ask RCF/2 to create a Label Names File. When such a file 
  691.  exists, and it is used (see: Other Function Names Sources), all calls or 
  692.  invocations to labelled statements will have the same format as the label 
  693.  itself. 
  694.  
  695.  Update associated label names file 
  696.            Check this box to create or update a label names file with the label 
  697.            names contained in the program being formatted. If no label names 
  698.            file exists, it will be created. If a label names file exists, it 
  699.            will be updated. 
  700.  
  701.  File Name 
  702.            In the space provided, enter the fully qualified name of the label 
  703.            names file to be created. If no name is specified or the Use this 
  704.            file box is not checked, RCF/2 will create a file that is: 
  705.  
  706.                In the same directory as the program being formatted, 
  707.  
  708.                Has the same file name as the program being formatted, and 
  709.  
  710.                Has a file extension of RFL. 
  711.  
  712.            Note:  A file name is not required. The ability to specify a file 
  713.                   name is provided for those situations where: 
  714.  
  715.              1. You want the label names file to reside in another directory, 
  716.                 or 
  717.  
  718.              2. You wish to create a label file that has the labels from more 
  719.                 than one program. 
  720.  
  721.                 This capability is important if you are developing a 
  722.                 VisPro/REXX application or a library of individual REXX 
  723.                 program. 
  724.  
  725.  Find... 
  726.            You may enter the name of the label names file, or you may click on 
  727.            the Find... button to locate the file to be used. 
  728.  
  729.            Once a file name has been entered, the Use this file button will 
  730.            become active, and it may be selected. 
  731.  
  732.  Use this file 
  733.            Check this button if you wish RCF/2 to use this file to record 
  734.            labels found in the formatted program. 
  735.  
  736.            Note:  As mentioned above, if this option is not checked and the 
  737.                   Update associated label names file is, the default file name 
  738.                   will be used, regardless of the presence of any given file 
  739.                   name. 
  740.  
  741.  Additional Processing 
  742.  
  743.  The last part of the Labels Name Formatting configuration defines additional 
  744.  processing options for labels. 
  745.  
  746.  Check for duplicate labels 
  747.            RCF/2 will notify you, at then end of formatting, if any duplicate 
  748.            labels were found in the processed REXX source program. 
  749.  
  750.  Align labels on general indentation 
  751.            Normally, labels are aligned beginning in the first column of the 
  752.            generated output. If this box is checked, the labels will be aligned 
  753.            according to the specification of the general indentation. 
  754.  
  755.            Note:  This option is only meaningful when the general indentation 
  756.            is greater than zero. 
  757.  
  758.  Begin all labels on a new line 
  759.            This option allows you to specify that if more than one label 
  760.            appears on a line, each label after the first should begin a new 
  761.            line. 
  762.  
  763.            For example, if the input REXX program contained: 
  764.  
  765.                           LABEL1:  LABEL2:LABEL3:
  766.  
  767.            The resulting output would become: 
  768.  
  769.                           LABEL1:
  770.                           LABEL2:
  771.                           LABEL3:
  772.  
  773.  No space between label and colon 
  774.            Although it is customary for a label to be followed by a colon with 
  775.            no intervening spaces, it is not a requirement of the REXX language. 
  776.            To insure that this convention is followed, or to change from a 
  777.            convention where there is one or more spaces following the label 
  778.            name, this box should be checked. 
  779.  
  780.  
  781. ΓòÉΓòÉΓòÉ 3.1.4. Comments ΓòÉΓòÉΓòÉ
  782.  
  783. There are three types of comments in a REXX program that are recognized by 
  784. RCF/2: 
  785.  
  786.    1. Full-line, 
  787.  
  788.    2. Left-hand, and 
  789.  
  790.    3. Right-hand. 
  791.  
  792.  A full-line comment is a comment that takes up the entire source file record. 
  793.  There may be requirements to indent such comments, but if one comment, or a 
  794.  continuation of a comment, is the only thing in a given program source record, 
  795.  it is considered a Full-line comment. 
  796.  
  797.  A left-hand comment is a comment that, with the exception of spaces, is the 
  798.  first REXX element to begin a source program line, and it is followed by 
  799.  something other than spaces. (If it were not followed by something, it would 
  800.  be a full-line comment.) 
  801.  
  802.  A right-hand comment is the opposite of Left-hand comments. It is a comment 
  803.  that is preceded by something other than spaces. 
  804.  
  805.  It should be noted that a comment could be both preceded and followed by 
  806.  something other than spaces. In RCF/2, if this occurs, the comment is treated 
  807.  in-line and has no special formatting other than that given any REXX program 
  808.  string being formatted according to the current specifications. 
  809.  
  810.  Conversely, it is possible to have both left-hand and right-hand comments on 
  811.  the same line. RCF/2 can handle this, but the user may find that the lines in 
  812.  the program will be too long and unwieldily to provide a reasonably "readable" 
  813.  program. 
  814.  
  815.  
  816. ΓòÉΓòÉΓòÉ 3.1.4.1. Full-line Comments ΓòÉΓòÉΓòÉ
  817.  
  818. To define how full-line comments are to be aligned, you must specify the left 
  819. and right alignment requirements for the comment. 
  820.  
  821. Full-line Comments Left Indentation. 
  822.  
  823. The left-hand alignment of a full-line comment is control by the type of 
  824. indentation you select. 
  825.  
  826.  No Action 
  827.            If this option is selected, any full-line comment will be written 
  828.            out in the same form and with the same indentation as found in the 
  829.            source program. 
  830.  
  831.  No indentation 
  832.            All full-line comments will be left justified. 
  833.  
  834.  Conditional Indentation 
  835.            If the comment in the input source begins in column 1, it will be 
  836.            formatted to begin in column 1 in the output. In all other cases, 
  837.            the comment will be formatted to align with the current indentation. 
  838.  
  839.  Always use current indentation 
  840.            All comments will be aligned according to the current indentation. 
  841.  
  842.  Full-line Comments Right Alignment 
  843.  
  844.  The right-hand alignment of a full-line comment is control by the type of 
  845.  alignment you select. 
  846.  
  847.  No Action 
  848.            If this option is selected, any full-line comment will be written 
  849.            out with the same alignment as found in the source program. 
  850.  
  851.  Same as right-hand comments 
  852.            All full-line comments will have the same right-hand alignment as 
  853.            that specified for right-hand comments. 
  854.  
  855.  Align on column 
  856.            You may select a column value that will specify on what column the 
  857.            full-line comments are to be right-aligned. 
  858.  
  859.            Use the scroll buttons to the right to select the column number to 
  860.            be used. 
  861.  
  862.  Align with extension / truncation 
  863.            If you have selected Same as right-hand comments or Align on column 
  864.            for the right-hand alignment of full-line comments, you have the 
  865.            option of selecting some special processing called "extension or 
  866.            truncation" of special full-line comments. This option is of 
  867.            particular interest to those that like to "box" their comments. 
  868.  
  869.            If a full-line comment needs to be extended or truncated in order to 
  870.            meet the full-line comment right alignment specification, there is 
  871.            some additional processing that occurs. RCF/2 ignores any starting 
  872.            slash-asterisk and any ending asterisk-slash, and it looks at the 
  873.            remaining characters. If all the characters are the same, RCF/2 will 
  874.            extend or truncate the characters and adjust any slash-asterisk and 
  875.            asterisk slash as necessary. 
  876.  
  877.            For example, assume the input data is as follows: 
  878.  
  879.                             Column--> 1                 20
  880.                                       |                  |
  881.                                       /*------------------------------*/
  882.                                       /* Comment */
  883.                                       /*-----------*/
  884.  
  885.            If the alignment for full-line comments is 1 and 20, then the result 
  886.            will be: 
  887.  
  888.                             Column--> 1                 20
  889.                                       |                  |
  890.                                       /*----------------*/
  891.                                       /* Comment        */
  892.                                       /*----------------*/
  893.  
  894.            In other words the first comment line was truncated to align 
  895.            properly, and the third comment line was extended with the same 
  896.            character repeated so as to align according to the specifications. 
  897.            The middle comment, because it was not composed of a single 
  898.            character, simply had its asterisk-slash aligned. 
  899.  
  900.            If the Align with extension / truncation box is checked, all 
  901.            full-line comments will be truncated or extended in the manner 
  902.            described above. 
  903.  
  904.            The following options only apply to full-line comments that do not 
  905.            terminate with a final asterisk-slash. That is, they are comments 
  906.            that are continued on the following statement. 
  907.  
  908.            Full alignment 
  909.                           If a full-line comment does not terminate with a 
  910.                           slash-asterisk, and it is composed of only one 
  911.                           character, the character is repeated or truncated so 
  912.                           that the final occurrence of the character is on the 
  913.                           right-hand alignment column specification. 
  914.  
  915.                           For example, if the input looked as follows: 
  916.  
  917.                                                           Column--> 1                 20
  918.                                                                     |                  |
  919.                                                                     /*-------------------------------
  920.                                                                      Comment
  921.                                                                      -------------*/
  922.  
  923.                           The result would be: 
  924.  
  925.                                                           Column--> 1                 20
  926.                                                                     |                  |
  927.                                                                     /*------------------
  928.                                                                      Comment
  929.                                                                      -----------------*/
  930.  
  931.            One-short alignment 
  932.                           Any extension or truncation of a full-line comment 
  933.                           composed of the same character would be one short of 
  934.                           full alignment. 
  935.  
  936.                           Using the example above, the result would be: 
  937.  
  938.                                                           Column--> 1                 20
  939.                                                                     |                  |
  940.                                                                     /*-----------------
  941.                                                                      Comment
  942.                                                                      -----------------*/
  943.  
  944.            Two-short alignment 
  945.                           Any extension or truncation of a full-line comment 
  946.                           composed of the same character would be two short of 
  947.                           full alignment. 
  948.  
  949.                           Using the example above, the result would be: 
  950.  
  951.                                                           Column--> 1                 20
  952.                                                                     |                  |
  953.                                                                     /*----------------
  954.                                                                      Comment
  955.                                                                      -----------------*/
  956.  
  957.  
  958. ΓòÉΓòÉΓòÉ 3.1.4.2. Left and Right-hand Comments ΓòÉΓòÉΓòÉ
  959.  
  960. To define how left and right-hand comments are to be aligned within a given 
  961. REXX program, select one option from each of the two types of comments listed. 
  962.  
  963. Left-hand Comments 
  964.  
  965. A left-hand comment is a comment that is preceded by, at most, spaces, and it 
  966. is followed by some other REXX object such as a REXX statement or another 
  967. comment. 
  968.  
  969.  No Action 
  970.            If this option is selected, any left hand comment will be written 
  971.            out in the same form and with the same indentation as found in the 
  972.            source program. 
  973.  
  974.  No indentation 
  975.            All left-hand comments will be left justified. 
  976.  
  977.  General indentation 
  978.            All left-hand comments will be aligned according to the general 
  979.            indentation specification as defined under the Indentation page of 
  980.            the configuration notebook. 
  981.  
  982.  Left and right alignment 
  983.            All left-hand comments will be aligned according to the 
  984.            specification given in the Starting column and Ending column values. 
  985.  
  986.            Starting column 
  987.                           Use the scroll buttons to raise or lower the value to 
  988.                           be used for the column where left-hand comments are 
  989.                           to begin. 
  990.  
  991.            Ending column 
  992.                           Use the scroll buttons to raise or lower the value to 
  993.                           be used for the column where left-hand comments are 
  994.                           to end. 
  995.  
  996.            Note:  If you use this option, consider the value that you assign to 
  997.            the General Indentation. A General Indentation that is less than the 
  998.            Ending column may not give you the results that you want. 
  999.  
  1000.  Right-hand Comments 
  1001.  
  1002.  A right-hand comment is a comment that is preceded by some other REXX object, 
  1003.  such as a REXX statement or another comment, and is not followed by anything 
  1004.  except, at most, spaces. 
  1005.  
  1006.  No Action 
  1007.            A right-hand comment will be treated as a text string, and no 
  1008.            formatting will occur except as required to accommodate the text 
  1009.            preceding it. 
  1010.  
  1011.  Left alignment 
  1012.            All right-hand comments will be formatted to begin on the column 
  1013.            specified for the starting column as specified in the Starting 
  1014.            column value at the bottom of the Right-hand Comments box. The 
  1015.            right-hand alignment for all right-hand comments will be set as 
  1016.            needed based on the amount of text in the comment. That is, the 
  1017.            ending asterisk-slash will be placed one space beyond the last 
  1018.            non-blank comment text character. 
  1019.  
  1020.  Right alignment 
  1021.            All right-hand comments will be formatted to end on the column 
  1022.            specified for the Ending column value at the bottom of the 
  1023.            Right-hand Comments box. 
  1024.  
  1025.            Note:  When right alignment is elected, RCF/2 will, if space 
  1026.                   permits, automatically insert a blank between the last 
  1027.                   non-blank character and the terminating slash-asterisk. 
  1028.  
  1029.  Left and right alignment 
  1030.            All right-hand comments will be aligned according to the 
  1031.            specification given for in the Starting column and Ending column 
  1032.            values. 
  1033.  
  1034.            Starting column 
  1035.                           Use the scroll buttons to raise or lower the value to 
  1036.                           be used for the column where right-hand comments are 
  1037.                           to begin. 
  1038.  
  1039.                           This value will be used if you have elected "Left 
  1040.                           alignment" or "Left and right alignment." 
  1041.  
  1042.            Ending column 
  1043.                           Use the scroll buttons to raise or lower the value to 
  1044.                           be used for the column where right-hand comments are 
  1045.                           to end. 
  1046.  
  1047.                           This value will be used if you have elected "Right 
  1048.                           alignment" or "Left and right alignment." 
  1049.  
  1050.  
  1051. ΓòÉΓòÉΓòÉ 3.1.5. Special Options ΓòÉΓòÉΓòÉ
  1052.  
  1053. Commented Line Numbers 
  1054.  
  1055. Unlike some programming languages, such as COBOL, REXX does not have a specific 
  1056. place in each statement to include a line number. However, because any REXX 
  1057. error message references a record or line number, programmers find that it can 
  1058. simplify their debugging process if they can put the record number in each REXX 
  1059. statement. 
  1060.  
  1061. There exist programs which will record line numbers in a set of REXX statements 
  1062. in the form of comments, usually at the end of each statement. These "commented 
  1063. line numbers" do not affect the running of the program, and they can be useful 
  1064. in locating the statement when there is a problem. 
  1065.  
  1066. Because such commented line numbers often appear as the left or right-most 
  1067. comment in a statement, RCF/2 cannot format the "true" left-hand or right-hand 
  1068. comments. To allow for these "commented line numbers" and still format a 
  1069. program containing them, RCF/2 allows for the recognition and generation of 
  1070. such numbers in lieu of using a separate program. 
  1071.  
  1072. To generate or remove commented line numbers, the user should do the following: 
  1073.  
  1074.  Insert in column 
  1075.            If a comment line number is to be inserted in a program, check this 
  1076.            box. 
  1077.  
  1078.            If this box is checked, use the scroll buttons to raise or lower the 
  1079.            value to be used for the column where a commented line number is to 
  1080.            start. 
  1081.  
  1082.  Delete from column 
  1083.            If a comment line number already exists and it is to be deleted from 
  1084.            a program, check this box. 
  1085.  
  1086.            You can also check this box if you plan to insert commented line 
  1087.            numbers, and you may want to process the program again to renumber 
  1088.            the lines. If the commented line numbers are not found in the 
  1089.            location specified, no action is performed. 
  1090.  
  1091.            If this box is checked, use the scroll buttons to raise or lower the 
  1092.            value to be used for the column where a commented line number is to 
  1093.            removed. 
  1094.  
  1095.            Note:  If commented line numbers already exist in the program, be 
  1096.                   sure to delete them, even if you plan to insert them. RCF/2 
  1097.                   needs to delete any commented line numbers before it formats 
  1098.                   the REXX statement so that they do not get treated as normal 
  1099.                   comments. If you have requested "commented line numbers" be 
  1100.                   inserted, they will be added after the REXX statement has 
  1101.                   been formatted. 
  1102.  
  1103.  
  1104. ΓòÉΓòÉΓòÉ 3.2. Closing the RCF/2 Configuration Notebook ΓòÉΓòÉΓòÉ
  1105.  
  1106. There are three ways that you may exit the configuration notebook processing: 
  1107.  
  1108.    1. You may close the notebook and save the settings so that they will be 
  1109.       used immediately and in any future invocation of RCF/2. 
  1110.  
  1111.    2. You may ask for the notebook settings to be saved and used but any 
  1112.       changes will last only for the current invocation of RCF/2. That is, if 
  1113.       you made any changes, these changes will be dropped when RCF/2 is closed, 
  1114.       and the settings that existed before the changes were made will be 
  1115.       restored. 
  1116.  
  1117.    3. You may simply exit the notebook window and cancel any modifications made 
  1118.       to the notebook while it was open. 
  1119.  
  1120.  To close the configuration notebook using one of the above modes, select one 
  1121.  of the buttons at the bottom of the configuration notebook page. 
  1122.  
  1123.  Select: 
  1124.  
  1125.       Save to exit the notebook window and save any modifications for use now 
  1126.       and for any future invocation of RCF/2. 
  1127.  
  1128.       Exit to exit the notebook window and save any modifications until RCF/2 
  1129.       is terminated. 
  1130.  
  1131.       Cancel to exit the notebook window without saving any modifications. 
  1132.  
  1133.  
  1134. ΓòÉΓòÉΓòÉ 3.3. Editor Specification ΓòÉΓòÉΓòÉ
  1135.  
  1136. RCF/2 provides for the user to edit the input program. 
  1137.  
  1138. By default, REXX Code Formatter/2 assumes the OS/2 E editor is available. You 
  1139. may, however, specify a different editor my adding it to your configuration. To 
  1140. do this, perform the following: 
  1141.  
  1142.    1. Click on the Configure menu item on the RCF/2 main window menu bar. 
  1143.  
  1144.    2. Click on Editor on the resulting pull-down menu. 
  1145.  
  1146.    3. Using the resulting dialog box, locate the editor to be used. 
  1147.  
  1148.    4. When the editor is located, double click on the name of editor, or click 
  1149.       once on the editor name and then once on the OK button. 
  1150.  
  1151.  Afterwards, you may then edit the input program using the defined editor by 
  1152.  selecting the Action button on the menu bar followed by the Edit action on the 
  1153.  resulting pull-down menu. 
  1154.  
  1155.  Note:  If you specify the name of the editor in the dialog box, directly, 
  1156.         rather than locating it, you must specify the fully qualified name of 
  1157.         the editor. RCF/2 will check the name given, and if the file does not 
  1158.         exist as given, the Edit option will not be selectable on the Action menu.
  1159.  
  1160.  
  1161. ΓòÉΓòÉΓòÉ 4. Opening a REXX Source Program ΓòÉΓòÉΓòÉ
  1162.  
  1163. You must open the REXX source program that you wish to process. Once it has 
  1164. been opened, you may then format or edit it. 
  1165.  
  1166. To open a source program, do the following: 
  1167.  
  1168.    1. Select File from the RCF/2 main window menu bar. 
  1169.  
  1170.    2. Select Open from the resulting pull-down menu. 
  1171.  
  1172.    3. Using the dialog box, select the file to be processed. 
  1173.  
  1174.  Note:  The name of the selected file always appears just below the RCF/2 main 
  1175.  window menu bar. If no name is shown, no formatting is possible, and you must 
  1176.  perform this "opening" process. 
  1177.  
  1178.  
  1179. ΓòÉΓòÉΓòÉ 5. Processing a REXX Source Program ΓòÉΓòÉΓòÉ
  1180.  
  1181. There are two actions that are possible on any Open REXX source program: 
  1182.  
  1183.       You may format the identified program, or 
  1184.  
  1185.       You may edit it. 
  1186.  
  1187.  If you have selected labels, variables, or function names to be 
  1188.  cross-referenced in the General Settings of the RCF/2 configuration, you may, 
  1189.  as a third action, show cross references after a program has been formatted. 
  1190.  
  1191.  
  1192. ΓòÉΓòÉΓòÉ 5.1. Formatting ΓòÉΓòÉΓòÉ
  1193.  
  1194. To format an open REXX source program, do the following: 
  1195.  
  1196.    1. Select Action from the RCF/2 main window menu bar. 
  1197.  
  1198.    2. Select Format from the resulting pull-down menu. 
  1199.  
  1200.  
  1201. ΓòÉΓòÉΓòÉ 5.2. Formatting Notes ΓòÉΓòÉΓòÉ
  1202.  
  1203. During the formatting process, it is not always possible to format a program 
  1204. according to your configuration specifications. For example, you might have a 
  1205. left-hand comment that is too long to fit within the comment positioning values 
  1206. you have set, or the text of a statement is too long to permit proper alignment 
  1207. of a right-hand comment. 
  1208.  
  1209. Additionally, certain coding errors can also be detected such as a quoted 
  1210. string literal with no ending quote or a comment not closed when an end of file 
  1211. is reached on the input program. 
  1212.  
  1213. If any problem or other formatting condition is experienced during the 
  1214. formatting process, RCF/2 will generate, when the formatting process is 
  1215. complete, a secondary window listing the formatting notes. 
  1216.  
  1217. The illustration below is an example of a program in which a couple of 
  1218. formatting problems were encountered. 
  1219.  
  1220. Note:  A REXX Code Formatter/2 Notes window will not be displayed unless there 
  1221. is at least one formatting note. 
  1222.  
  1223.  
  1224. ΓòÉΓòÉΓòÉ 5.2.1. Working with Formatting Notes ΓòÉΓòÉΓòÉ
  1225.  
  1226. When the REXX Code Formatter/2 Notes window is displayed, you may close the 
  1227. window or print a list of the notes. You may also review the notes and examine 
  1228. the corresponding output line to which the note refers. 
  1229.  
  1230. If you click on any note, the corresponding formatted output will be 
  1231. highlighted and displayed in the RCF/2 main window. (The first note and its 
  1232. corresponding statement will always be preselected for you.) 
  1233.  
  1234. You will also see, in the upper right-hand corner of the RCF/2 main window, the 
  1235. input record number and output line number associated with this note. If you 
  1236. wish to fix the formatting anomaly, you may invoke the editor, go to the 
  1237. referenced record number, make the desired changes, and reformat the program. 
  1238.  
  1239.  
  1240. ΓòÉΓòÉΓòÉ 5.3. Editing ΓòÉΓòÉΓòÉ
  1241.  
  1242. To edit an open REXX source program, do the following: 
  1243.  
  1244.    1. Select Action from the RCF/2 main window menu bar. 
  1245.  
  1246.    2. Select Edit from the resulting pull-down menu. 
  1247.  
  1248.  
  1249. ΓòÉΓòÉΓòÉ 5.4. Show Cross References ΓòÉΓòÉΓòÉ
  1250.  
  1251. If you have selected one or more items to be cross referenced in the General 
  1252. Settings section of the configuration settings notebook, you may display the 
  1253. results by doing the following: 
  1254.  
  1255.    1. Select Action from the RCF/2 main window menu bar. 
  1256.  
  1257.    2. Select Show from the resulting pull-down menu. 
  1258.  
  1259.    3. Select Labels X-Ref, Variables X-Ref, or Functions X-Ref from the 
  1260.       pull-down menu. 
  1261.  
  1262.  
  1263. ΓòÉΓòÉΓòÉ 6. Saving Formatted Results ΓòÉΓòÉΓòÉ
  1264.  
  1265. After a program has been formatted, you may replace the original input with the 
  1266. formatted results, or you may save the formatted version of the input program 
  1267. in another directory or under a different name. 
  1268.  
  1269. To replace the original input file with the formatted version of the file, do 
  1270. the following: 
  1271.  
  1272.    1. Select File from the RCF/2 main window menu bar. 
  1273.  
  1274.    2. Select Save from the resulting pull-down menu. 
  1275.  
  1276.  To save the formatted results under an different name or in a different 
  1277.  directory, do the following: 
  1278.  
  1279.    1. Select File from the RCF/2 main window menu bar. 
  1280.  
  1281.    2. Select Save As from the resulting pull-down menu. 
  1282.  
  1283.    3. Using the dialog box: 
  1284.  
  1285.            Select the directory where the newly formatted program is to be 
  1286.            stored, and 
  1287.  
  1288.            Modify the name of the program if it is to be different than the one 
  1289.            shown. 
  1290.  
  1291.    4. Click on OK to save the formatted program. 
  1292.  
  1293.  To replace the original input file with the formatted version of the file and 
  1294.  then exit RCF/2, do the following: 
  1295.  
  1296.    1. Select File from the RCF/2 main window menu bar. 
  1297.  
  1298.    2. Select Save & Exit from the resulting pull-down menu. 
  1299.  
  1300.  
  1301. ΓòÉΓòÉΓòÉ 7. Processing Multiple REXX Source Programs ΓòÉΓòÉΓòÉ
  1302.  
  1303. When a large number of REXX programs are involved in a project, it is sometimes 
  1304. desirable to format the programs in that project without going through the 
  1305. tedious process of formatting each one. This is possible by selecting the 
  1306. directory to be processed and then requesting that the REXX programs in the 
  1307. selected directory be formatted. 
  1308.  
  1309. To select a directory containing one or more REXX programs that are to be 
  1310. formatted, do the following: 
  1311.  
  1312.    1. Select File from the RCF/2 main window menu bar. 
  1313.  
  1314.    2. Select Select Directory from the resulting pull-down menu. 
  1315.  
  1316.  This action will display a window from which the directory or project to be 
  1317.  processed can be selected. 
  1318.  
  1319.  
  1320. ΓòÉΓòÉΓòÉ 7.1. Selecting a Directory or Project ΓòÉΓòÉΓòÉ
  1321.  
  1322. To select a directory or project containing multiple REXX programs, from the 
  1323. window that results from clicking on the Select Directory option, do the 
  1324. following: 
  1325.  
  1326.    1. Select the drive that contains the directory or project to be used. 
  1327.  
  1328.    2. Select the starting directory. 
  1329.  
  1330.    3. Select one of the options to the left.  Specifically, select: 
  1331.  
  1332.            Exclude Subdirectories to process the REXX programs only in the 
  1333.            selected directory. 
  1334.  
  1335.            Include Subdirectories to process the REXX programs in the selected 
  1336.            directory and all directories subordinate to the selected directory. 
  1337.  
  1338.            Subdirectories Only to process only the REXX programs that are in a 
  1339.            directory subordinate to the selected directory. 
  1340.  
  1341.            VisPro/REXX Project to process the REXX programs in a VisPro/REXX 
  1342.            starting directory. 
  1343.  
  1344.            Note:  If the selected directory is a VisPro/REXX project, the 
  1345.            selected REXX programs will come from the SUBPROCS, THREADS, and 
  1346.            defined forms subdirectories. REXX programs in the selected 
  1347.            directory and other subordinate directories will be ignored. 
  1348.  
  1349.    4. Click on the Select button to display the list of REXX programs that meet 
  1350.       the selection criteria. 
  1351.  
  1352.  
  1353. ΓòÉΓòÉΓòÉ 7.2. Formatting Multiple Programs ΓòÉΓòÉΓòÉ
  1354.  
  1355. When a directory or project is selected, a list of all the files that appear to 
  1356. be REXX programs are displayed. 
  1357.  
  1358. Note:  The option of processing multiple REXX programs is limited to registered 
  1359. users of RCF/2. 
  1360.  
  1361. By default, all the REXX programs found will be selected for formatting. Any 
  1362. files that should not be formatted may be de-selected by clicking on the file 
  1363. name, or all the files may be de-selected and individual files selected for 
  1364. formatting by clicking on the file names. 
  1365.  
  1366. When the files to be formatted have been selected, formatting is initiated by: 
  1367.  
  1368.    1. Select Format from the RCF/2 REXX Files List window menu bar. 
  1369.  
  1370.    2. Select one of the following from the resulting pull-down menu: 
  1371.  
  1372.           Pause to format the selected REXX program files and pause for user 
  1373.            action when the formatting is complete for each program. 
  1374.  
  1375.            If a program is formatted without any errors, the user may save the 
  1376.            formatting results or cancel the multiple formatting session. 
  1377.  
  1378.            If formatting errors are detected, the errors found will be 
  1379.            displayed. Closing the window displaying the formatting notes will 
  1380.            allow the user to indicate whether the formatting results should be 
  1381.            saved or skipped or the multiple formatting session should be 
  1382.            cancelled. 
  1383.  
  1384.           Pause if messages to format the selected REXX programs and pause for 
  1385.            user action only when one or more formatting errors are detected in 
  1386.            the program being formatted. 
  1387.  
  1388.            If formatting errors are detected, the errors found will be 
  1389.            displayed. Closing the window displaying the formatting notes will 
  1390.            allow the user to indicate whether the formatting results should be 
  1391.            saved or skipped or the multiple formatting session should be 
  1392.            cancelled. 
  1393.  
  1394.           No pause to format all the selected REXX program files without 
  1395.            pausing for user action. 
  1396.  
  1397.            When this option is selected, all formatting errors are ignored. 
  1398.  
  1399.            When formatting without pausing, a second window is opened in the 
  1400.            lower left portion of the screen that allows the user to monitor 
  1401.            what file is being formatted and to abort the formatting process, if 
  1402.            so desired. 
  1403.  
  1404.  
  1405. ΓòÉΓòÉΓòÉ 8. Printing ΓòÉΓòÉΓòÉ
  1406.  
  1407. After RCF/2 has formatted a program, you may print a listing of that program or 
  1408. any created cross references. 
  1409.  
  1410. To generate hardcopy output of a formatted program or cross references, do the 
  1411. following: 
  1412.  
  1413.    1. Select File from the RCF/2 main window menu bar. 
  1414.  
  1415.    2. Select Print from the resulting pull-down menu. 
  1416.  
  1417.    3. Select Program, Labels x-ref, Variables x-ref, or Functions x-ref from 
  1418.       the second pull-down menu. 
  1419.  
  1420.    4. Select Landscape report orientation from the resulting dialog menu if you 
  1421.       have selected this type of report using the Program Listing Options. 
  1422.  
  1423.    5. Click on the Print button. 
  1424.  
  1425.  Note:  The format of the generated listing is controlled by the options 
  1426.         defined by the Program Listing Options.
  1427.  
  1428.  
  1429. ΓòÉΓòÉΓòÉ 9. Program Listing Options ΓòÉΓòÉΓòÉ
  1430.  
  1431. RCF/2 allows you to print your formatted program using VisPro/Reports. 
  1432.  
  1433. The generated reports are printed using a mono-spaced Courier font, and you may 
  1434. pick one of two font sizes, 8-point or 10-point, with corresponding lines per 
  1435. inch spacing, depending on your preference. You may also select whether you 
  1436. wish the report to formatted for portrait or landscape orientation. 
  1437.  
  1438. The Print Options allow you to specify which format you prefer for your program 
  1439. listings. 
  1440.  
  1441. Report Format 
  1442.  
  1443.  Portrait - 80 Characters per line 
  1444.            The form of this report is with Portrait orientation, and it will 
  1445.            print up to 80 characters on a single line using a 10-point Courier 
  1446.            font. Any formatted record longer than 80 characters will be printed 
  1447.            on multiple lines, 80 characters at a time, until the record is 
  1448.            printed. 
  1449.  
  1450.            Vertically, the output report will be spaced at approximately six 
  1451.            lines to the inch. 
  1452.  
  1453.  Portrait - 105 Characters per line 
  1454.            The form of this report is with Portrait orientation, will print up 
  1455.            to 105 characters on a single line using an 8-point Courier font. 
  1456.            Any formatted record longer than 105 characters will be printed on 
  1457.            multiple lines, 105 characters at a time, until the record is 
  1458.            printed. 
  1459.  
  1460.            Vertically, the output report will be spaced at approximately eight 
  1461.            lines to the inch. 
  1462.  
  1463.  Landscape - 110 Characters per line 
  1464.            The form of this report is with Landscape orientation, and it will 
  1465.            print up to 110 characters on a single line using a 10-point Courier 
  1466.            font. Any formatted record longer than 110 characters will be 
  1467.            printed on multiple lines, 110 characters at a time, until the 
  1468.            record is printed. 
  1469.  
  1470.            Vertically, the output report will be spaced at approximately six 
  1471.            lines to the inch. 
  1472.  
  1473.  Landscape - 180 Characters per line 
  1474.            The form of this report is with Landscape orientation, will print up 
  1475.            to 180 characters on a single line using an 8-point Courier font. 
  1476.            Any formatted record longer than 180 characters will be printed on 
  1477.            multiple lines, 180 characters at a time, until the record is 
  1478.            printed. 
  1479.  
  1480.            Vertically, the output report will be spaced at approximately eight 
  1481.            lines to the inch. 
  1482.  
  1483.  Date and time format to use on listing 
  1484.  
  1485.  All generated reports will be date and time stamped according to when the 
  1486.  request for printing occurred. You may select the format for the date and time 
  1487.  by selecting the desired value. 
  1488.  
  1489.  Use American date format 
  1490.            The printed date will be of the form "month day, year." "October 5, 
  1491.            1996" is an example of this form of date-stamp. 
  1492.  
  1493.  Use European date format 
  1494.            The printed date will be of the form "day month year." "5 October 
  1495.            1996" is an example of this form of date-stamp. 
  1496.  
  1497.  Use 12-hour clock 
  1498.            When this option is elected, the time shown on the report will be of 
  1499.            the form "hh:mm" with the appropriate "am" or "pm" showing. "1:47pm" 
  1500.            is an example of this form of time-stamp. 
  1501.  
  1502.  Use 24-hour clock 
  1503.            When this option is elected, the time shown on the report will be of 
  1504.            the form "hh:mm" with the hour (hh) ranging in value from 00 to 23. 
  1505.            "13:47" is an example of this form of time-stamp. 
  1506.  
  1507.  To close the Print Options window, do one of the following: 
  1508.  
  1509.      Select Okay to save any changes to the Print Options settings. 
  1510.  
  1511.      Select Cancel to cancel any changes made are keep the Print Options 
  1512.       settings as they were. 
  1513.  
  1514.  
  1515. ΓòÉΓòÉΓòÉ 10. Exiting RCF/2 ΓòÉΓòÉΓòÉ
  1516.  
  1517. You may exit REXX Code Formatter/2 by any of the following methods: 
  1518.  
  1519.      Select File from the RCF/2 main window menu bar and then click on Exit in 
  1520.       the resulting pull-down menu. 
  1521.  
  1522.      If the main RCF/2 window is in focus, press F3 
  1523.  
  1524.      Click on the REXX Code Formatter/2 icon in the upper left corner of the 
  1525.       main RCF/2 window and select Close from the resulting pull-down menu. 
  1526.  
  1527.      Double click on the REXX Code Formatter/2 icon in the upper left corner 
  1528.       of the main RCF/2 window. 
  1529.  
  1530.  
  1531. ΓòÉΓòÉΓòÉ 11. Invoking RCF/2 From a Command Line ΓòÉΓòÉΓòÉ
  1532.  
  1533. A REXX program may be formatted by invoking a special "stand-alone" version of 
  1534. RCF/2 from the command line of an OS/2 window or OS/2 full screen session. 
  1535.  
  1536. Note:  The formatting performed will be done according to the last saved 
  1537. configuration settings. 
  1538.  
  1539. To call RCF/2 from a command line, you must use the RCF2SA.EXE program located 
  1540. in the RCF/2 directory. This program contains all the RCF/2 formatting 
  1541. functions, but it does not make any OS/2 GUI (Graphical User Interface) calls. 
  1542. All messages are written to the session screen, and any errors are noted on the 
  1543. screen or written to a error file specified by the user. 
  1544.  
  1545. Note:  This program is for registered users of RCF/2 only. 
  1546.  
  1547.  
  1548. ΓòÉΓòÉΓòÉ 11.1. RCF/2 Stand-Alone Command Line Syntax ΓòÉΓòÉΓòÉ
  1549.  
  1550. The syntax for the command line invocation of RCF/2 is: 
  1551.  
  1552.     RCF2SA [input-file] [output-file] [error-file] [/option]
  1553.  
  1554. Where: 
  1555.  
  1556.  Parameter      Description 
  1557.  
  1558.  input-file     The fully qualified name of the REXX source file to be 
  1559.                 formatted. If it is not specified, the last used REXX program 
  1560.                 source file will be processed. This parameter must be given if 
  1561.                 there is no previous file, or the previously formatted file no 
  1562.                 longer exists. 
  1563.  
  1564.  output-file    The fully qualified name of the formatted, output REXX source 
  1565.                 program to be written. If this parameter is not given, the 
  1566.                 results of the formatting will replace the input file. 
  1567.  
  1568.  error-file     The fully qualified name of the file to be created if any 
  1569.                 errors or notes about the formatting action are generated. If 
  1570.                 this file is not specified, or no errors or notes are 
  1571.                 generated, this file will not be created. 
  1572.  
  1573.  option         The option whether errors or formatting notes are to be 
  1574.                 displayed in the OS/2 window or OS/2 full screen session. 
  1575.  
  1576.                 Option     Action 
  1577.  
  1578.                 Show       Display any errors or formatting notes as they 
  1579.                            occur. This is the default if no error-file is 
  1580.                            specified. 
  1581.  
  1582.                 Noshow     Do not display any errors or formatting notes. This 
  1583.                            is the default if an error-file is specified. 
  1584.  
  1585.  Note:  The input-file, output-file, and error-file parameters are positional. 
  1586.  Any of these parameters may be omitted by: 
  1587.  
  1588.    1. Leaving the parameter blank if no other parameters follow with the 
  1589.       exception of an option, or 
  1590.  
  1591.    2. Specifying an omitted parameter by a period, which acts as a place-holder 
  1592.       for the omitted parameter. 
  1593.  
  1594.  
  1595. ΓòÉΓòÉΓòÉ 12. Registration ΓòÉΓòÉΓòÉ
  1596.  
  1597. This is a program that is offered as a software product. Registration fee is 
  1598. $15 U.S. per copy. 
  1599.  
  1600. To register your copy of REXX Code Formatter/2 and receive your Registration 
  1601. Key, order RCF/2 from BMT Micro. 
  1602.  
  1603. To order from BMT Micro, use the following BMT Micro ordering information: 
  1604.  
  1605.  
  1606.                   Mail Orders To: BMT Micro
  1607.                                   PO Box 15016
  1608.                                   Wilmington, NC 28408
  1609.                                   U.S.A.
  1610.  
  1611.                     Voice Orders: 8:00am - 7:00pm EST (-5 GMT)
  1612.                                   (800) 414-4268 (orders only)
  1613.                                   (910) 791-7052
  1614.  
  1615.                       Fax Orders: (910) 350-2937  24 hours / 7 Days
  1616.                                   (800) 346-1672  24 hours / 7 Days
  1617.  
  1618.          Online Orders via modem: (910) 350-8061  10 lines, all 14.4K
  1619.                                   (910) 799-0923  Direct 28.8K line
  1620.  
  1621.      Ordering and general ordering questions:
  1622.                          Via AOL: bmtmicro
  1623.                          via MSN: bmtmicro
  1624.                      Via Prodigy: HNGP66D
  1625.                   via Compuserve: 74031,307
  1626.                     via Internet: orders@bmtmicro.com
  1627.                                   telnet@bmtmicro.com
  1628.                                   http://www.bmtmicro.com
  1629.  
  1630.  
  1631.      We accept Visa, Mastercard, Discover, American Express, Diners
  1632.      Club, Carte Blanche, Cashiers Check, Personal Check.   Personal
  1633.      checks are subject to clearance.  Eurochecks in DM are welcome.
  1634.      DM, Sterling, and US Currency is welcome but send only by
  1635.      registered mail, return receipt requested.   We cannot be liable
  1636.      for lost cash sent through the mail.
  1637.  
  1638.      Purchase orders are welcome, subject to approval.   The minimum
  1639.      amount is $250.00.
  1640.  
  1641.      Information for our German customers is explained in the last
  1642.      paragraph of this order form.
  1643.  
  1644.      _____________________________________________________________________
  1645.  
  1646.      Company:_____________________________________________________________
  1647.  
  1648.      Name:________________________________________________________________
  1649.  
  1650.      Address:_____________________________________________________________
  1651.  
  1652.              _____________________________________________________________
  1653.  
  1654.      City: _______________________________State/Province: ________________
  1655.  
  1656.      Postal/ZIP Code: ____________________Country:________________________
  1657.  
  1658.      Phone:_______________________________________________________________
  1659.  
  1660.      Fax:  _______________________________________________________________
  1661.  
  1662.      E-Mail #1____________________________________________________________
  1663.  
  1664.      E-Mail #2____________________________________________________________
  1665.  
  1666.  
  1667.      Product                    Quantity Price  Number of copies
  1668.      _________________________  ______________  ________________
  1669.  
  1670.      _________________________  ______________  x ____________ = + $ _______
  1671.  
  1672.      _________________________  ______________  x ____________ = + $ _______
  1673.  
  1674.      _________________________  ______________  x ____________ = + $ _______
  1675.  
  1676.      Latest Version on Diskette _____$3.00____  x ____________ = + $ _______
  1677.  
  1678.  
  1679.      North Carolina Residents add 6% Sales Tax                     $ _______
  1680.  
  1681.      Shipping and Handling (no quantity limit / see below)         $ _______
  1682.  
  1683.        Email - Subject to Credit Card Verification     Free
  1684.        Fax (USA/Canada)...........................     1.00 US
  1685.        Fax (Non-North America)....................     2.00 US
  1686.        Worldwide 1st Class .......................     Free
  1687.        2nd Day Priority, USA Only ................ $   4.00 US
  1688.        US Postal Service International Express
  1689.          (Including Canada and Mexico), allow up to
  1690.          7-10 days ............................... $  25.00 US
  1691.        Airborne Select Delivery  (USA Only)        $   8.00 US
  1692.        FedEx Overnight, USA Only (delivery by
  1693.          3:00 pm the following day) .............. $  15.00 US
  1694.        FedEx Europe/Japan (guaranteed delivery
  1695.          within 3 days) .......................... $  35.00 US
  1696.  
  1697.  
  1698.      Total:                                                      $ _______
  1699.  
  1700.      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1701.      Γöé                                                                   Γöé
  1702.      Γöé For credit card payment only                                      Γöé
  1703.      Γöé                                                                   Γöé
  1704.      Γöé Circle one: VISA / Master / Discover / American Express / Diners  Γöé
  1705.      Γöé                                                                   Γöé
  1706.      Γöé Credit card number: _____________________________________________ Γöé
  1707.      Γöé                                                                   Γöé
  1708.      Γöé Expiration date: ________________________________________________ Γöé
  1709.      Γöé                                                                   Γöé
  1710.      Γöé Authorization signature: ________________________________________ Γöé
  1711.      Γöé                                                                   Γöé
  1712.      ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1713.  
  1714.  
  1715.                    ORDERING FROM INSIDE GERMANY ONLY
  1716.                    =================================
  1717.  
  1718. Persons in Germany wishing to order shareware may also transfer funds
  1719. into our account with Deutsche Bank.   Once the money is deposited you
  1720. may either fax a confirmation to us with proof of deposit or wait until
  1721. Deutsche Bank notifies us of the transaction (usually 10-18 business days).
  1722. Account information is as follows:
  1723.  
  1724. Deutsche Bank / Frankfurt Branch
  1725. Empf╨önger:  Thomas Bradford / BMT Micro
  1726. Konto-Nummer: 0860221
  1727. Bankleitzahl: 500-700-10
  1728.  
  1729. When you make the transfer, be sure to put your name and the program you
  1730. are registering on the transfer.
  1731.  
  1732. Current exchange rates can be obtained by sending an email to
  1733. dm_to_us@bmtmicro.com.   An automated reply will return todays exchange
  1734. rates.
  1735.  
  1736. It is very important that you send us a completed order form by
  1737. either email or fax if you deposit money into this account for a
  1738. registration.  Fill the order form out as usual except in the credit
  1739. card number field put "DEUTSCHE BANK".   We will file the order and
  1740. use it to match against the deposit information we receive from the
  1741. bank.
  1742.  
  1743.                                IMPORTANT!
  1744.                                ----------
  1745. When you email us your order form, we will reply with an
  1746. acknowledgement.   If you do not get an acknowledgement within 24 hours
  1747. please send your order again in case it was lost.  This extra bit of
  1748. caution can save a lot of confusion.
  1749.  
  1750. If you are concerned that your order is taking too long to process, feel
  1751. free to check with us about the status of your order.   It's important
  1752. to all of us that you feel safe doing business with our company and
  1753. please feel free to suggest ways we can improve our service to you.
  1754.  
  1755.  
  1756. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1757.  
  1758. VisPro/REXX is a trademark of HockWare, Inc.
  1759.  
  1760.  
  1761. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1762.  
  1763. VisPro/Reports is a trademark of HockWare, Inc.
  1764.  
  1765.  
  1766. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1767.  
  1768. The Save option saves the current settings of the configuration notebook so 
  1769. that the settings will be used when returning to the main RCF/2 window, and 
  1770. they will be used on all future invocations of RCF/2.
  1771.  
  1772.  
  1773. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1774.  
  1775. The Exit option saves the current settings of the configuration notebook, but 
  1776. any changes to the configuration will be discarded when leaving RCF/2. To 
  1777. permanently save any changes to the configuration notebook, use the Save menu option.
  1778.  
  1779.  
  1780. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1781.  
  1782. The Cancel option terminates the configuration notebook and discards any 
  1783. changes made to the configuration.
  1784.  
  1785.  
  1786. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1787.  
  1788. Labelled routines within a program are internal functions when invoked by a 
  1789. call to that routine. RCF/2 will format such calls according to the configured 
  1790. rules for function name formatting.
  1791.  
  1792.  
  1793. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1794.  
  1795. The only exception to this is the first record of input. OS/2 requires that the 
  1796. slash-asterisk in the first record, which must always begin with a comment, 
  1797. start in column one. If it does not, RCF/2 will left justify the comment and 
  1798. notify you that this change has been made.
  1799.  
  1800.  
  1801. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1802.  
  1803. The current indentation is the indentation actually in effect based on the open 
  1804. Do and Select statements, the general indentation, and so forth.
  1805.  
  1806.  
  1807. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1808.  
  1809. Even if you do not modify the program, you may wish to reformat after 
  1810. generating an Associated Label File as described under Label Names Formatting.
  1811.  
  1812.  
  1813. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1814.  
  1815. This is the main REXX Code Formatter/2 window. All the facilities of RCF/2 are 
  1816. available using the menu bar, and all formatting actions performed are 
  1817. reflected in the body of the window.
  1818.  
  1819.  
  1820. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1821.  
  1822. This is the body of the REXX Code Formatter/2 window. 
  1823.  
  1824. When formatting occurs, this part of the display will show the results of the 
  1825. formatting action.
  1826.  
  1827.  
  1828. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1829.  
  1830. The name of the "opened" program file appears here. Any Format or Edit action 
  1831. will process the file named in this area of the window. 
  1832.  
  1833. If no name is shown, no REXX source file is currently defined to RCF/2, and 
  1834. formatting is not possible.
  1835.  
  1836.  
  1837. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1838.  
  1839. The two numbers displayed here show the number of the input and output 
  1840. statements associated with the currently selected (highlighted) line in the 
  1841. body of the display. 
  1842.  
  1843. The first number is the number of the input record used partially or entirely 
  1844. to generate this line of output, and the second number is the output line 
  1845. number. Any formatting notes will always reference the output line number.
  1846.  
  1847.  
  1848. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1849.  
  1850. The menu bar is used to initiate some facility of RCF/2. 
  1851.  
  1852. Using the options on this bar you may: 
  1853.  
  1854.       Select File to: 
  1855.  
  1856.           Identify the REXX source program to be processed, 
  1857.           Save or Print the formatted results, or 
  1858.           Exit REXX Code Formatter/2. 
  1859.  
  1860.       Select Configure to: 
  1861.  
  1862.           Define the style to be used for formatting, and 
  1863.           Identify an editor to be used if needed. 
  1864.  
  1865.       Select Action to: 
  1866.  
  1867.           Format a REXX program, 
  1868.           Edit a REXX program, or 
  1869.           Show cross-reference information. 
  1870.  
  1871.       Select Help to: 
  1872.  
  1873.           View this help information, 
  1874.           Display product information, or 
  1875.           Register RCF/2. 
  1876.  
  1877.  
  1878. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1879.  
  1880. If the notes window is in the way, you can simply drag it to one side to 
  1881. examine the statement of interest.
  1882.  
  1883.  
  1884. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1885.  
  1886. To close the REXX Code Formatter/2 Notes window, click on the Exit option of 
  1887. its menu bar.
  1888.  
  1889.  
  1890. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1891.  
  1892. To print a listing of the generated notes, click on the Print option of the 
  1893. REXX Code Formatter/2 Notes menu bar.
  1894.  
  1895.  
  1896. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1897.  
  1898. It is also possible to format a REXX source program using RCF/2 from the 
  1899. command line of an OS/2 Window or OS/2 Full Screen session. For a description 
  1900. of this RCF/2 feature, see: Invoking RCF/2 From a Command Line. 
  1901.  
  1902.  
  1903. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1904.  
  1905. A project may be all the REXX programs in a directory, including that 
  1906. directory's sub-directories, or a VisPro/REXX project.
  1907.  
  1908.  
  1909. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1910.  
  1911. The directories available are displayed in a hierarchical format starting with 
  1912. the root directory of the selected drive. Double clicking on a displayed 
  1913. directory line will display, in the lines immediately following, all the next 
  1914. level directories subordinate to the selected directory.
  1915.  
  1916.  
  1917. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1918.  
  1919. Any file with a slash-asterisk (/*) in the first two positions of the first 
  1920. record is considered to be a REXX source