home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / RIU100.ZIP / RIU.DOC < prev    next >
Text File  |  1994-02-13  |  12KB  |  305 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                           Rip Icon Updater
  11.                         By Andrew J. Murphy
  12.                         BlackStar Software
  13.                           (508) 772-4072
  14.                       FidoNet Node 1:322/270
  15.  
  16.  
  17.                       For latest Version of
  18.                           this program
  19.  
  20.                            FREQ  RIU
  21.  
  22.           I can also be reached at 1:322/735 and 1:309/2
  23.              after I move in june or july of 1994.
  24.  
  25.  
  26.      WHAT IS RIU? . . . . . . . . . . . . . . . . . . . . . . . . .  1
  27.  
  28.      FEATURES . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  29.  
  30.      DISCLAIMER . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  31.  
  32.      REGISTRATION . . . . . . . . . . . . . . . . . . . . . . . . .  2
  33.  
  34.      INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . .  4
  35.  
  36.      Custom Menu Setup (Registered copies only) . . . . . . . . . .  4
  37.  
  38.      SYSOP Function Keys. . . . . . . . . . . . . . . . . . . . . .  6
  39.  
  40.      Configuration file . . . . . . . . . . . . . . . . . . . . . .  7
  41.  
  42.      CREDITS. . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  43.  
  44.                              WHAT IS RIU?
  45.  
  46.      RIU (Rip Icon Updater) is a utility that will let you download icons,
  47. but a little more.  It allows you to download an update file, or ripterm. 
  48. I looked at each of the offerings, and found that there wasn't much to
  49. choose from.  There were some fairly decent offerings but they were to
  50. expensive or needed some kind of run time library.   The one I liked best
  51. didn't provide support for COM3: and that is a must for me!  So I decided
  52. to write myself one.  It wasn't long before a couple sysop friends said you
  53. gotta make this shareware, and "can you add this".  The result is RIU.  
  54. Why a "download update" option?   What if your icon file is fairly large,
  55. and you add one icon?  Why make a user get the whole thing again?  Why the
  56. download ripterm option?  What if a caller dials in at 2400 baud and wants
  57. it, but you limit callers to 30 minutes a day for instance?  Let's see,
  58. 650K +/- 50K  at 2400 baud? Hmmm, doesn't take a brain surgeon to figure
  59. that one out!!!  This way they can get it, without worrying about time
  60. constraints.  They will have burned their time for the day, but they will
  61. have it without bugging you about it!
  62.  
  63.                           FEATURES
  64.  
  65.      Supports Com 1-4 at least, maybe more.  (Let me know!)
  66.  
  67.      Supports DORINFO1.DEF, EXITINFO.BBS, CHAIN.TXT, SFDOORS, CALLINFO.BBS, 
  68.               DOOR.SYS.
  69.  
  70.      Supports locked bauds to 38,400 using fossil drivers.
  71.  
  72.      Allows download of Ripterm, the icon file, and the icon update file.
  73.  
  74.      Supports Rip display, ANSI and Avatar graphics mode.
  75.  
  76.      Download with Xmodem, Ymodem, and Zmodem.  No bat files to create.
  77.  
  78.      Coded in C for freedom from Run Time Libs.
  79.  
  80.      Supports chat, add/subtract user time, hang up, quit door, and other
  81.      sysop functions.
  82.  
  83.  
  84.                               DISCLAIMER
  85.  
  86.      Ya gotta have one!  I did my best, but there may be a mistake just
  87. waiting to wipe out your computer.  Back up before you start.  If you
  88. don't, you are taking your life into your own hands, or rather your
  89. computer's life.  I will not be held responsible for any lost programs or
  90. data as a result of using this program.  I guarantee that it will take up
  91. space on your hard drive, and if it doesn't, I will provide you with a copy
  92. that does.  I reserve all rights to this code. It is not free, 30 days is
  93. all you get to use it without registration.  
  94. Distribute the archive far and wide, but keep it together please!  
  95. I make no promise to produce further revisions of this software,
  96. nor do I make any claims of compatibility.
  97.  
  98.                                REGISTRATION
  99.  
  100.      I only put a few hours work into this, and I think doors are to
  101. expensive anyway.  If you like this door, send me $5.00.  If you don't like
  102. it, give it to someone else who might.  On the following page is an order
  103. form.  Make checks payable to "Andrew Murphy".  If you send money, you are
  104. taking a risk that the mail might loose it or that I might be a crook.  Do
  105. you feel lucky?  Send the order form to this address:  This address will
  106. only be valid until june 10 1994.  After that date NetMail me through Robin
  107. Moore's BBS at 1:309/2 Via FidoNet.
  108.  
  109.      BlackStar BBS
  110.      C/O Andrew Murphy
  111.      705E Salerno
  112.      Ft. Devens MA 01433
  113.  
  114.                        What Will registration do for you?
  115.  
  116.     -  You can use your own menus on the registered version, complete
  117.        with @codes needed to duplicate the function of the built in menus.
  118.  
  119.     -  Rights to all future revs of this program.  Also you may be entitled
  120.        to discounts on future BlackStar Software Products.
  121.  
  122.     -  The satisfaction that you are helping a part time programmer on a
  123.        low income feed his three kids!  
  124.  
  125.     -  Freedom from the "This program is not registered messages!!!!!
  126.  
  127.                RIP ICON UPDATER  Registration Form
  128.  
  129. Please print legibly, and remember the sysop name and the BBS name are
  130. used in the key code generation.  Registration fee is $5.00 American
  131. dollars.
  132.  
  133.  
  134. Name __________________       BBS Name ____________________________
  135.  
  136. Computer Type _________       BBS  #   ____________________________
  137.  
  138. Address _____________________ City,St. Zip ________________________
  139.  
  140. FidoNet address if applicable ______________________
  141.  __
  142. |__|  I will pick up the key code.
  143.  __
  144. |__|  Crash mail it to my fidonet node.  (North America only)
  145.  
  146. Comments & Suggestions ____________________________________________
  147.  
  148. ___________________________________________________________________
  149.  
  150. ___________________________________________________________________
  151.  
  152.  
  153. I will deliver your key code in one of three ways. One, I will leave it in
  154. a private message in area 0 on my BBS. Two, I will crash mail your bbs in
  155. fidonet if you have a node number.  Three, I will mail it to you.  If you
  156. choose that method, send a self addressed stamped envelope along with your
  157. order.
  158.  
  159.  
  160.  
  161.                               INSTALLATION
  162.  
  163.      Installation of RIU is as simple as I could make it. It's only
  164. prerequisites are that DSZ be in your path, and that you be running a
  165. fossil driver.   Before you start you will need a registration number and
  166. the path and filename of these files:
  167.  
  168.      1.  Your complete icon file
  169.  
  170.      2.  Your icon Update file (Again, if you dont want one use path from
  171.          #1 above, or some other file if you like, maybe a bbs registration)
  172.  
  173.      3.  Your latest copy of ripterm
  174.  
  175.      Follow these easy steps to install RIU.
  176.  
  177.      1.   Make a directory for it anywhere, and unpack it there.
  178.  
  179.      2.   Get a registration key
  180.  
  181.      3.   Run RIUCFG.exe to generate the configuration file.  The config
  182.           file is described later.
  183.  
  184.      4.   Create a bat file that changes to the directory containing RIU,
  185.           and run it, passing it the Path to your door drop file (door.sys,
  186.           chain.txt, dorinfo1.def etc).  This is an example bat file that
  187.           assumes your door.sys type file is in subdir "BBS".  If you do
  188.           not run a fossil driver see the section on fossils later.
  189.  
  190.                @echo off
  191.                c:
  192.                cd \riu
  193.                RIU c:\BBS\
  194.  
  195.      5.    Run it!  You can log on locally to take a look at it.  
  196.  
  197.  
  198.                   Custom Menu Setup (Registered copies only)
  199.  
  200.      Setup of custom menus requires only that you have a legit registration
  201. key, and that you put menus in place.  There are 4 menus needed, and
  202. you need not have all 4 in place.  Each menu should clear the screen when
  203. it is drawn, and when a button is selected to leave it.  Otherwise, menus
  204. may overwrite each other.   Menu types are RIP (.RIP), ANSI (.ANS), 
  205. and ASCII (.ASC).
  206.  
  207.      1.   MainMenu.*     The Main Menu, selects download ripterm, download
  208.                          update icon file, all icons file, or continue
  209.                          logon.
  210.  
  211.      2.   ProMenu.*      The Protocol Menu, selects x/y/z modem or abort.
  212.  
  213.      3.   Start.*        Selects either start download or abort download.
  214.  
  215.      4.   Unpack.*       Says Drop to dos and unpack icons into icon
  216.                          directory, press return to continue.
  217.  
  218.   There are three @codes with RIU.  They are:
  219.  
  220.     1. @UPDATE@  Date icons last updated.  Taken from UPDATE.zip file
  221.                  works with menus 1 & 2.
  222.  
  223.     2. @LASTCL@  Date caller was last on your BBS.  Works in menus 1 & 2.
  224.  
  225.     3. @FILENAME@  Name of file selected from main menu.  Used in menu 2
  226.                    only.
  227.  
  228.  
  229.                           SYSOP Function Keys
  230.  
  231.                [UP]/[DOWN]   Use the arrow keys to increase or decrease the
  232.                              amount of time which the user has left in the
  233.                              door.
  234.  
  235.                [Alt]-[C]      Allows the sysop to break into chat with the
  236.                               user at any time. [Alt]-[C] again, or [ESC]
  237.                               will end chat mode.
  238.  
  239.                [Alt]-[J]      Allows the sysop to shell to DOS, if enough
  240.                               memory is available. Simply type EXIT to
  241.                               return to the door again.
  242.  
  243.                [Alt]-[H]      Hang up on the user when the sysop does
  244.                               this.
  245.  
  246.                [Alt]-[L]      This key locks the user out of the BBS. It
  247.                               first hangs up on the user, and then sets
  248.                               their security level to 0, in the door drop
  249.                               file.  BBS dependant function.
  250.  
  251.                [Alt]-[K]      "User Keyboard-Off"
  252.  
  253.                [Alt]-[D]      "Drop to BBS" key. This function allows the
  254.                               sysop to exit the door and return the user to
  255.                               the BBS, without hanging up.
  256.  
  257.                [F1]..[F10]    The Function keys [F1] through [F10] allows
  258. the
  259.                               sysop access to various types of information
  260.                               on the status line, or to turn the status
  261.                               line off. These keys are as follows:
  262.  
  263.                              [F1]  Display basic door and user information
  264.                              [F2]  Display phone numbers and important
  265.                                    dates
  266.                              [F3]  Display security flags and up/download
  267.                                    info
  268.                              [F4]  Display system information and current
  269.                                    time
  270.                              [F5]  Display message info and user's settings
  271.                              [F6]  Display chat reason and sysop's comment
  272.                              [F9]  Display help information for sysop
  273.                              [F10] Turn off the status line
  274.  
  275.  
  276.                     Configuration file (Created by RIUCFG.exe)
  277.  
  278.      This is a sample configuration file.
  279.  
  280. The BlackStar BBS  
  281. Andrew Murphy  
  282. 00000000  
  283. c:\wc30\icons\update.zip  
  284. c:\wc30\icons\bsricons.zip  
  285. d:\msdos\rip\riptm154.zip  
  286.  
  287.  
  288.  
  289. Line 1 is your BBS name.
  290. Line 2 is your name.
  291. Line 3 is your registration code.
  292. Line 4 is the path and filename of your icon update file.
  293. Line 5 is the path and filename of your all icons file.
  294. Line 6 is the path and filename of your riptm154.zip
  295.  
  296.      
  297.                               CREDITS
  298.  
  299. Compiled with BORLAND and OPENDOORS libraries.
  300.  
  301. Beta Testing by Phil Trevorrow & Rick Blough & Randal Labrake.
  302.  
  303. RIP is a trademark of TeleGrafix Communications Inc.
  304.  
  305.