home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Editor / DVD!FX17.LHA / FrexxEd / bin / Ftool2.lha / FrexxTool.doc next >
Encoding:
Text File  |  1994-08-25  |  2.4 KB  |  89 lines
  1.             FrexxTool - An ARexx toolbox
  2.             ============================
  3.  
  4.                 By Linus Nielsen 1994
  5.  
  6.   This is a small utility that opens a window with buttons that execute
  7. ARexx commands when pressed. It reads a setup file with the button names
  8. and the commands they execute. It can open on any public screen and use
  9. any ARexx port.
  10.  
  11.  
  12. How to use it
  13. -------------
  14.  
  15. The CLI template is:
  16.  
  17. FrexxTool PORT/K,SETUP/K,SCREEN/K,COLUMNS/N/K,X/N/K,Y/N/K,HELP/S/K
  18.  
  19. The parameters:
  20.  
  21. PORT    -    The name of the ARexx port to use, default is FREXXED.1,
  22.         because this program is written mainly for FrexxEd usage.
  23.  
  24. SETUP    -    The name of the setup file, default is "FrexxTool.setup".
  25.  
  26. SCREEN    -    The name of the public screen to open on, default is
  27.         the current default public screen. If PORT is FrexxEd's
  28.         port, it will ask FrexxEd which screen to use, if SCREEN is
  29.         not specified.
  30.  
  31. COLUMNS    -    The number of columns to use when placing the gadgets,
  32.         default is 3.
  33.  
  34. X    -    The window X position, default is 0.
  35.  
  36. Y    -    The window Y position, default is 0.
  37.  
  38. HELP    -    Display a helpful(?) text.
  39.  
  40.  
  41.  
  42. The setup file
  43. --------------
  44.  
  45.   The setup file, by default called 'FrexxTool.setup' has a very simple
  46. format: '<label>:<command>' where the command ends at the newline character.
  47. The label should for cosmetic reasons be short and immediately followed by a
  48. colon, and then the message that will be sent to FrexxEd when that button
  49. is pressed. One line should *not* be longer than 256 bytes, and there is no
  50. use putting in more than 256 lines...
  51.  
  52. EXAMPLE FILE
  53. ------------
  54.  
  55.   Just in case the original gets changed, I'll insert an example file in this
  56. document. This is of course to be used with FrexxEd:
  57.  
  58. Open:Open("");
  59. Save:Save();
  60. Save As...:SaveAs();
  61. Search...:{ int ret; SearchSet("f+"); if ((ret=SearchSet())>=0) { if (Search()<0) DisplayBeep(); } else ReturnStatus(GetReturnMsg(ret)); }
  62. Search:Search();
  63. Srch/Repl:ReplaceSet();
  64. Mark:BlockMark();
  65. Copy:BlockCopy();
  66. Cut:BlockCut();
  67. Paste:BlockPaste();
  68. Bsave:BlockSave();
  69. FPL file:ExecuteFile();
  70. Globals:PromptInfo(0, "All globals", "(global)", "(read)(hidden)");
  71. Locals:PromptInfo(-1, joinstr("\"", ReadInfo("file_name"), "\" settings."), 0, 0, "!ds_*");
  72. Undo:Undo();
  73. Undo restart:UndoRestart();
  74. About:About();
  75.  
  76.  
  77. History
  78. -------
  79.  
  80. 0.2    First release to Daniel Stenberg
  81.     
  82.  
  83.  
  84.   Redirect complaints to >NIL:, mail me serious bug reports and suggestions
  85. of how to improve this.
  86.  
  87.   Linus Nielsen
  88.   Email: erenie@ere.ericsson.se
  89.