home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBSUTIL1 / CVT2QB11.ZIP / ADDFILE.DOC next >
Text File  |  1993-04-07  |  7KB  |  171 lines
  1.  
  2.  
  3.           █████╗  ██████╗  ██████╗  ███████╗ ██╗ ██╗      ███████╗
  4.          ██╔══██╗ ██╔══██╗ ██╔══██╗ ██╔════╝ ██║ ██║      ██╔════╝
  5.          ███████║ ██║  ██║ ██║  ██║ █████╗   ██║ ██║      █████╗
  6.          ██╔══██║ ██║  ██║ ██║  ██║ ██╔══╝   ██║ ██║      ██╔══╝
  7.          ██║  ██║ ██████╔╝ ██████╔╝ ██║      ██║ ███████╗ ███████╗
  8.          ╚═╝  ╚═╝ ╚═════╝  ╚═════╝  ╚═╝      ╚═╝ ╚══════╝ ╚══════╝
  9.  
  10.  
  11.  
  12.                ╒═════════════════════════════════════════════╕
  13.                │                                             │░░
  14.                │  T H E  F I L E S . B B S  T O  * . D I R   │ ░
  15.                │                                             │ ░
  16.                │      C O N V E R S I O N  U T I L I T Y     │ ░
  17.                │                                             │ ░
  18.                ╘═════════════════════════════════════════════╛ ░
  19.                     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  20.  
  21.  
  22.  
  23.  
  24.  
  25. Acknowledgements
  26. ~~~~~~~~~~~~~~~~
  27.     Thanks got to the TAG team for providing the structure information
  28.     necessary for utility authors to create the utilities that *we* all
  29.     ask for. Thanks especially to Victor Capton and Paul Williams, not only
  30.     for remaining the driving forces behind this special BBS system, but also
  31.     for giving insight  into  TAG's  inner  workings  making this and other
  32.     projects soooooooo much easier to handle.
  33.  
  34.     TAG is copyrighted By The T.A.G. Team
  35.     QuickBbbs (referred to as QBBS) is Copyrighted By Pegasus Software
  36.  
  37.     This program is  copyrighted  by  Rick  Cooper  and  remains  the  sole
  38.     property  of  same.  CVT2QBBS  is  NOT public domain, rather it's to be
  39.     considered freeware.
  40.  
  41. Guarantees/Warranties/And Other Fantasies
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43.     There is no warranty or guarantee offered with this program. The only
  44.     thing I will guarantee is it's ability to take up disk space.
  45.  
  46.     By using this program  you  agree  to  hold  harmless the author in all
  47.     regards and circumstance including but not limited to:
  48.  
  49.         Damage to drives
  50.         Damage to Date
  51.         Loss of income
  52.         Increased Sexual Awareness
  53.         Change of Gender or Species
  54.  
  55.  
  56. Purpose
  57. ~~~~~~~
  58.     The main purpose for this program is to add files to TAG that are found
  59.     within a QBBS area  list  file  that  actually  exist within the proper
  60.     directory. Now that sounds a  bit  confusing.  so  let's  look  at  the
  61.     operation  of  both  TAG  and  ADDFILE.EXE  and  see why I used such an
  62.     ambiguous description.
  63.  
  64. Operation
  65. ~~~~~~~~~
  66.     ADDFILE will look in your download  (usually) directory for a QBBS list
  67.     file and a .DIR list file.. Check each name within the  two  and  if  a
  68.     name  is  found in the QBBS list file that is not in the TAG .DIR file,
  69.     and the file  actually  exists  in  the  download (usually) directory..
  70.     ADDFILE will add the file to your TAG System.
  71.  
  72.     The new file scan date will be set  to  the  current  date,  the  owner
  73.     (up-loader  will  be set to the board Sysop's Name) and the Blocks (size
  74.     kinda) will be set to the actual number per the actual file size.
  75.  
  76.     First let's look at the TAG  *.DIR file placement depending upon upload
  77.     directory and Cd-Rom status.
  78.  
  79.     Normally TAG  will  allow  you  to  enter  a  base  name  (first  eight
  80.     characters)  of your own choosing for each different list (*.DIR) file.
  81.     But if your upload  path  is  different  than your download path, which
  82.     should always be the case with Cd-Roms, then TAG will force you to  use
  83.     the name FILES as the .DIR name.
  84.  
  85.         Normal Setup
  86.         ############
  87.  
  88.         File Name       FILE1
  89.         Upload Path     C:\BBS\FILE1
  90.         Download Path   C:\BBS\FILE1
  91.  
  92.         Alternate Setup
  93.         ###############
  94.  
  95.         File Name       FILES
  96.         Upload Path     C:\UPLOADS
  97.         Download Path   C:\FILE1
  98.  
  99.         In Each of these  examples  the  listing  file (either FILE1.DIR or
  100.         FILES.DIR) will reside in the download directory... Now if you  have  a
  101.         CD-ROM then your  listing  file  can't  be  written in the download
  102.         directory (since it's a CD-ROM) so where does it go?
  103.  
  104.         That depends on where you want it. If you  preface  the  FILE  NAME
  105.         (.DIR name) with one of three special characters TAG will keep your
  106.         list file elsewhere depending on the character:
  107.  
  108.         '@'    : .DIR File Location := GFILES Directory
  109.         '+'    : .DIR File Location := AFILES Directory
  110.         '`'    : .DIR File Location := MULTI Directory
  111.  
  112.         (NOTE:  if  you  are  running multiple nodes you should use the
  113.         '`' character so it's available from all nodes)
  114.  
  115.  
  116.  
  117.         Now when you use the program CVT2QBBS (Or TAG2QBBS, Or TAG2XPR), to
  118.         create your QBBS listing  files  these characters will be respected
  119.         and special naming conventions will be used. Since there  could  be
  120.         hundreds  of  listing  files in any of these directories if you are
  121.         using a CD-ROM drive, the  alternate  listing file will have a name
  122.         of (FB+Area Number). This means that if your file area number 0  is
  123.         a  CD-ROM  and it's list file name is `FILE1 then ADDFILE will look
  124.         for a list file named FB0.BBS  in your Multi directory along with a
  125.         TAG list file named FILE1.DIR in that same directory.
  126.  
  127.         It's also important to note that if you have a new  CD-ROM  with  a
  128.         area listing file in the format of (or close to)
  129.  
  130.             FILENAME.EXT Description......................................
  131.  
  132.         And you copy it into the same directory that the TAG area list file
  133.         uses,  and  you  name  it  as  above  (AREA  1  := FB1.BBS AREA2 :=
  134.         FB2.BBS, Etc) ADDFILE will add your  new  Cd-Rom to TAG for you as
  135.         well. When an area is setup  with  the  Cd-Rom  Flag  set  to  yes,
  136.         ADDFILE will check First the upload area and then the download area
  137.         for  the file that is in the listing. If it finds it in either area
  138.         it is added to the TAG listing.
  139.  
  140.         What all this means  is  that  used  in  conjunction with the other
  141.         utilities  in  the  CVT2QBBS  utility  package,  you  can  now  run
  142.         virtually any QBBS V2.75+ file door... I would recommend ACFILES as
  143.         it allows everything that TAG does and more.. Point and Shoot  file
  144.         tagging,  Extended descriptions, global operations, it's simply the
  145.         best file system I have ever found.
  146.  
  147. Setup
  148. ~~~~~
  149.  
  150.         Isn't any! Just unzip the program  anywhere in your path and run it
  151.         with the following command line:
  152.  
  153.                 ADDFILE BBSDir
  154.  
  155.         Where BBSDir := The TAG node directory that  contains  Status.Dat..
  156.         If  you are multi-node and sharing file areas you will only have to
  157.         run the program for a  single  node,  If  you do NOT share all file
  158.         areas then you will have to run the  program  for  each  node  with
  159.         separate file areas.
  160.  
  161.  
  162. If there is a problem
  163. ~~~~~~~~~~~~~~~~~~~~~
  164.  
  165.     I can be contacted via the TAGBETA, TAG, TAGDOORS echos or you can call
  166.     my BBS (Just For The Heck Of  It  II) at (219) 747-5971.. Or netmail me
  167.     at 1:236/16 @FidoNet
  168.  
  169.     Rick Cooper
  170.  
  171.