home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ARexxTools / rndfile210.readme < prev    next >
Encoding:
Text File  |  1996-09-27  |  4.4 KB  |  113 lines
  1. Short: run a command with a randomly chosen file
  2. Type: util/rexx
  3. Uploader: ac368@leo.nmc.edu
  4. Author: ac368@leo.nmc.edu (Bill Bereza)
  5.  
  6.  
  7. rndfile.readme
  8. $VER: rndfile.readme 1.31 (4.5.94)
  9.  
  10. By Bill Bereza  bereza@beech.csis.gvsu.edu  ac368@leo.nmc.edu
  11.  
  12.     no longer contains any code from RXBlank by Brian C. Berg,
  13.     but thanks for the idea!
  14.  
  15.  
  16. Installation:
  17.         You'll need rexxarplib.library in libs: (It's available in many places)
  18.         Then copy libs/RexxDosSupport.library to libs:
  19.             (I included this because it isn't available everywhere)
  20.  
  21.         Then copy rndfile where ever you put you ARexx scripts.
  22.  
  23. Usage: rndfile Paths/M,Pattern/K,Command/K,CmdOptions/K,ALL/S,DIRS/S,FILES/S
  24.  
  25.        You do *not* need to put a '/' at the end of the Path.
  26.  
  27.     Paths/M     :   Specify any number of paths for rndfile to search through.
  28.                     e.g. Work:Docs/
  29.                     Default is the current directory.
  30.  
  31.     Pattern/K   :   An Arp pattern for rndfile to apply to the
  32.                     list of files/dirs.
  33.                     e.g. s#?.txt
  34.                     Default is '~(#?.info)' No info files.
  35.  
  36.     Command/K   :   A program that rndfile will run on the chose file.
  37.                     e.g. PPShow
  38.                     Default is the enviroment variable DefRndCmd or 'c:list'
  39.                     You can set your own default command with:
  40.                         setenv DefRndCmd <command>
  41.  
  42.     CmdOptions/K:   Options to pass to the Command program.
  43.                     e.g. SCREEN
  44.                     Defaults to null string. (Nothing)
  45.  
  46.     ALL/S       :   Allow directories OR files to be chosen.
  47.                     This is the default option.
  48.  
  49.     DIRS/S      :   Allow only directories to be chosen.
  50.  
  51.     FILES/S     :   Allow only files to be chosen.
  52.  
  53. Examples:
  54.     RX rndfile
  55.         uses default command 'c:list' on a file in the current directory
  56.  
  57.     RX rndfile Sounds:Samples/ Pictures:Things Command=delete All
  58.         uses delete command on a random File OR Directory in those dir
  59.  
  60.     RX rndfile Sounds:Samples/ Command=Multiview CmdOptions="SCREEN BACKDROP"
  61.         uses Multiview program with SCREEN and BACKDROP options
  62.         in Sound:Samples/
  63.  
  64. Disclaimer: Don't blame me if you randomly screw something up.
  65.             By executing this script you take your life and your
  66.             files into your own hands.
  67.  
  68. ObLegal:    This script is freeware. Do what you like with it.
  69.             If you use part of this, at least give me some
  70.             credit|blame.
  71.  
  72. History:    2.10    Just a few small additions.
  73.                 +   You can now have multiple paths. (See Examples)
  74.                 +   Now will read the default command from the env-variable
  75.                     DefRndCmd.
  76.             2.00    Hooboy! Completely re-wrote the program. It's like a
  77.                     completely new program.
  78.                 +   Replaced ugly argument parsing structure with
  79.                     ReadArgs() from RexxDosSupport.library.
  80.                 +   Now I use a real template.
  81.                 +   Replaced '.info' removing routines with FileList()
  82.                     from rexxarplib.library.
  83.                 -   Now also checks for ':' instead of just '/'
  84.                     No more 'Can't find Path SYS:/'
  85.  
  86.             1.10    Fixed instructions/comments
  87.  
  88.             1.00    I wrote this for the Amiga users on alt.tv.animaniacs
  89.                     so they could play a collection of 'Wheel of Morality'
  90.                     samples. Unfortunately, I wrote this before looking at
  91.                     the sample collection. This program is useless for that.
  92.                     But it did make a useful utility.
  93.  
  94. ToDo:       Some optimization should be done in the big 'do' loop.
  95.             What more do you want? :) Send e-mail if you have a
  96.             suggestion.
  97.  
  98.             Maybe get an ARexx compiler and compile it?
  99.  
  100.             I would like to use a better implementation of ReadArgs().
  101.             I have one, but it would require a few changes.
  102.  
  103.  
  104. ============================= Archive contents =============================
  105.  
  106. Original  Packed Ratio    Date     Time    Name
  107. -------- ------- ----- --------- --------  -------------
  108.     2912    1155 60.3% 04-May-94 08:40:16  rndfile
  109.     7563    3142 58.4% 04-May-94 08:50:38  rndfile.guide
  110.     3879    1624 58.1% 04-May-94 08:46:46  rndfile.readme
  111. -------- ------- ----- --------- --------
  112.    14354    5921 58.7% 16-Jun-94 08:55:32   3 files
  113.