home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MKSFMENU.ZIP / MKSFMENU.DOC < prev    next >
Text File  |  1993-09-06  |  12KB  |  248 lines
  1.  
  2.                            SPITFIRE MENU MAKER
  3.                                Version 1.5
  4.                                     by
  5.                                 Mike Woltz         
  6.                           Buffalo Creek Software        
  7.         
  8.         
  9.            SPITFIRE MENU MAKER is a companion utility written to
  10.         enhance the menu screens within SPITFIRE Bulletin Board
  11.         System.  MKSFMENU uses the information contained in the
  12.         SFMAIN.MNU, SFFILE.MNU, SFMSG.MNU, SFSYSOP.MNU, SFDOOR.MNU
  13.         and SFORDER.MNU to create fancy, bordered RIP, ANSI and 
  14.         non-color menus for callers of each security level on your 
  15.         system.
  16.         
  17.  
  18.    MKSFMENU EXECUTION
  19.    ------------------        
  20.  
  21.             You will need to place MKSFMENU.EXE in the same directory 
  22.         where the SFMAIN.MNU, SFFILE.MNU, SFMSG.MNU, SFSYSOP, and the
  23.         optional SFDOOR.MNU and SFORDER.MNU files reside.  (This will 
  24.         normally be the SF directory.)  If you attempt to run MKSFMENU 
  25.         without these files present, MKSFMENU will display a screen 
  26.         which informs you the "SFMAIN.MNU, SFFILE.MNU and SFMSG.MNU 
  27.         must reside in this directory for proper operation!", 
  28.         announce that the program is "HALTING!!!" and return you to 
  29.         the DOS prompt.
  30.         
  31.             To execute the program, type MKSFMENU at the DOS prompt.
  32.         The screen will clear and the program screen ("SPITFIRE MENU
  33.         MAKER" title displayed within the Buffalo Creek Software logo)
  34.         is displayed.  If SFNODE.DAT is also present in the directory
  35.         you are running MKSFMENU from, it will automatically read the
  36.         information it needs and write the menu files it creates to the
  37.         directory you have specified as the Display File Path.  However,
  38.         if SFNODE.DAT is not found, then MKSFMENU will prompt you for the
  39.         directory in which the menu files are to be created.  For instance, 
  40.         if SFNODE.DAT is not found, the prompt:
  41.                 
  42.             Write menus to C:\SF\DISPLAY\
  43.         
  44.         will appear.   
  45.  
  46.         ***NOTE***  Pressing the ESC key from any menu will allow you
  47.         to quit the program and be returned to the DOS prompt.
  48.  
  49.  
  50.    SPECIFYING SECURITY LEVELS
  51.    --------------------------
  52.         
  53.             The next prompt to appear will be:
  54.           
  55.             Make menus for what security level [ESC To Quit]?
  56.           
  57.             All that is required here is to specify the security level
  58.         you wish to create the menus for.  It is necessary to create 
  59.         separate files for the various security levels so that when the 
  60.         menu is called up, it does not display options of the SPITFIRE 
  61.         menu which may not be available to a caller with a lesser security 
  62.         access level.   More than likely, you will want to create menus
  63.         for all security levels you have available on your system.
  64.  
  65.             For example, if the Sysop would like menus for callers with 
  66.         a security level of 10, he/she would enter 10 at the prompt and
  67.         press return.  
  68.         
  69.             MKSFMENU also provides you with the option of ESCaping
  70.         out of the program by pressing the ESC key.  This will return
  71.         you to the DOS prompt.    
  72.            
  73.         
  74.    MAIN, MESSAGE AND FILE MENU DISPLAY FILES
  75.    -----------------------------------------
  76.    
  77.             Once the security level has been established, the next prompt
  78.         to be displayed, will be:
  79.         
  80.         <C>=CLR Menus  <B>=BBS Menus  <R>=RIP Menus <A>=All Menus  <Q>=Quit
  81.             
  82.             Selecting <C> will create ANSI Menus with a .CLR extension.  
  83.             Selecting <B> will create ASCII Menus with a .BBS extension.
  84.             Selecting <R> will create RIP (Remote Image Protocol) Menus
  85.                           with a .RIP extension.
  86.             Selecting <A> will create ANSI, ASCII and RIP Menus for your
  87.                           SPITFIRE BBS.
  88.  
  89.  
  90.             If you select <C>=CLR Menus, MKSFMENU will create color
  91.         menus for the Main, Message and File menus.  For instance, using
  92.         the previous example, selecting a security level of 10 and then
  93.         selecting <C>=CLR Menus, MKSFMENU will create the following menu 
  94.         files:
  95.         
  96.                    MAIN10.CLR
  97.                    MSG10.CLR
  98.                    FILE10.CLR
  99.                    
  100.             The file name is displayed to the screen as it is created
  101.         and when all files for the specified security level have been
  102.         made a "Finished!" message will appear.    
  103.            
  104.             If <B>=BBS Menus is selected, MKSFMENU will create non
  105.         color menus for the Main, Message and File menus.  For instance,
  106.         using the previous example, selecting a security level of 10 and
  107.         then selecting <B>=BBS Menus, MKSFMENU will create the following 
  108.         menu files:
  109.          
  110.                    MAIN10.BBS
  111.                    MSG10.BBS
  112.                    FILE10.BBS
  113.  
  114.             The file name is displayed to the screen as it is created
  115.         and when all files for the specified security level have been
  116.         made a "Finished!" message will appear.    
  117.         
  118.             If <R>=RIP Menus is selected, MKSFMENU will create RIP Graphic
  119.         menus for the Main, Message and File menus.  For instance, using 
  120.         the previous example, selecting a security level of 10 and then 
  121.         selecting <R>=RIP Menus, MKSFMENU will create the following 
  122.         menu files:
  123.          
  124.                    MAIN10.RIP
  125.                    MSG10.RIP
  126.                    FILE10.RIP
  127.  
  128.             The file name is displayed to the screen as it is created
  129.         and when all files for the specified security level have been
  130.         made a "Finished!" message will appear.    
  131.         
  132.             If you wish to have CLR Menus, BBS Menus and Rip Meus created,
  133.         select <A>=All Menus.  By doing this, MKSFMENU will create the 
  134.         Main, Message and File menus in each of the Graphic formats.  For
  135.         instance, again using the previous example, selecting a security
  136.         level of 10 and then selecting <A>=All Menus, MKSFMENU will create
  137.         the following menu files:
  138.         
  139.                  MAIN10.CLR          MAIN10.BBS       MAIN10.RIP
  140.                  MSG10.CLR           MSG10.BBS        MSG10.RIP
  141.                  FILE10.CLR          FILE10.BBS       FILE10.RIP
  142.  
  143.             The file name is displayed to the screen as it is created
  144.         and when all files for the specified security level have been
  145.         made a "Finished!" message will appear.    
  146.                    
  147.             Selecting the option to <Q>uit will return you to the prompt
  148.         "Make menus for what security level [ESC to Quit]?".  You can
  149.         then create menus for another security level or exit the program
  150.         by pressing the ESC key.
  151.  
  152.  
  153.    SFDOOR AND SFORDER MENU DISPLAY FILES
  154.    -------------------------------------
  155.    
  156.             If either SFDOOR.MNU or SFORDER.MNU (or both) are present 
  157.         MKSFMENU will display an additional prompt which asks whether 
  158.         you wish to make menus for <A>ll Menus, <D>oor Menu Only or 
  159.         <O>rder Menu Only.  The Door Menu Only option will only appear 
  160.         if SFDOOR.MNU is found and the Order Menu Only will only appear 
  161.         if SFORDER.MNU is found.  So if the SFDOOR.MNU and the SFORDER.MNU 
  162.         are not present this prompt will not appear and the menu maker will 
  163.         default to making all the standard menus, i.e., the Main, Message 
  164.         and File Menus.
  165.  
  166.             Selecting <A>ll Menus will create the Main, Message and File
  167.         menu display files for the specified security level and graphic
  168.         option specified previously.  Selecting <D>oor Menu Only will 
  169.         create the SPITFIRE Door menu display file for the security and 
  170.         graphic option specified previously.  Selecting <O>rder Menu Only
  171.         will create the Questionnaire (Order) menu display file for the
  172.         security and graphic option specified previously.
  173.  
  174.    SYSOP MENU DISPLAY FILES
  175.    ------------------------
  176.  
  177.             After the menu maker has completed making the Main, Message
  178.         and File menu display files, MKSFMENU will prompt you as to
  179.         whether you wish to have a Sysop menu display file created for
  180.         that specific security level.  If you respond with a Y, a Sysop
  181.         menu display file will be created.  If you respond with a N, 
  182.         no Sysop menu display is made.
  183.  
  184.    DUPLICATE FILES
  185.    ---------------
  186.  
  187.             If you attempt to create ANSI (.CLR), ASCII (.BBS) or RIP (RIP)
  188.         menus for a particular security level (such as 10 from the previous 
  189.         examples) and the files of that security level already exist, you 
  190.         will be notified, by a message to the screen, that the files already 
  191.         exists.  You are then prompted at each file with:
  192.         
  193.             MAIN10.BBS already exist!
  194.             Do you wish to create a new one?  [Y/n]
  195.         
  196.             (Where SFMAIN10.BBS is equal to any menu file MKSFMENU finds
  197.         already in existence.)
  198.              
  199.             If you respond with a <Y> for yes, the existing file will be 
  200.         overwritten and a new file is created.  If you respond with a <N> for 
  201.         no, you move onto the next file(s) until you are returned to the 
  202.         program screen.
  203.         
  204.  
  205.    EDITING MENU FILES
  206.    ------------------
  207.         
  208.            The Sysop may use any ASCII text editor or screen generating
  209.         program to edit the menus.  An invitation is extended for anyone 
  210.         interested in programming to expand on the existing MKSFMENU so 
  211.         that when creating color menus, specific colors may eventually 
  212.         be set from within the program itself.
  213.         
  214.  
  215.    DISTRIBUTION - DISCLAIMER
  216.    -------------------------
  217.  
  218.            MKSFMENU is distributed under the shareware concept.  This
  219.         program may be distributed freely.   A $1.00 registration fee 
  220.         is required for MKSFMENU and should be sent to:
  221.         
  222.                             Buffalo Creek Software
  223.                             ATTN: Mike Woltz
  224.                             913 39th Street
  225.                             West Des Moines, Iowa   50265
  226.  
  227.         Mike Woltz and/or Buffalo Creek Software shall not be held 
  228.         responsible for any damage incurred by the user to hardware, 
  229.         software, or peripheral devices while running MKSFMENU.  All 
  230.         responsibility lies with the user of the software.
  231.  
  232.  
  233.             MKSFMENU.DOC contributed by Jacque Shipley of The Mother Board
  234.         BBS.  SPITFIRE and other companion programs and utilities are
  235.         available for download from:
  236.         
  237.         
  238.         Buffalo Creek's BBS                     The Mother Board BBS
  239.          Sysop - Mike Woltz                    Sysop - Jacque Shipley
  240.       38400/19200/9600/2400/1200                   9600/2400/1200
  241.           (515) 225-8496                           (515) 986-3464
  242.  
  243.       REVISION 1.4 - April 10, 1993 - MKSFMENU was revised to support the
  244.       24 questionnaires which are available via SPITFIRE v3.3.
  245.  
  246.       REVISION 1.5 - September 6, 1993 - MKSFMENU was revised to support
  247.       RIP Graphics
  248.