home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 431.lha / Randpic_v1.0 / Randpic.doc < prev    next >
Text File  |  1990-11-05  |  3KB  |  81 lines
  1.                  ******************************
  2.                  *                            *
  3.                  *        Randpic v1.0        *
  4.                  *                            *
  5.                  *    Author: J. L. Holmes    *
  6.                  *                            *
  7.                  ******************************
  8.  
  9.  
  10.    Thankyou for trying Randpic v1.0.  This command picks randomly 
  11. from a number of items in a text file and then outputs its choice 
  12. to another file that you specify.  One suggestion for using Randpic
  13. is to place it in your startup-sequence to customize boot up.  It 
  14. could, perhaps, choose from multiple `say' commands to make startup
  15. friendlier, but use your imagination.
  16.  
  17.    The command is used in the following format:
  18.  
  19.  
  20.       Randpic <in_filename> <##> <out_filename>
  21.  
  22.  
  23.    Where
  24.  
  25.    <in_filename> is the path name to a text file with commands
  26. written just like you would type them from CLI (similar to your
  27. s/startup-sequence).  There are only two things to consider when
  28. making this file...  One, no single command can be more than 80
  29. characters long, and two, the EOF marker must reside on its own
  30. line (i.e There must be one more blank line after the last item
  31. in your list).
  32.  
  33.    <##> is a positive integer.  This is the maximum number of
  34. commands Randpic is to choose from.  If you give this argument a
  35. value greater than the total number of commands in your
  36. <in_filename> it will still be possible for Randpic to pick a
  37. value in that range, but if Randpic chooses a value higher than
  38. the total number of commands, it will simply choose the last
  39. command.
  40.  
  41.    <out_filename> is the path name to the text file Randpic's
  42. choice will be written to.  You should be very careful in this,
  43. because if a file already exists with the same path name it will
  44. be replaced by the new file Randpic creates.  Once <out_filename>
  45. has been created, you can execute it like any other text file.
  46.  
  47.  
  48.    NOTES:
  49.  
  50.    Don't worry if your command is more than 80 characters...
  51. nothing will crash, but you'll just get the first 80 characters
  52. of the command, which in itself may cause a problem.
  53.  
  54.    Future versions of Randpic will be able to execute the
  55. commands by itself without needing an <out_file>.
  56.  
  57.    The program is released into the Public Domain, so use it as
  58. you wish.  ALL I ASK IS THAT THIS DOCUMENT FILE BE INCLUDED WITH
  59. ANY COPIES TO ANOTHER PARTY.
  60.  
  61.     You can rename Randpic to anything you want.
  62.  
  63.    This program does not eat any memory.
  64.  
  65.    As far as I know there are no bugs, but if you find any, please 
  66. report them by leaving me mail at:
  67.  
  68.  
  69.         BIX
  70.         Nickname: j.l.
  71.  
  72.             -or-
  73.  
  74.         Amiga Lore BBS
  75.         Tallahassee, Florida
  76.         (904) 561-6708
  77.         c/o Jerry Holmes
  78.  
  79.     Or call me at (904) 222-6177.
  80.  
  81.     Thanx and enjoy.