home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / SFHDR206.ZIP / SFHEADER.DOC < prev    next >
Text File  |  1992-06-16  |  9KB  |  201 lines
  1.                          ****  SF-HEADER  ****
  2.                              Version 2.06
  3.                           Copyright (C) 1991-1992
  4.                     By Russell Mikami & Dick Sanders
  5.                         Hawke Software Systems
  6.  
  7.  
  8.    Distribution:
  9.    ------------
  10.    
  11.    SFHEADER is being distributed through the shareware concept.  You 
  12.    may use SFHEADER for an Evaluation period of 30 days.  If at that 
  13.    time you decide you want it, please take the time to register it.
  14.    You may distribute as many copies of SFHEADER as you wish, as long
  15.    as the programs within the archive are not modified in any way.
  16.    The latest version of SFHEADER as well as SPITFIRE and other
  17.    SPITFIRE Utilities can always be downloaded from :
  18.  
  19.                          The Hawaiian Hawke BBS
  20.                               (602)272-4887
  21.                              1200-19200 Baud
  22.                           USR HST Courier 14400
  23.  
  24.    Disclaimer:
  25.    ----------
  26.  
  27.    The Authors of this program, and/or Hawke Software Systems shall
  28.    in no way be held responsible for any damage incurred while operating
  29.    SFHEADER.  All responsibility lies with the user of the software.
  30.  
  31.  
  32.    Purpose:
  33.    -------
  34.  
  35.    This program was created  for the purpose of making File 
  36.    area headers which includes the information of how many files
  37.    are contained within a particular directory, along with a byte count,
  38.    and Date the listing was last updated by the sysop.  Sfheader now
  39.    offers the capability to Generate FILST<xxx>.BBS/.CLR screens in the
  40.    Unregistered Version.  This software has been designed to work with
  41.    The SPITFIRE Bulletin Board System.
  42.  
  43.    Spitfire is written by Mike Woltz, Buffalo Creek Software.  
  44.    It is an Excellent BBS package that I would recommend to 
  45.    anyone.    
  46.  
  47.  
  48.    Usage:
  49.    -----
  50.  
  51.    This program can be run from your any directory which is in your path, 
  52.    assuming that your SFPATH environment is set.  If you do not have this
  53.    environment set, all you need to do is add the following command line
  54.    to your autoexec.bat file:
  55.  
  56.                          SET SFPATH=C:\SF
  57.  
  58.    I used c:\sf for the directory in the example, but obviously, it should
  59.    be set for your particular system's configuration.  If you do not wish to
  60.    add this statement to your autoexec.bat file,  then the program WILL have
  61.    to be run from the Spitfire system directory.  The 10, 20, and 999 after the
  62.    word SFHEADER below signifies the Different Security Levels that can be
  63.    used on the command line to generate the FILST<xxx>.BBS/CLR Screens.  For
  64.    Example SFHEADER 10 20 999  would generate FILST screens for Level 10, 20,
  65.    and 999.  If you do not want these screens to be generated, simply leave 
  66.    these Parameters out.
  67.  
  68.    To test run SFHEADER, assuming the environment is NOT set, place SFHEADER
  69.    in your SF system directory.  Then simply type
  70.  
  71.                     SFHEADER.exe 10 20 999
  72.     
  73.    If the SFPATH has been set in your autoexec.bat file, then just copy
  74.    SFHEADER to any directory that is in your path, and then type SFHEADER,
  75.    and after seeing a brief opening screen, all of your SPITFIRE Area
  76.    Directory files (SFFiles.BBS) will be read, and a new header will
  77.    preface each such file listing with the following information:
  78.  
  79. ╒═════════════════════════════════════════════════════════════════════════════╕
  80. │                   Area 9 ─ Spitfire BBS & Utilities                         │
  81. │  Total Files: 539                                   Total Bytes: 9,880,721  │
  82. │                                                                             │3
  83. │                The Hawaiian Hawke BBS - Home of SF-Header !!                │4
  84. │                                                                             │5
  85. │  *** SF-Header v.2.06 ***                    Registered to: Russell Mikami  │
  86. ╞═════════════════════════════════════════════════════════════════════════════╡
  87. │  Filename     Size      Date    Description        Last Updated: 2/23/1992  │
  88. ╘═════════════════════════════════════════════════════════════════════════════╛
  89.  
  90. **** NOTE ****
  91.  
  92.  
  93.   SF-HEADER now will support up to 1000 files per area (Pertains to Both
  94.   registered, and unregistered versions), will also NOT make backups 
  95.   of your sffiles.bbs if this is what you wish, and the REGISTERED Version
  96.   now gives the Sysop 3 lines to configure as they wish.   The 3 lines that
  97.   are configurable are marked as 3,4,5 above to the right of the box.
  98.   
  99.   You MUST run SFHDRCFG.exe  to create your "Customized" header config file.
  100.   The Unregistered Version will not allow the configurability that the 
  101.   registered version has.  Also, The SFHEADER program can be run from ANY 
  102.   AREA in your path, as long as the SFPATH variable is set.   Also, be sure
  103.   that your newly created SFHEADER.CFG file is in the same dir as your
  104.   sfheader.exe program, or it will not work properly.
  105.  
  106.  
  107. ****  The above paragraph pertains to registered versions only. ****
  108.  
  109.  
  110.  
  111.    That's all there is to it.  The program will not process any 
  112.    file areas that do not contain an sffiles.bbs file listing.  
  113.    The original sffiles.bbs listing will be renamed to 
  114.    sffiles.bak, and the newly created sffiles.bbs created by 
  115.    SFHEADER will be your new listing.  When totaling files in the 
  116.    directory, this program WILL NOT count the sffiles.bbs & .bak 
  117.    in its total, nor will it count its byte size.
  118.  
  119.    This program can best be utilized by running it from a batch file,
  120.    which might look something like this:
  121.  
  122.                     c:
  123.                     cd\sf
  124.                     sfheader.exe  10 20 50 999
  125.                     goto loop
  126.   
  127. ** NOTE **
  128.  
  129.    The Filst<xxx>.bbs screens are Generated by adding the security Levels
  130.    to the command line.  This feature is fully operational in  the 
  131.    Unregistered version.  Sfheader will put the  FILST<xxx> screens in 
  132.    your display directory that you have configured in Spitfire.
  133.  
  134. ** END OF NOTE **
  135.  
  136.    This example is assuming that the program is registered, and 
  137.    running as an event.  With the UNREGISTERED version, there is a short
  138.    delay, requiring the input of a carriage return to initiate
  139.    operation.
  140.  
  141.  
  142.     ********   REMEMBER   ******** 
  143.  
  144.     There must be an existing sffiles.bbs in the directory being 
  145.     processed or the area will not be affected by SFHEADER.    
  146.    
  147.     If you have any comments, problems, or questions about this 
  148.     program, I can be reached by Crash Mail, through the Third
  149.     party Authors/Doors Conference in Circuit-Net, or send 
  150.     Echomail through the ICN Spitfire Support Conference, or 
  151.     of course you can call The Hawaiian Hawke BBS for Support.
  152.  
  153.  
  154.     REGISTRATION INFORMATION:
  155.  
  156.     A $10 registration fee includes:
  157.  
  158.     A specially compiled copy for you of SFHEADER which may either be:
  159.  
  160.      1)  Downloaded directly from the Hawaiian Hawke BBS, or
  161.  
  162.      2)  if you request it, we will upload a registered copy to your BBS.
  163.          This requires that you set up an account for Russell Mikami.  A
  164.          password should be specified on the registration form. If your
  165.          system supports CRASH-MAIL, we will send you your registered copy
  166.          through your Front End Mailer. Just supply us with a valid
  167.          address from either FIDO, 4x4 NET, or ICN, and we will send
  168.          your registered copy after receiving your payment.
  169.          International orders should include an additional $2.00 if you
  170.          would like SF-HEADER to be uploaded directly to your BBS.
  171.          QUICK LOGON would greatly speed things up when logging on.
  172.  
  173.      
  174.      3)  Voice Support also, if needed for Registered Users of SFHEADER.
  175.  
  176.     All future upgrades can be downloaded from The Support Board, The
  177.     Hawaiian Hawke BBS at (602) 272-4887.  At this time, I see no need 
  178.     to charge for upgrades, so therefore, they are free, except for the
  179.     time you will take to download it.
  180.  
  181.     For any special situations not covered here, I suggest trying to
  182.     reach me thru one of the following Net addresses.
  183.  
  184.     FIDO Netmail Address  -  1:114/67     
  185.     ICN  Netmail Address  -  91:602/18 or 91:602/100
  186.     4x4  Netmail Address  -  44:7201/2 or 44:7201/200
  187.  
  188.     I can also be routed a message at Node # 602000 Via Any Sysop 
  189.     Level Circuit-Net Conference, to include the Third party 
  190.     Author's conference. Inquiries via Postal Service mail will
  191.     also be accepted.
  192.  
  193.     If you like this program and would like to register it, Please send
  194.     Check or Money Order with a filled out copy of register.doc 
  195.     to:
  196.  
  197.            Russell Mikami
  198.            The Hawaiian Hawke BBS
  199.            3022 W. Almeria Road
  200.            Phoenix, Az 85009
  201.