home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / mag&info / rotowel5.zip / ROTOWEL.DOC < prev    next >
Text File  |  1992-10-19  |  7KB  |  142 lines
  1.                     RotoWel 5.0 - Welcome screen rotator
  2.        Copyright (c) 1991 - 1992 by Michael Leavitt - all rights reserved
  3.  
  4. Purpose of this program:
  5.         If you have several different 'welcome' screens that you would like to
  6. display to your callers, RotoWel provides a quick and easy way to rotate them.
  7.  
  8. How to use RotoWel:
  9.         Create a subdirectory on your hard drive for RotoWel's use.  Copy all
  10. welcome screens you wish to use (no more than 400), and ROTOWEL.EXE into this
  11. subdirectory.
  12.         WARNING: Do not place any files other than welcome screen files and the
  13. RotoWel files into this subdiretory!
  14.  
  15.         To change screens, just run RotoWel like this:
  16.  
  17.                         ROTOWEL outfile /OPTION
  18.  
  19.         Where 'outfile' is the location that your BBS reads the welcome file
  20. from (example: C:\PCB\GEN\WELCOME)
  21.         And /OPTION is:
  22.                 /A to show the files in alphabetic order
  23.                 /O to show the files in DOS directory order
  24.                 /R to show them in random order
  25.  
  26. Sample Batch File:
  27.  
  28.         CD \ROTO  <-- assuming you've installed RotoWel here
  29.         ROTOWEL C:\PCB\GEN\WELCOME /A
  30.         CD \PCB   <-- back to where you came from
  31.  
  32.         You must change to the RotoWel subdirectory before running RotoWel, or
  33. errors may occur.
  34.  
  35.         You can run RotoWel in your nightly event to change the screens once
  36. a day, or in $$LOGOFF.BAT (PCBoard 14.5A and higher only) to change it for
  37. each caller.  WARNING: Using RotoWel in your $$LOGOFF.BAT file on a multi-node
  38. system may cause an error if RotoWel tries to update a screen while another
  39. node is viewing it.  Use of RotoWel in $$LOGOFF.BAT is not recommended on
  40. multi-node systems.
  41.  
  42. Dated Files:
  43.         You may wish to show certain display screens on certain dates;
  44. RotoWel provides a simple way to accomplish this.  Create a subdirectory
  45. called DATED under the directory where RotoWel is installed; this is where
  46. you will store the special dated files (example: \ROTO\DATED).
  47.         The dated files are identified by their filenames, which are given
  48. as MMDD.  For example, if you have a special Christmas file to show on that
  49. day, name it 1225 and place it in the DATED subdirectory.  On that day,
  50. RotoWel will use the special file from the DATED subdirectory, and go back
  51. to the normal rotation the next day.  Dated filenames always have 4
  52. characters; if you have a special scren for July 4th, call it 0704.
  53.         This function is optional; if there is no DATED subdirectory, or
  54. there is no file in that directory with today's 'datename', then RotoWel
  55. will simply rotate the files in its home directory according to the command
  56. line option.
  57.  
  58. ANSI / ASCII files:
  59.         RotoWel fully supports graphics / non-graphics display files.  For
  60. example, if you have a SCREEN and SCREENG file in the RotoWel directory and
  61. tell it to rotate \PCB\GEN\WELCOME, it will create both the WELCOME and
  62. WELCOMEG file for you.  This also works with dated files.
  63.         If there is no 'G' version of the file that is being rotated into
  64. place, RotoWel will only create the WELCOME file, and delete any left over
  65. WELCOMEG file from the day before.  This allows you to mix ANSI/ASCII and
  66. PCBoard @X code files at will.
  67.         NOTE: Every 'G' file must have a matching non-G file to be displayed.
  68. For example, if you have a SCREENG file but no SCREEN file, the SCREENG file
  69. will never be displayed.  Watch out for 'accidental' G files; if you have
  70. a screen called FLYING it will never be displayed (unless there's a FLYIN file
  71. present, too...)
  72.  
  73. Simple and Easy:
  74.         No configuration is required for this program.  It will automatically
  75. keep track of the files in its directory, and create its own ROTOWEL.DAT file
  76. to mark its place.  If you ever want to reset it so that it starts over with
  77. the first file, just delete ROTOWEL.DAT!  RotoWel will automatically recreate
  78. the file and start over at the first file next time it runs.
  79.         RotoWel will show you a help screen with instructions on how to use it
  80. if you run ROTOWEL /H.
  81.  
  82. Different Sorts for Different Folks:
  83.         In addition to the /R (random) display, RotoWel provides two options
  84. for displaying files in order; /A for alphabetic sorting, and /O for DOS order
  85. sorting.  'DOS order' means that the files will be used in the order they
  86. appear in the DOS directory - this is the same order you'd see the filenames
  87. in with a DIR command.  Alphabetic sorting is just that - the files will be
  88. used in alphabetic order (useful if you have a 'series' of screens you wish
  89. to display over several days).
  90.         Alphabetic sorting is a little slower; when rotating from a directory
  91. with a large number of files, this sort can cause RotoWel to take a few
  92. seconds longer.  If speed is your concern, use the /O option.
  93.  
  94. Not Just for Welcome Files:
  95.         RotoWel was designed to rotate multiple welcome files - but it works
  96. equally well to rotate other files as well.  You can use it to rotate news
  97. files, bulletins, logoff files - whatever you'd like.  One person uses RotoWel
  98. to rotate his Windows wallpaper!
  99.  
  100. Legal stuff:
  101.         RotoWel is copyright (c) 1991 - 1992 by Michael Leavitt, all rights
  102. reserved.  You are granted a limited non-exclusive personal license to use
  103. this program on your PCBoard system, and are encouraged to share this program
  104. with others.
  105.         License Conditions:  You must be licensed to use PCBoard to use this
  106. program.  You may not decompile, reverse engineer, or in any other way modify
  107. the program code or use it in part or whole for any other purpose than
  108. described in this document.  If you give a friend a copy of RotoWel, you may
  109. not charge any fee for this service.  Violation of any of these conditions will
  110. invalidate this license.
  111.  
  112. How much does it cost?
  113.         Nothing!  It's freeware!  Enjoy it, but honor the copyright...
  114.  
  115. Correspondence:
  116.         Send mail regarding RotoWel to:
  117.         Michael Leavitt
  118.         c/o The Graphics Connection
  119.         4120 South 500 West #5
  120.         Murray, Utah  84123
  121.  
  122.         Send E-mail regarding RotoWel to:
  123.         Michael Leavitt
  124.         c/o The Graphics Connection BBS
  125.         (801)-264-1191
  126.  
  127. Revision History:
  128.         Version 5.0 adds dated file rotation, G file handling, and rotation in
  129. alphabetical order.  File sharing enhanced for multi-node systems.  Improved
  130. error handling and reporting.  Maximum number of rotatable files increased
  131. from 100 to 400.
  132.  
  133.         Version 4.0 improves filename handling to better suit some not-quite-
  134. standard networks, and corrects a problem that could cause the RotoWel files to
  135. be used as welcome screens.
  136.  
  137.         Version 3.0 corrects an output file size problem, which could cause the
  138. welcome file to be corrupted under rare circumstances.
  139.  
  140.         Version 2.0 corrects a memory corruption problem that could occur on
  141. some systems.
  142.