home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / MODEM / MKSFFBBS / MKSFFBBS.DOC < prev    next >
Text File  |  1993-12-01  |  9KB  |  203 lines
  1.                        MKSFFBBS (Make SFFILES.BBS)
  2.                              Version 2.0
  3.                               Written by
  4.                               Mike Woltz
  5.                          Buffalo Creek Software  
  6.                            913 - 39th Street
  7.                       West Des Moines, Iowa 50265
  8.                            All Rights Reserved
  9.  
  10.  
  11. PURPOSE OF MKSFFBBS
  12. -------------------
  13.                          
  14.          MKSFFBBS (Make SFFILES.BBS) is a program developed to
  15.     facilitate sysops in the creation of their SFFILES.BBS necessary
  16.     when running SPITFIRE Bulletin Board System.  SFFILES.BBS is 
  17.     used to provide a file listing of a bulletin board's individual
  18.     file areas.  SFFILES.BBS is displayed to the user to show what
  19.     files are available for download on the BBS.   
  20.  
  21.  
  22. USE OF MKSFFBBS
  23. ---------------
  24.  
  25.          MKSFFBBS can be executed by typing MKSFFBBS at the DOS
  26.     prompt from the SPITFIRE HOME directory.  When first executed
  27.     the Buffalo Creek Software logo appears at the top center of
  28.     the screen displaying the program name.  Directly beneath the
  29.     logo a prompt appears which asks the user for the File Area in
  30.     which the SFFILES.BBS file is to be created.  You will then need
  31.     to respond by inputting the number of the File Area for which 
  32.     you are creating your SFFILES.BBS.  Simply pressing your < ENTER >
  33.     will cause MKSFFBBS to list the available File Areas. Once the 
  34.     File Area has been entered correctly, you will then be prompted
  35.     as to whether you wish the program, MKSFFBBS, to use the current
  36.     date or the existing file date.  Simply enter <T> if you prefer
  37.     to use today's date or <F> for the file date.  In the event an
  38.     SFFILES already exists in the selected File Area, you will then
  39.     be prompted with the below listed menu:
  40.      
  41.     SFFILES.BBS already exists.   
  42.     <A>... Append Present SFILES.BBS
  43.     <C>... Create New SFFILES.BBS
  44.     <Q>... Quit
  45.     Enter Command:
  46.         
  47.          If you respond with a <Q>... Quit MKSFFBBS is terminated and
  48.     you are returned to the DOS prompt.  
  49.     
  50.          If you select to <C>...Create New SFFILES.BBS, you will progress
  51.     through the same steps as if you were setting up the SFFILES.BBS for 
  52.     the first time and follow the same procedure described previously.
  53.     Please note, however, if you choose <C>... Create New SFFILES.BBS, all
  54.     the existing file descriptions will be overwritten!
  55.     
  56.          Most often, you will want to <A>ppend Present SFFILES.BBS file.  If
  57.     a SFFILES.BBS exists and you choose to append the existing file, then 
  58.     only the files from the specified directory which do not already exist 
  59.  
  60.          MKSFFBBS will individually display each file within the specified
  61.     directory (one at a time), along with the preferred date format you
  62.     selected earlier and the file size.  As each file is displayed, MKSFFBBS 
  63.     will prompt you by asking "Do you wish to add FILENAME.EXT? [y/n]".    
  64.      
  65.     
  66.  
  67.     FILENAME.EXT   123,456  08-15-90  Do you wish to add FILENAME.EXE? [y/n]?
  68.     
  69.     
  70.          If you respond with a "Y", the filename, file size, and file date 
  71.     continues to be displayed and to the right of this display, a
  72.     forty-five character input space is provided for you to supply a brief 
  73.     description of the file.  You will be provided the ability to enter
  74.     the number of file description lines per your SPITFIRE configuration.
  75.     
  76.     
  77.                                     1---|---10---|---20---|---30---|---40---|
  78.     FILENAME.EXT   123,456  10-01-88     
  79.     
  80.     
  81.     Insert (In)Active   2 File Description Lines Allowed!  ESC to abort to DOS
  82.  
  83.          At the bottom of the screen, a message is displayed which notifies
  84.     you if the insert mode is active or inactive and also informs you that
  85.     you may abort the program and return to DOS by hitting the ESC key.
  86.           
  87.          If you respond with a "N" the file is not included in the SFFILES. 
  88.     This will continue until all files in the directory have been reviewed.
  89.  
  90.  
  91. CD-ROM SUPPORT
  92. --------------
  93.  
  94.          MKSFFBBS supports the use of CD-Rom drives.  In the event the File
  95.     Area you select is configured as a CD-Rom area, then MKSFFBBS will work
  96.     with the appropriate SFFILES in your DISPLAY directory while reading
  97.     the file information from the configured directory on the CD-Rom.
  98.  
  99.  
  100. EXITING MKSFFBBS
  101. ----------------
  102.  
  103.          After MKSFFBBS has displayed all the files in the directory and
  104.     you have entered your file descriptions, MKSFFBBS, if you appended
  105.     an existing SFFILES you will then prompted with the following:
  106.     "Would you like to check files against listing? [y/n]?"  This provides
  107.     an opportunity to check that all files listed in the SFFILES.BBS do,
  108.     in fact, exist in the directory.  If you respond with a "Y" and 
  109.     MKSFFBBS encounters a file listed in the SFFILES.BBS which does not
  110.     exist in the directory, you will be prompted with "Filename.ext not
  111.     found! Purge from list? [y/n]".  This is a quick way to make sure if
  112.     a file has been erased from the directory, that it has also been 
  113.     removed from the SFFILES.BBS list.  If you respond with a "N" the
  114.     file will remain listed in the SFFILES.BBS and if you respond with
  115.     a "Y" the file will be removed from the SFFILES.BBS listings.
  116.     
  117.          If you respond with a "N" to the "Would you like to check files
  118.     against listing?" or once you have completed the purge file option,
  119.     you are then prompted with "Do another? [y/n]".  This will allow you
  120.     to execute the MKSFFBBS on a new drive and/or directory.  If "Y" is 
  121.     selected you are once again prompted for the path and the program 
  122.     will continue as described above.  If you select "N" the program is 
  123.     terminated and you are returned to the DOS prompt.     
  124.     
  125.          
  126. CURSOR CONTROL
  127. ---------------
  128.  
  129.          As you move through each of the indiviual file listing for the
  130.     previously specified drive and subdirectory, you will may use any of
  131.     the following cursor movements while entering you descriptions:
  132.  
  133.  
  134.     Left arrow key  -- This will move the cursor left 1 character position.
  135.  
  136.     Right arrow key -- This will move the cursor right 1 character  
  137.                        position.
  138.  
  139.     Home key        -- This will move cursor to the beginning of the current 
  140.                        line.  
  141.              
  142.     End key         -- This will move cursor to the end of the current line.
  143.  
  144.  
  145.     Del key         -- This will delete the character in the current cursor
  146.                        posistion.
  147.       
  148.     Backspace key   -- This will delete the character to the left of the 
  149.                        current cursor position.
  150.                        
  151.     Escape key      -- Will abort the program and return you to the DOS  
  152.                        prompt. 
  153.  
  154.  
  155.       When entering your file descriptions, MKSFFBBS provides forty-five
  156.       character spaces for your remarks.  If you attempt to enter more
  157.       than the forty-five characters allowed the cursor will stop at the 
  158.       last space and a beep is issued to signal that no other input
  159.       can be entered.  
  160.                          
  161.  
  162. INSERT MODE
  163. ------------
  164.     
  165.        The insert key can be used to activate and deactivate the insert
  166.    mode.  The present mode is always displayed in the lower left hand 
  167.    portion of the screen.  It will display either as Insert Active or 
  168.    Insert Inactive.  
  169.  
  170. FILE SHARING
  171. ------------
  172.          MKSFFBBS utilizes file sharing capabilities, therefore, there
  173.     should be no confliction using MKSFFBBS with the multi-node versions
  174.     of SPITFIRE.
  175.  
  176.  
  177. MKSFFBBS DISCLAIMER
  178. -------------------
  179.  
  180.          While Buffalo Creek Software reserves all rights to MKSFFBBS,
  181.     it is offered free for your use.  However, Mike Woltz and/or Buffalo
  182.     Creek Software shall not be held responsible for any damage incurred
  183.     by the user to hardware, software, or peripheral devices while running 
  184.     MKSFFBBS.  All responsibility lies with the user of the software.
  185.  
  186.           MKSFFBBS.DOC is contributed by Jacque Shipley and The Mother
  187.     Board BBS.  SPITFIRE and SPITFIRE utilities are available for download
  188.     on:
  189.     
  190.        Buffalo Creek's BBS                     The Mother Board BBS
  191.         Sysop - Mike Woltz                    Sysop - Jacque Shipley  
  192.     38400/19200/9600/2400/1200                     9600/2400/1200  
  193.          (515) 225-8496                            (515) 986-3445
  194.  
  195. REVISIONS
  196. ---------
  197.  
  198.     Version 2.0 (June 1, 1992) - MKSFFBBS was revised to support multi-line
  199.     file descriptions.  MKSFFBBS was also revised to support CD-Rom drives.
  200.     When working with a File Area marked as a CD-Rom area MKSFFBBS creates
  201.     and maintains a SFFILES file in the configured DISPLAY directory whichs
  202.     pertains to the files in the File Area's download path.
  203.