home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / RAFL-V10.ZIP / RAFL.DOC < prev   
Text File  |  1992-10-03  |  4KB  |  87 lines
  1.  ┌──────────────────────────────────────────────────────────────────────────┐
  2.  │    RAFL.CMD -- REXX Archive File Lister 1.0       by Russel Havens       │
  3.  │                                                      on 10-02-92         │
  4.  │                                                 (rather late at night!)  │
  5.  │              Written in OS/2 REXX using Visual REXX                      │
  6.  │                                                                          │
  7.  └──────────────────────────────────────────────────────────────────────────┘
  8.  
  9. -----What RAFL does-----
  10.  
  11.     RAFL is a REXX script which will allow you to pick archive files
  12. from a file list box and then see what files are in them.  It determines
  13. archive type by signature and supports .ZIP, .ARJ and .LZH files.  It is
  14. simple to use.  Just run it and you'll see that it's obvious.  **MAKE
  15. SURE TO READ THE SYSTEM REQUIREMENTS BELOW!  RAFL REQUIRES VREXX, UNARJ,
  16. UNZIP, LH and EPM TO RUN!**
  17.  
  18.  
  19. -----First Things First-----
  20.  
  21.     First of all, RAFL is committed to the public domain.  Free for use by
  22. any who want to use it.  Free for modification by anybody who wants to
  23. modify it.  Free for mangling by anyone who wants to mangle it.
  24.  
  25.     Second of all, I wrote this to learn about Visual REXX in particular
  26. and REXX scripts in general.  It is not warranteed to do anything but take
  27. up disk space.  And in no way will the author (that's me, Russel Havens) be
  28. liable for any damages, real, consequential, unreal, inconsequential, etc.,
  29. etc., etc., from using this script.  In other words, its on your system, so
  30. what happens there is your doing!
  31.  
  32.     Now third of all, to be honest, the only "bad" things that even
  33. *could* happen are that 1) RAFL creates a file in the current directory
  34. with the unlikely name of AFL%%TMP.$$$, so it will overwrite any file
  35. with the same name in the current directory. 2) if RAFL doesn't find
  36. VREXX.EXE in the PATH or VREXX.DLL and DEVBASE.DLL in the DPATH, it will
  37. probably freak and you will probably have to close the window.
  38.  
  39.  
  40. -----System Requirements-----
  41.  
  42.     VREXX requires OS/2 2.0 or later, so RAFL does too.  It should do
  43. fine with the minimum OS/2 2.0 requirements for RAM, disk space, etc.
  44.  
  45.     RAFL requires Visual REXX to be installed.  That means that
  46. VREXX.EXE needs to be in the PATH and VREXX.DLL & DEVBASE.DLL need to be
  47. in the DLL Path (DPATH).
  48.  
  49.     RAFL does not do its own archive work, so it requires UNZIP.EXE,
  50. UNARJ.EXE and LH.EXE in the PATH.
  51.     UNZIP.EXE was originally written by Samuel H. Smith, but in its
  52. current rev. (version 5.0, out in Aug. '92) has more authors than you can
  53. shake a stick at.
  54.     UNARJ.EXE is a 32-bit port of Robert K. Jung's UNARJ done by Robert
  55. Grey.  It was originally called GNUNARJ, but I renamed mine to be more
  56. like my DOS UNARJ and to shorten the name down a bit, since it is a
  57. command line program and every keystroke saved speeds things up for me.
  58.     LH.EXE is an .LZH compatible archiver copyrighted by A:Ware Inc.
  59. The latest version I have is 2.14, dated 9/19/89.  Still, it works quite
  60. nicely as an archiver.
  61.     These programs are all free for personal use and are available in
  62. their separate archives.
  63.     RAFL also uses EPM.EXE, which is the advanced editor included with
  64. the OS/2 2.0 package.  Needless to say, it needs to be in the path as
  65. well.
  66.  
  67. -----In Closing-----
  68.     Thank you, IBM for supplying us with OS/2 and REXX!  Thank you, IBM and
  69. Richard B. LAM for supplying us with VREXX!
  70.     I hope this is of use.  Perhaps in the future, I will make RAFL
  71. capable of full archive shell capabilites like SHEZ or ARCMASTER.  Who
  72. knows?  If anybody cares to let me know how wonderful this is,  or
  73. whether to continue work on it or even <gasp> that they don't like RAFL,
  74. drop me a line at:
  75.  
  76.                 Russel Havens
  77.                 73 Roosevelt Ave.
  78.                 American Fork, UT 84003
  79.  
  80.  
  81.     In the mean time, ENJOY!
  82.  
  83. RH
  84. -----Copyrights-----
  85.     Visual REXX, REXX and OS/2 are copyrighted by IBM.  RAFL is not
  86. copyrighted by anybody that I know of. ;-)
  87.