home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / SF32_2.ZIP / MKSFFBBS.ZIP / MKSFFBBS.DOC next >
Text File  |  1990-08-15  |  9KB  |  214 lines
  1.  
  2.  
  3.                        MKSFFBBS (Make SFFILES.BBS)
  4.                              Version 1.2
  5.                               Written by
  6.                               Mike Woltz
  7.                          Buffalo Creek Software  
  8.                            913 - 39th Street
  9.                       West Des Moines, Iowa 50265
  10.                            All Rights Reserved
  11.  
  12.  
  13. PURPOSE OF MKSFFBBS.EXE
  14. -----------------------
  15.                          
  16.          MKSFFBBS (Make SFFILES.BBS) is a program developed to
  17.     facilitate sysops in the creation of their SFFILES.BBS necessary
  18.     when running SPITFIRE Bulletin Board System.  SFFILES.BBS is 
  19.     used to provide a file listing of a bulletin board's individual
  20.     file areas.  SFFILES.BBS is displayed to the user to show what
  21.     files are available for download on the BBS.   
  22.  
  23.  
  24. USE OF MKSFFBBS.EXE
  25. -------------------
  26.  
  27.          MKSFFBBS can be executed by typing MKSFFBBS at the DOS
  28.     prompt from any directory.  When first executed the Buffalo
  29.     Creek Software logo appears at the top center of the screen
  30.     displaying the program name.  Directly beneath the logo a prompt
  31.     appears which asks the user for the directory in which the
  32.     SFFILES.BBS file is to be created.  You will then need to   
  33.     respond by inputting the drive and subdirectory for which 
  34.     you are creating your SFFILES.BBS.  In the event an invalid 
  35.     path is entered, MKSFFBBS will display a message that the "Path
  36.     does not exist", terminate execution and return to the DOS
  37.     prompt.  Once the path has been entered correctly, you will
  38.     then be prompted as to whether you wish the program, MKSFFBBS,
  39.     to use the current date or the existing file date.  Simply enter 
  40.     <T> if you prefer to use today's date or <F> for the file date.
  41.  
  42.          MKSFFBBS will individually display each file within the specified
  43.     directory (one at a time), along with the preferred date format you
  44.     selected earlier and the file size.  As each file is displayed, MKSFFBBS 
  45.     will prompt you by asking "Do you wish to add FILENAME.EXT? [y/n]".    
  46.      
  47.     
  48.  
  49.     FILENAME.EXT   123,456  08-15-90  Do you wish to add FILENAME.EXE? [y/n]?
  50.     
  51.     
  52.     If you respond with a "Y", the filename, file size, and file date 
  53.     continues to be displayed and to the right of this display, a
  54.     forty-five character input space is provided for you to supply a brief 
  55.     description of the file. 
  56.     
  57.     
  58.     
  59.                                     1---|---10---|---20---|---30---|---40---|
  60.     FILENAME.EXT   123,456  10-01-88     
  61.     
  62.     
  63.     Insert (In)Active                                     ESC to abort to DOS
  64.  
  65.     
  66.     At the bottom of the screen, a message is displayed which notifies you 
  67.     if the insert mode is active or inactive and also informs you that you
  68.     may abort the program and return to DOS by hitting the ESC key.
  69.           
  70.     If you respond with a "N" the file is not included in the SFFILES.BBS. 
  71.     This will continue until all files in the directory have been reviewed.
  72.         
  73.  
  74.  
  75.         However, if an SFFILES.BBS file already exists, a message will 
  76.      be displayed notifying you that:
  77.      
  78.      SFFILES.BBS already exists.   
  79.      <A>... Append Present SFILES.BBS
  80.      <C>... Create New SFFILES.BBS
  81.      <Q>... Quit
  82.      Enter Command:
  83.         
  84.     If you respond with a <Q>... Quit MKSFFBBS.EXE is terminated and you 
  85.     are returned to the DOS prompt.  
  86.     
  87.     If you select to <C>...Create New SFFILES.BBS, you will progress through
  88.     the same steps as if you were setting up the SFFILES.BBS for the first
  89.     time and follow the same procedure described previously.  Please note,
  90.     however, if you choose <C>... Create New SFFILES.BBS, all the existing
  91.     file descriptions will be overwritten!
  92.     
  93.     Most often, you will want to <A>ppend Present SFFILES.BBS file.  If 
  94.     a SFFILES.BBS exists and you choose to append the existing file, then 
  95.     only the files from the specified directory which do not already exist 
  96.     in SFFILES.BBS will be displayed so a brief description can be entered.
  97.  
  98.  
  99. EXITING MKSFFBBS
  100. ----------------
  101.  
  102.          After MKSFFBBS has displayed all the files in the directory and
  103.     you have entered your file descriptions, MKSFFBBS will display the
  104.     message "Finished with C:\PATH" (C:\PATH will be the drive and the
  105.     directory you specified).  You are 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.          
  127. CURSOR CONTROL
  128. ---------------
  129.  
  130.          As you move through each of the indiviual file listing for the
  131.     previously specified drive and subdirectory, you will may use any of
  132.     the following cursor movements while entering you descriptions:
  133.  
  134.  
  135.     Left arrow key  -- This will move the cursor left 1 character position.
  136.  
  137.     Right arrow key -- This will move the cursor right 1 character  
  138.                        position.
  139.  
  140.     Home key        -- This will move cursor to the beginning of the current 
  141.                        line.  
  142.              
  143.     End key         -- This will move cursor to the end of the current line.
  144.  
  145.  
  146.     Del key         -- This will delete the character in the current cursor
  147.                        posistion.
  148.       
  149.     Backspace key   -- This will delete the character to the left of the 
  150.                        current cursor position.
  151.                        
  152.     Escape key      -- Will abort the program and return you to the DOS  
  153.                        prompt. 
  154.  
  155.  
  156.       When entering your file descriptions, MKSFFBBS provides forty-five
  157.       character spaces for your remarks.  If you attempt to enter more
  158.       than the forty-five characters allowed the cursor will stop at the 
  159.       last space and a beep is issued to signal that no other input
  160.       can be entered.  
  161.                          
  162.  
  163. INSERT MODE
  164. ------------
  165.     
  166.        The insert key can be used to activate and deactivate the insert
  167.    mode.  The present mode is always displayed in the lower left hand 
  168.    portion of the screen.  It will display either as Insert Active or 
  169.    Insert Inactive.  
  170.  
  171.  
  172. ADDITIONAL FUNCTION
  173. -------------------
  174.  
  175.          Although MKSFFBBS was primarily written for sysops creating
  176.     SFFILES.BBS when setting up their SPITFIRE Bulletin Board Systems,
  177.     the program also has an additional purpose.  The program may be
  178.     used to keep a text file listing of any files in a subdirectory of a
  179.     hard drive and also diskettes.  You may then want to rename the 
  180.     SFFILES.BBS to possibly match the directory name with a common
  181.     extension.  For instance, if you had a directory named UTIL and
  182.     created a SFFILES.BBS listing of all the files in the directory 
  183.     including a brief description, you may want to rename it UTIL.LST
  184.     to imply it is a listing of the files in your utility directory.
  185.     You can then use the DOS TYPE command or any text editor to view
  186.     the file created.
  187.  
  188.  
  189. FILE SHARING
  190. ------------
  191.          MKSFFBBS utilizes file sharing capabilities, therefore, there
  192.     should be no confliction using MKSFFBBS with the multi-node versions
  193.     of SPITFIRE.
  194.  
  195. MKSFFBBS.EXE DISCLAIMER
  196. -----------------------
  197.  
  198.          MKSFFBBS.EXE is offered freely as a public domain program 
  199.     for your use.  However, Mike Woltz and/or Buffalo Creek Software
  200.     shall not be held responsible for any damage incurred by the user
  201.     to hardware, software, or peripheral devices while running 
  202.     MKSFFBBS.EXE.  All responsibility lies with the user of the 
  203.     software.
  204.  
  205.           MKSFFBBS.DOC is contributed by Jacque Shipley and The Mother
  206.     Board BBS.  SPITFIRE and SPITFIRE utilities are available for download
  207.     on:
  208.     
  209.        Buffalo Creek's BBS                     The Mother Board BBS
  210.         Sysop - Mike Woltz                    Sysop - Jacque Shipley  
  211.        19200/9600/2400/1200                        9600/2400/1200  
  212.          (515) 225-8496                            (515) 986-3445
  213.  
  214.