home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rexx25e.zip / REXXEDIT.INF (.txt) < prev    next >
OS/2 Help File  |  1995-09-08  |  14KB  |  511 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Important informations about the shareware release ΓòÉΓòÉΓòÉ
  3.  
  4. This version of RexxEdit can be used on a trial basis for 30 days. If you want 
  5. to use ist after this time you must register. 
  6.  
  7. You can copy this shareware release of RexxEdit and you may give it to friends. 
  8. Please make shure that all files are included with the copy. 
  9.  
  10. If this product is distributed on CD-ROM one CD must be send to me ! 
  11.  
  12. New in version 2.5 of RexxEdit 
  13.  
  14.      Better and faster search and replace option. 
  15.  
  16.      Import of files via menue and drag and drop. 
  17.  
  18.      Icluded is now a graphical DEBUG program. 
  19.  
  20.      Ability to run a compiler (not included). 
  21.  
  22.      Your procedure will run in its own window. 
  23.  
  24.      Most REXX commands are available. 
  25.  
  26.      Many VREXX/2 commands are included. 
  27.  
  28.      VREXX/2 is included. 
  29.  
  30.      Code windows to insert code into the RexxEdit edit field. Inserting via 
  31.       drag and drop or via the clipborad. 
  32.  
  33.      You can cange and customsize the contents of the code window. 
  34.  
  35.      Many internal chages to get RexxEdit faster. 
  36.  
  37.  I have tried to do my best on translating this Software into English, but I am 
  38.  only a human beeing and so some mistakes will still remain. If you find such a 
  39.  mistake, please let me know. I will then correct it as soon as possible. Also 
  40.  If you have a suggestion to the next version, please let me know. RexxEdit was 
  41.  first developed in German and after the big success in Germany I've build an 
  42.  Eglish version. So RexxEdit is available in Germany too. 
  43.  
  44.  Installing RexxEdit. 
  45.  
  46.  To install the shareware version of RexxEdit copy all the files from the disk 
  47.  to a directory of your choice. Then start the INSTALL.CMD file within the 
  48.  directory holding the files. A new container will be created on your OS/2 
  49.  desktop. Within this container you'll find the object of RexxEdit and the 
  50.  objects for the informations about RexxEdit, DEBUG and VREXX/2. 
  51.  
  52.  Limitations of the shareware release. 
  53.  
  54.      The product information is shown at startup and on exit. 
  55.  
  56.      Some REXX commands are not included in the code window. 
  57.  
  58.      The startup file for the compiler ist not included, but you can create it 
  59.       yourself. 
  60.  
  61.      Installing RexxEdit is done by a simple CMD file. 
  62.  
  63.  If you want to contact me here is my address. 
  64.  
  65.  Peter Freitag 
  66.  Computer Consulting and Software Development 
  67.  Koenigsdorfer Strasse 6 
  68.  82547 Beuerberg 
  69.  GERMANY 
  70.  
  71.  Phone: 49-8179-1039 
  72.  Fax:  49-8179-9154 
  73.  CompuServe: 100111,2111 
  74.  Internet: 100111,2111@compuserve.com 
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ 2. Ordering the registered version ΓòÉΓòÉΓòÉ
  78.  
  79. Order form for RexxEdit 2.5 full version
  80.  
  81. Please fill out this form and mail it to
  82.  
  83. Peter Freitag
  84. Koenigsdorfer Strasse 6
  85. 82547 Beuerberg
  86. GERMANY
  87.  
  88.  
  89.  
  90. Name    ________________________________________________________________
  91.  
  92. Company ________________________________________________________________
  93.  
  94. Address ________________________________________________________________
  95.  
  96.         ________________________________________________________________
  97.  
  98. Phone/Fax_______________________________________________________________
  99.  
  100. Where did you hear about RexxEdit ? ____________________________________
  101.  
  102.  
  103. Product                    Quantity Price  Number of copies
  104. _________________________  ______________  ________________
  105.  
  106. RexxEdit 2.5                 $50.00 US   x ____________ = + $ _______
  107.  
  108. Product is shipped on 3.5" diskette.
  109. Shipping and Handling (Worldwide 1st Class is free)
  110.  
  111. Total                                                       $ _______
  112.  
  113. Please include a cheque. Please do not send cash !
  114. You can also include a cheque in your local currency.
  115.  
  116.  
  117. ΓòÉΓòÉΓòÉ 3. RexxEdit 2.5 created by Peter Freitag ΓòÉΓòÉΓòÉ
  118.  
  119. RexxEdit 2.5 
  120. The REXX development system for OS/2 
  121.  
  122. Help is avaliable for all the items shown in the list below. Please select the 
  123. item you need. 
  124.  
  125. File new 
  126. File open 
  127. File save 
  128. File save as 
  129. Import file 
  130. Print file 
  131. Exit 
  132.  
  133. Insert from clipboard 
  134. Clear clipboard 
  135.  
  136. Code window 
  137.  
  138. Debug 
  139. Test 
  140. Compile 
  141.  
  142. Printer menu 
  143.  
  144. Search 
  145.  
  146. Rexx informations 
  147. Debug informations 
  148.  
  149. Hot keys 
  150.  
  151. Product information 
  152. License information 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 3.1. Entry field Parameter. ΓòÉΓòÉΓòÉ
  156.  
  157. You can enter a parameter which will be passed over to the procedure at 
  158. startup. It is the same as you can specify a filename when starting an editor. 
  159.  
  160.  
  161. ΓòÉΓòÉΓòÉ 3.2. List filed filename. ΓòÉΓòÉΓòÉ
  162.  
  163. This field shows the filename of the file you have opend. If the file has no 
  164. name at the moment you will see *.*. 
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ 3.3. Hot keys ΓòÉΓòÉΓòÉ
  168.  
  169. Some of the menue items can be accessed with a hot key. Please see list for all 
  170. the hot keys. 
  171.  
  172. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  173. ΓöéNew file              ΓöéCTRL + n Γöé
  174. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  175. ΓöéOpen file             ΓöéCTRL + o Γöé
  176. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  177. ΓöéSave file             ΓöéCTRL + s Γöé
  178. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  179. ΓöéImport file           ΓöéCTRL + i Γöé
  180. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  181. ΓöéPrint file            ΓöéCTRL + p Γöé
  182. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  183. ΓöéShow code window      ΓöéCTRL + r Γöé
  184. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  185. ΓöéPrint to LPT1         ΓöéCTRL + 1 Γöé
  186. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  187. ΓöéPrint to LPT2         ΓöéCTRL + 2 Γöé
  188. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  189. ΓöéHelp for REXX         ΓöéALT + F1 Γöé
  190. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  191. ΓöéHelp for Debug        ΓöéALT + F2 Γöé
  192. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  193. ΓöéGeneral help          ΓöéF1       Γöé
  194. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 4. File menue ΓòÉΓòÉΓòÉ
  198.  
  199. Here you will find all the items you need to open a file, or to save it. Even 
  200. to print a file and do exit RexxEdit. 
  201.  
  202.  
  203. ΓòÉΓòÉΓòÉ 4.1. New ΓòÉΓòÉΓòÉ
  204.  
  205. This function will clear the edit field of RexxEdit, so that you can work on a 
  206. new file. 
  207.  
  208. If your data has not been saved at this moment you will see a window asking you 
  209. if the data should be saved now or not. 
  210.  
  211.  
  212. ΓòÉΓòÉΓòÉ 4.2. Open ΓòÉΓòÉΓòÉ
  213.  
  214. If you select this item you will get a file open dialog with which you can 
  215. select a file to be loaded into RexxEdit. 
  216.  
  217. If your data has not been saved at this moment you will see a window asking you 
  218. if the data should be saved now or not. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 4.3. Save ΓòÉΓòÉΓòÉ
  222.  
  223. This item will save your work to disk. 
  224.  
  225.  
  226. ΓòÉΓòÉΓòÉ 4.4. Save as ΓòÉΓòÉΓòÉ
  227.  
  228. With this item you can save your work to a file with a new name. 
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ 4.5. Import ΓòÉΓòÉΓòÉ
  232.  
  233. With this function you can import the data of a file into you current file. You 
  234. will see a file open dialog for the selection of the file and the data will be 
  235. inserted at the current coursor position. 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 4.6. Print ΓòÉΓòÉΓòÉ
  239.  
  240. This item will print your data at the port shown nearby. 
  241.  
  242.  
  243. ΓòÉΓòÉΓòÉ 4.7. Exit ΓòÉΓòÉΓòÉ
  244.  
  245. With this Item you will exit from RexxEdit and all windows of the program will 
  246. be closed. 
  247.  
  248. If your data has not been saved at this moment you will see a window asking you 
  249. if the data should be saved now or not. 
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ 5. Clipboard ΓòÉΓòÉΓòÉ
  253.  
  254. This menue contains item for the clipboard of OS/2 . 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 5.1. Insert from clipboard ΓòÉΓòÉΓòÉ
  258.  
  259. Select this item if you want to insert data form the clipboard at the curren 
  260. coursor position. 
  261.  
  262.  
  263. ΓòÉΓòÉΓòÉ 5.2. Clear clipboard ΓòÉΓòÉΓòÉ
  264.  
  265. This item will clear the clipboard of OS/2. 
  266.  
  267.  
  268. ΓòÉΓòÉΓòÉ 6. Rexx ΓòÉΓòÉΓòÉ
  269.  
  270. With this menu you can open the Code window. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 6.1. Code window ΓòÉΓòÉΓòÉ
  274.  
  275.  The code window holds the REXX commands of REXX and VREXX/2. Like the drive 
  276. object all the parts are shown as a tree. There are major headlines and the 
  277. names of the procedures and commands. To insert the command into your file 
  278. perform the following steps. 
  279.  
  280.    1. Place the mouse coursor over the item you need. 
  281.  
  282.    2. Press the right mouse button and hold it down. 
  283.  
  284.    3. Drag the mouse coursor to the filed called Drop Zone and release the 
  285.       mouse button. 
  286.  
  287.    4. The code has been inserted in your file. 
  288.  
  289.  If you want to insert an other code, press SRTG and r or press the right mouse 
  290.  button if the coursor is outside of the edit filed. 
  291.  
  292.  You can also place the code into the clipboard of OS/2. To do this you must 
  293.  double click on an item or you can use the menue item. This enables you to 
  294.  tranfer data to other applicatons. 
  295.  
  296.  One of the key features for the code window is it's extensibility.  It allows 
  297.  you to easily create your own code templates within the code window. The file 
  298.  name for the add on templates is CODE.DAT and is located within your RexxEdit 
  299.  directory. This will give you easy access to the file for updating any entries 
  300.  that you have added. 
  301.  
  302.  In order to create your add on code templates, there are three key characters 
  303.  that tell the program how to read in your code.  These characters are: @, %, 
  304.  $. 
  305.  
  306.  The @ character, is the title of your add on section; the % character, is the 
  307.  title of the actual api or code block; and the $, indicates the start of the 
  308.  code section, that will be created when you create a link to the clip board, 
  309.  or drag and drop your code in your edit filed of RexxEdit. 
  310.  
  311.  Here is a sample for adding a REXX construct section in the RexxEdit code 
  312.  window. 
  313.  
  314.   @C Constructs
  315.   %if-then-else
  316.   $if value = 0 then do
  317.     statements
  318.   end
  319.   else do
  320.     statements
  321.   end
  322.   %Iterative loop
  323.   $do index = 1 to 100 by 1
  324.     statements
  325.   end
  326.   %Do while
  327.   $do while value > 0
  328.     statements
  329.   end
  330.   %Do until
  331.   $do until value > 0
  332.     statements
  333.   end
  334.   %select when
  335.   $select
  336.   when value > 0 then
  337.     statement
  338.   when value = 0 then
  339.     statement
  340.   otherwise
  341.   value=1
  342.   end
  343.   %while
  344.   $while(count <= 20)
  345.     statements
  346.  
  347.  *Note:  You can create multiple add on categories with the @ character. The 
  348.  structure of this file is the same as it is use by VisPro REXX. 
  349.  
  350.  
  351. ΓòÉΓòÉΓòÉ 7. Run ΓòÉΓòÉΓòÉ
  352.  
  353. Here you find all you need for testing and running you program. 
  354.  
  355.  
  356. ΓòÉΓòÉΓòÉ 7.1. Debug ΓòÉΓòÉΓòÉ
  357.  
  358. This item will start the interactive debug program. 
  359.  
  360. This program is not a part of my work. It was developed by a emlpoyee of IBM 
  361. and it is a gift to you. Please read the informations about RXD before using 
  362. it. You can find all you need in the DEBUG subdirectory ! 
  363.  
  364. Debug informations 
  365.  
  366.  
  367. ΓòÉΓòÉΓòÉ 7.2. Test ΓòÉΓòÉΓòÉ
  368.  
  369. This item will start your program in a new and independent window. The code 
  370. will be stored in the file Testrun.cmd 
  371.  
  372. If there should be an error you will see the Standard IO window which will hold 
  373. the information about the error or the problem. Do not close this window. It 
  374. will be closed automatically at the end of RexxEdit. 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 7.3. Compile ΓòÉΓòÉΓòÉ
  378.  
  379. With this item you can convert your CMD file to an EXE file. 
  380.  
  381. Please note that there is no compiler included with RexxEdit. This item should 
  382. only help you to understand what to to if you want to compile your file. The 
  383. CMD file which will be executed will only show the filename and is for 
  384. demonstration only. 
  385.  
  386. The way your compiler ist startet will be set in the file COMPILER.RUN, which 
  387. must be located in the RexxEdit directroy. This file holds only one line of 
  388. text. Please see the list below. 
  389.  
  390.    1. The name and the path of your compiler. 
  391.  
  392.    2. All paramters you need to start and to control your compiler. The sequenz 
  393.       #~# will represent the source file and it will be replaced by RexxEdit 
  394.       with TESTRUN.CMD. 
  395.  
  396.  If you use a CMD file as a compiler or your compiler is startet with the use 
  397.  of a CMD file you must add the following string at the end of the line 
  398.  
  399.  <CON >CON 2>CON 
  400.  
  401.  Here is an example which should create a TEST.EXE out of TESTRUN.CMD. 
  402.  
  403.   c:\compier\compile.cmd #~# c:\test.exe <CON >CON 2>CON
  404.  
  405.  Please do not use a retrun at the end of the line. 
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 8. Printer ΓòÉΓòÉΓòÉ
  409.  
  410. Here you can change the printer device. 
  411.  
  412.  
  413. ΓòÉΓòÉΓòÉ 8.1. LPT1 ΓòÉΓòÉΓòÉ
  414.  
  415. This will use LPT1 for printing. 
  416.  
  417.  
  418. ΓòÉΓòÉΓòÉ 8.2. LPT2 ΓòÉΓòÉΓòÉ
  419.  
  420. This will use LPT2 for printing. 
  421.  
  422.  
  423. ΓòÉΓòÉΓòÉ 9. Search ΓòÉΓòÉΓòÉ
  424.  
  425. This item will open a new window which enabels you to seach a string and repace 
  426. it with an other string. 
  427.  
  428. There are fileds for the search string and the repalce string. 
  429.  
  430. With the butons you can start the search and you can leave the window. 
  431.  
  432.  
  433. ΓòÉΓòÉΓòÉ 10. Info ΓòÉΓòÉΓòÉ
  434.  
  435. This item will help you to get help for REXX, DEBUG and RexxEdit. 
  436.  
  437.  
  438. ΓòÉΓòÉΓòÉ 10.1. Rexxutil ΓòÉΓòÉΓòÉ
  439.  
  440. This item will open the Rexx help which comes with OS/2. 
  441.  
  442. Rexx informations 
  443.  
  444.  
  445. ΓòÉΓòÉΓòÉ 10.2. Debuger ΓòÉΓòÉΓòÉ
  446.  
  447. This item will open the informations for RXD the debug software. 
  448.  
  449. Debug informations 
  450.  
  451.  
  452. ΓòÉΓòÉΓòÉ 10.3. Product information ΓòÉΓòÉΓòÉ
  453.  
  454. RexxEdit is the Rexx development system 
  455. created by Peter Freitag. 
  456.  
  457. (c) Copyright 1994-95 by Peter Freitag 
  458. All rights reserved. 
  459.  
  460. Peter Freitag 
  461. Koenigsdorfer Strasse 6 
  462. 82547 Beuerberg 
  463. GERMANY 
  464.  
  465. Phone: +49 8179 1039 
  466. Fax: +49 8179 9154 
  467. CIS: 100111,2111 
  468. Internet: 100111.2111@Compuserve.com 
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ 11. License information ΓòÉΓòÉΓòÉ
  472.  
  473. RexxEdit is not public domain software, nor is it free software. 
  474.  
  475. RexxEdit is copyright (C) 1994-95 by Peter Freitag. 
  476.  
  477. Non-registered users are granted a limited license to use RexxEdit on a trial 
  478. basis for the purpose of determining whether RexxEdit is suitable for their 
  479. needs. Use of RexxEdit, except for this limited purpose, requires registration. 
  480. Use of non-registered copies of RexxEdit by any person, business, corporation, 
  481. governmental agency or other entity institution is strictly forbidden. 
  482.  
  483. Registration grants a user the right to use RexxEdit only on a single computer; 
  484. a registered user may use the program on a different computer, but may not use 
  485. the program on more than one computer at the same time. 
  486.  
  487. No one may modify RexxEdit in any way, including but not limited to 
  488. decompiling, disassembling or otherwise reverse engineering the program. 
  489.  
  490. All users are granted a limited license to copy RexxEdit only for the trial use 
  491. of others subject to the above limitations, and also the following: 
  492.  
  493.      RexxEdit must be copied in unmodified form, complete with the file 
  494.       containing license and ordering information. 
  495.  
  496.      The full RexxEdit documentation must be included with the copy. 
  497.  
  498.      No fee, charge or other compensation may be accepted or requested by any 
  499.       licensee. 
  500.  
  501.      RexxEdit may not be distributed in conjunction with any other product. 
  502.  
  503.      Operators of electronic bulletin board systems (Sysops) may post RexxEdit 
  504.       for downloading by their users only as long as the above conditions are 
  505.       met. 
  506.  
  507.      Distributors of public domain or user supported software may distribute 
  508.       copies of RexxEdit subject to the above conditions. 
  509.  
  510.      If this softare is distributed on CD ROM one CD must be sent to me ! 
  511.