home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / randomz4.zip / readme.txt < prev   
Text File  |  2001-07-29  |  4KB  |  92 lines
  1.      ┌┬────────────────┬┐
  2.      ││ Randomizer 4.0 ││
  3.      └┴────────────────┴┘
  4.  
  5. ┌┬─────────────┬┐
  6. ││ WHAT IS IT? ││
  7. └┴─────────────┴┘
  8. Randomizer is a lightweight database built with the specific intention of
  9. selecting random items from lists (fields, arrays, etc).  The Randomizer.cmd
  10. script is accompanied by DataInput.cmd which acts as the database creation
  11. and editing tool.  Other front-ends could be easily coupled with DataInput.cmd
  12. but thus far no others are known to exist.
  13.  
  14. This could be useful for many things such as developing quick characters for
  15. a story or role playing game, the basis of a lottery number picker, or
  16. theoretically scientific work involving random data.
  17.  
  18. ┌┬──────────────┬┐
  19. ││ INSTALLATION ││
  20. └┴──────────────┴┘
  21. Installation of Randomizer is as simple as unzipping randomizer4.zip to any
  22. directory which appears in your PATH= statement in CONFIG.SYS.  Of course you
  23. can unzip it to any directoy at all and then add that directory to the PATH=
  24. statement.  Randomizer will look for a data file (by default randomdata.txt)
  25. in whichever directory you are in at the time you invoke either randomizer.cmd
  26. or datainput.cmd.  Therefore it is possible to keep multiple data files in
  27. multiple directories and work with them simply by issuing a CD (change directory)
  28. command and then typing "randomizer" or "datainput" (without the quotes).
  29.  
  30. ┌┬────────────┬┐
  31. ││ WHAT'S NEW ││
  32. └┴────────────┴┘
  33. Randomizer 4.0 is powered by Pun Technology.  "Pun is a play on words()."
  34. To make a long story short, Pun Technology is a replacement for OS/2's Rexx
  35. words(), word(), and delword() functions which allows Randomizer v4 to use
  36. non-space characters as field delimiters in the data file.  This allows more
  37. effective handling of fields which contain spaces without the need for special
  38. place holder characters as in previous versions of Randomizer.
  39.  
  40. The format of Randomizer 4.0's data file (RandomData.txt) is different from
  41. earlier versions of Randomizer.  I have now chosen to standardize on the
  42. traditionally accepted tab-delimited text format, thereby allowing items within
  43. each field to contain ordinay spaces within their names.
  44.  
  45. WARNING: Editing RandomData.txt with any text editor which does not respect the
  46. tab character (ASCII 009) will cause Randomizer and DataInput programs to fail.
  47. TEDIT.EXE which comes with OS/2 is an example of such a bad editor.  I recommend
  48. using E.EXE, EE.EXE, or FTE as your text editor, though others may work as well.
  49.  
  50. ┌┬──────────────┬┐
  51. ││ FUTURE PLANS ││
  52. └┴──────────────┴┘
  53. * Development of a PM (graphical) version of DataInput.cmd.
  54. * Ability to specify low and high values for random # of multiple selections.
  55. * Ability to make specified multiple item selections be mutually exclusive.
  56.  
  57. ┌┬─────────┬┐
  58. ││ SUPPORT ││
  59. └┴─────────┴┘
  60. Making changes to the source code of Randomizer.cmd and DataInput.cmd can be
  61. neither condoned nor prevented by the author.  Therefore there is absolutely no
  62. guarantee or warranty of any kind on this software.  If you edit the code and then
  63. experience problems, I am in no way responsible for any loss or damage.  However,
  64. if you experience problems with Randomizer as-released by myself, then please
  65. contact me as I would like to make the program useful to as many OS/2 users as
  66. possible.
  67.  
  68. If you report a bug, please tell me the version of OS/2 as well as any pertinent
  69. steps to recreate any errors you get when running Randomizer.
  70.  
  71. Under no circumstances should this software be used in a mission critical
  72. environment as it is guaranteed to be neither bug free nor 99.9% reliable.
  73.  
  74. ┌┬─────────────────────┬┐
  75. ││ COPYRIGHT & LICENSE ││
  76. └┴─────────────────────┴┘
  77. Randomizer is copyright 2001 by Don Eitner
  78.  
  79. Randomizer is donation-ware.  If you find it useful and appreciate the work the
  80. author has done, you are asked but not obligated to send the author a small
  81. donation of US$5 to help encourage continued development and more advanced
  82. features.  Donations may be made via PayPal (http://www.paypal.com) to the
  83. e-mail address shown below.
  84.  
  85. ┌┬─────────┬┐
  86. ││ CONTACT ││
  87. └┴─────────┴┘
  88. As of July 2001, the author can be contacted at:
  89.  
  90. Don Eitner (freiheit@syntheticdimension.net)
  91.  
  92.