home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / WILDCAT / DDMENU18.ZIP / DDMENU18.DOC < prev    next >
Text File  |  1994-01-23  |  6KB  |  136 lines
  1. Beta Docs:  For DoorDoor Menu System
  2.  
  3. Just what is this stuff?
  4.      This is a procedure that allows a door to call a gateway to up to
  5.      15 doors, and also keep the usage statistics for the doors in the
  6.      gateway. I will refer to these doors as doordoors from here on out.
  7.      The procedure creates its own menu for the gateway from the data
  8.      file ddmenu.dat.
  9.  
  10. The programming toolkit assumes you are using a fossil driver.
  11.  
  12. Files included in ddmenu##.zip are:
  13. ddmenu.exe      The soul of the procedure.
  14. nuthse.cfg      Sample config file (the name cannot be changed).
  15. ddmenu.dat      Sample data file for a doordoor.
  16. ddmenu##.doc      This file.
  17. readme.com      This file in a screen readable form.
  18. one.bat         Sample batch files
  19. two.bat
  20. three.bat
  21.  
  22. The nuthse.cfg should be as follows:
  23.      Line 1:   Sysop's name
  24.            //* If the sysop's names begin with capital letter and the
  25.                rest are lower case, then the sysop's name won't appear
  26.                as the last user when the sysop enters the door. If you
  27.                want your name to appear, then Make line 1 all capital
  28.                letters. I did this because I don't like everyone knowing
  29.                if or when I tried a door.  (tested with door.sys)*//
  30.      Line 2:   Name of the BBS
  31.  
  32.  
  33. ddmenu.dat
  34.      Each line keeps the usage data for that door,
  35.           i.e. line1 is the data for doordoor 1. and looks like
  36.           the following:
  37.           str1,str2,str3,str4,str5^
  38.      where:
  39.      str1 is the number of times that ddoor1 has been entered.
  40.      str2 is an 'a' or 'p' or '0'. If str1 is an 'a', then
  41.           the users alias will be printed as the last user. If it is a 'p',
  42.           then a name I chose will be printed, e.g. Liz Taylor. If a '0'
  43.           is there, then the real users name will be used.
  44.      str3 is last user's name.
  45.      str4 is the time of day the last user entered the door.
  46.      str5 is the description of the door.
  47.      Please note that a comma is between each str# and the line ends with
  48.           a caret (shift-6) . This is essential that each line be in this
  49.           form! See the sample ddmenu.dat file included.
  50.  
  51. Directions to make door# on your system a gateway to doors.
  52.  
  53.      1-   Unzip the ddmenu.zip file into a work directory.
  54.      2-   Print out this file on your printer.
  55.      3-   Edit nuthse.cfg and ddmenu.dat to your wants.
  56.      4-   copy ddmenu.exe and the nuthse.cfg(s) into your BBS directory
  57.           e.g.  c:\wc30.
  58.      5-   Make a directory ddoor#, e.g. c:\wc30\doors\ddoor20 would be a
  59.           path to the directory if door20.bat is the bat file to the
  60.           gateway ddoor20.
  61.                e.g.:  give the following commands
  62.                     cd\wc30\doors
  63.                     md ddoor20
  64.  
  65.      6-   Copy your ddmenu.dat file to this new directory.  You can edit
  66.           this with an ascii editor.
  67.      7-   Make a one.bat file to run the first ddoor program, a two.bat
  68.           to run the second doordoor program, etc. Each line
  69.           in the ddmenu.dat file should have a *.bat file included in
  70.           this directory. The bat files MUST be named as follows:
  71.                one.bat
  72.                two.bat
  73.                three.bat
  74.                four.bat
  75.                five.bat
  76.                six.bat
  77.                seven.bat
  78.                eight.bat
  79.                nine.bat
  80.                ten.bat
  81.                eleven.bat
  82.                twelve.bat
  83.                thirteen.bat
  84.                fourteen.bat
  85.                fifteen.bat
  86.  
  87.           You only need as many as doors you want to run in this doordoor.
  88.           Remember 15 doors is the maximun number of doors that can be run
  89.           from Doordoor. Look into one.bat file included.
  90.  
  91.      8-   Edit your door#.bat file so it appears as the following
  92.                ddmenu <path to doordoor dir>
  93.  
  94.           A sample door#.bat file would be:
  95.                ddmenu c:\wc30\doors\ddoor20
  96.  
  97.           It is essential that the above line be in the door#.bat file
  98.                before any change in directories, i.e. the ddmenu.exe
  99.                file must find your drop file first. If your door#.bat
  100.                file doesn't open up in a directory where your drop file
  101.                is, then first change to this directory.
  102.                e.g.
  103.                     c:
  104.                     cd\BBS\...\node1
  105.                     ddmenu c:\...\ddoor20
  106.  
  107.      9-   Fire up your BBS and try it, but first say a prayer and if it
  108.           doesn't work, you shouldn't get mad at me.
  109.  
  110.      This utility was compiled using Borland's 3.1 C++ compiler and Brian
  111.           Pirie's Opendoor door kit (which requires a fossil driver, e.g.
  112.           X00 or BNU, be installed).
  113.  
  114.      These docs were written for  a Wildcat BBS, as that is all
  115.      that I know. I think this system will fly on many BBSs, I don't know.
  116.      Also, it has not been tried out on a multi-node BBS, but I hope it
  117.      will run alright there also.
  118.  
  119.      This will say the procedure is registered to line 2 of the nuthse.cfg
  120.      file. If you like this program, and want your name to be included
  121.      as a donor in the next docs, you may send me a tax deductible
  122.      check made out to:
  123.                 Lock Haven University / Woodward Scholarship
  124.      in the amount you desire, and send to:
  125.  
  126.           Jim Woodward
  127.           556 W. Main St.
  128.           Lock Haven, PA 17745-1109
  129.  
  130.      This money will assist a future teacher spend a semester studying
  131.      abroad. I strongly believe that our teachers must understand other
  132.      cultures.
  133.  
  134.      Any other comments, good, bad, or indifferent are welcome, just
  135.      send to the above address.
  136.