home *** CD-ROM | disk | FTP | other *** search
/ Windoware / WINDOWARE_1_6.iso / winutil / rndst10 / rndstart.doc < prev    next >
Text File  |  1992-04-19  |  4KB  |  115 lines
  1. WARNING: READ THE DOCUMENTATION BEFORE RUNNING THE PROGRAM!
  2.  
  3. RNDSTART - a random configuration program for Windows 3.1 by
  4. Benjamin L. Combee
  5.  
  6. **** BRIEF SYNOPSIS ****
  7.  
  8. RNDSTART is a program which is run outside of Windows 3.1. Using a
  9. configuration file you set up, it randomly picks a wallpaper for the
  10. background, and start and exit sounds.
  11.  
  12. **** RNDSTART LICENSE ****
  13.  
  14. The program file RNDSTART.EXE is copyrighted by Benjamin L. Combee ("the
  15. author").  The program is FREEWARE.  You are licensed to:  o  Use RNDSTART
  16. in its unaltered form o  Make as many copies of RNDSTART as you wish o
  17. Give such copies to anyone o  distribute the software via electronic means
  18. You are specifically prohibited from charging, or requesting donations,
  19. for any such copies, however made; exceptions are for BBS's and commercial
  20. on-line systems that charge a membership or time charge.  As long as no
  21. specific charges are made for this program, this is allowed. Distributing
  22. the software with commercial or shareware products is not allowed without
  23. prior permission in writing from the author. There is no warranty of any
  24. kind, and the author is not liable for damages of any kind.
  25.  
  26. RNDSTART is Copyright (C) 1992 Benjamin L. Combee
  27. 3218 Maple Grove Drive, Dalton, GA  30721 or
  28. Georgia Tech P.O. Box 30501, Atlanta, GA  30332
  29.  
  30. Any donations, ideas, suggestions, bugs please write or send some e-mail
  31. to:
  32.  
  33.     gt0501c@prism.gatech.edu (USENET, Internet e-mail)
  34.  
  35. You may also use the Compuserve to Internet e-mail gateway. Inquire
  36. on-line at Compuserve for details.
  37.  
  38. **** MORE DETAILS ****
  39.  
  40. RNDSTART will look for its configuration file (RNDSTART.CFG) in two
  41. places. First, it will check the location where the RNDSTART.EXE file is.
  42. If it doesn't find it there, it will check the current directory.
  43.  
  44. The configuration file has a simple format.  There are four sections that
  45. can be placed in any order.  Blank lines in the file are ignored.
  46.  
  47. The first section, [WIN.INI], must start with the line:
  48.  
  49. [WIN.INI]
  50.  
  51. The next line after that gives the path to the directory where the WIN.INI
  52. file is.  On my system, it looks like:
  53.  
  54. c:\win31\
  55.  
  56. The trailing slash is necessary.
  57.  
  58. The second section, starts with the line
  59.  
  60. [Wallpaper]
  61.  
  62. Each line after that has two field, separated by a space.  The first is
  63. the pathname of a BMP file to be used as wallpaper. The second is either a
  64. 1 or a 0 -- 1 if you want the background tiled, and 0 if you want it
  65. centered.
  66.  
  67. The third section starts with the line
  68.  
  69. [Start]
  70.  
  71. It is followed by all the sounds you want to pick from on start up. Again,
  72. you must specify the full pathname of the sound file.
  73.  
  74. The fourth section starts with the line
  75.  
  76. [Exit]
  77.  
  78. It is just like the third section except that the sounds listed are to be
  79. played upon leaving the system.
  80.  
  81. **** IMPLEMENTATION ****
  82.  
  83. This is my first major program I wrote in Modula-2.  I used JPI's
  84. Modula-2, version 1.17, with one routine from PMI's Repertoire toolkit. If
  85. you find any bugs in it, please let me know.  It has worked reliably for
  86. several days on my Windows 3.1 setup, but yours may be slightly different.
  87. I would recommend backing up your WIN.INI file before running it the first
  88. time. Also, make sure you have a good configuration file, and do not
  89. specify the whole WIN.INI filename in the [WIN.INI] section, just specify
  90. the path to it.
  91.  
  92. **** SAMPLE FILE ****
  93.  
  94. I've included my RNDSTART.CFG file with this package.  You can look at it
  95. to see how to set yours up.  RNDSTART doesn't check to see that the files
  96. it puts in the WIN.INI file are there, so make sure that the configuration
  97. file has valid files.
  98.  
  99. **** PLEA ****
  100.  
  101. Don't want money... got a full scholarship to Georgia Tech!  I would like
  102. a postcard from anyone who uses this, just so I can see how its getting
  103. out. Also, please upload this all around. I'd like lots of people to use
  104. my program.  It's an ego thing... if my ego gets big enough, I'll release
  105. more of the stuff I do.
  106.  
  107. Seriously, I hope you find this useful.  Remember, it's not a bug, its an
  108. undocumented feature.
  109.  
  110. **** HISTORY ****
  111.  
  112. v. 1.0 -- 18 Apr 1992 -- First release.  Wallpaper, start sound, and end
  113.                          sound changing functionality.
  114.  
  115.