home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 164.lha / ARexx / WB_ARexx_v1.1 / readme < prev    next >
Text File  |  1988-04-28  |  4KB  |  85 lines
  1.                               WBRexx 1.1
  2.                               ==========
  3.  
  4.                      Copyright 1988, W.G.J. Langeveld
  5.                            All Rights Reserved
  6.                           Freely  Distributable
  7.  
  8.  
  9.     WBRexx is a program that allows you to run your REXX scripts from the
  10. workbench. This file contains the executable, the sources and some example
  11. icons and scripts. The file marquis.rexx is courtesy Bill Hawes.
  12.  
  13. Changes for this version
  14. ------------------------
  15.     Version 1.1 supports the WINDOW tool type, and it now correctly remembers
  16. the drawer from which a Rexx macro was started up. A previously released version
  17. required one more level of quotes been eliminated in the RX ToolType strings, see
  18. later. This version is distributed as a ZOO archive, the previous one was in 
  19. ARC format.
  20.  
  21. Instructions
  22. ------------
  23.     First copy the program WBRexx to a place of your choosing. This archive
  24. assumes you will copy it to a directory with the logical name tools: . Of course
  25. you may copy it anyplace you like, but then you must change the  default tool in
  26. all icons (they have been set to tools:WBRexx).
  27.     You run an ARexx script from the Workbench simply by giving it an icon
  28. such as the ones in this archive (like marquis.rexx.info). After making sure the
  29. default tool points to the right place (using the "Info" option of the Workbench
  30. menu), you double-click on the icon and the script is submitted to REXX.
  31.     You can also click on the icon, hold down the shift key on the keyboard
  32. and double-click on the WBRexx tool icon. In fact you can execute several 
  33. scripts in a row by extended-selecting them all and double-clicking on WBRexx.
  34.     You can also use a shortcut: If you have a script which is really small
  35. you may want to put it in as a string command. To do this, use "Info" from the
  36. Workbench menu to edit the icon, and add the tool type:
  37.  
  38.     RX=your-favorite-in-line-rexx-macro-goes-here
  39.  
  40. For example, to run TxEd, the tooltype would be:
  41.  
  42.     RX=address command 'c:e'
  43.  
  44.     In order for this to work, the icon file must NOT have an associated
  45. regular file, i.e. if your icon is runtxed.rexx.info, there must NOT be a file
  46. called runtxed.rexx. Only if the .info file is all by itself, will WBRexx check
  47. for tooltype RX. In all other cases it will assume that you really want to submit
  48. the associated file to REXX. Also, WBRexx checks only for ONE RX tooltype, and
  49. it only uses the first one it can find. (Notice, that in a previous version, the
  50. entire string had to be enclosed in quotes. This is no longer necessary, and in
  51. fact will not work anymore - this is because I fixed what was in fact a bug).
  52.     There is a catch 22 situation here. Under 1.2, it is not possible to
  53. edit an icon using "Info" if the icon does not belong to a file. The Info
  54. program will briefly flash up, and exit again. This has been changed in 1.3:
  55. there you can edit icons that stand by themselves. For now, to use this feature
  56. under 1.2 you should have a dummy file associated with your icon before you edit
  57. it. Then you can edit the icon, and then you must delete the dummy file.
  58.     Some  scripts need to display text. This wasn't possible in the previous
  59. versions of WBRexx, since the Workbench does not handle standard input or output
  60. and things like ARexx "say" used to go to the bitbucket. In the previous
  61. versions, if you wanted this type of thing, you had to open console windows
  62. yourself, like in marquis.rexx. Steve Berry has added to WBRexx the capability
  63. of opening a console window automatically, if the WINDOW tool type is specified
  64. (thanks, Steve!).
  65.     For example, if one of the tooltypes in the project icon is
  66.  
  67.     WINDOW=CON:0/0/320/100/"WBRexx console"/
  68.  
  69. a small window will be opened and any messages will be displayed there.
  70.     Finally, you will sometimes wonder why nothing is happening. It may be
  71. helpfull to see what actually was done by WBRexx. Therefore, WBRexx itself has
  72. a tooltype it checks. This is the tooltype DEBUG. It can be either ON or OFF.
  73. For example, if you want debugging, the WBRexx icon should contain the tooltype:
  74.  
  75.     DEBUG=ON
  76.  
  77. This causes WBRexx to display in three steps how it arrives at the string it
  78. will send to REXX. This option only works by using extended select (because only
  79. then will the WBRexx icon be used).
  80.     If there are any questions, I'm sure I'll hear about them on BIX in 
  81. amiga.user/arexx.
  82.  
  83.     Willy.
  84.  
  85.