home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_mail / farea10.arj / FIXAREAS.DOC next >
Text File  |  1991-01-22  |  4KB  |  88 lines
  1.  
  2.     
  3.     FIXAREAS.EXE Program Documentation
  4.     
  5.     Copyright (c)1990 - Tom Beattie, FidoNet 1:104/522
  6.     
  7.     First off, use this program at your own risk.  I do not retain any
  8.     liability for anything that happens because of it's use... with the
  9.     exception that it works as promised and that you might possibly see fit
  10.     to register the program.  Registration is $10US and may be mailed to 
  11.     the address close to the end of this document.
  12.     
  13.     Now, on to the good stuff!
  14.     
  15.     Earlier this evening, I found that one of my utilities (ECHOLINK.EXE
  16.     for D'Bridge msg*.bbs linking) wasn't working properly and started
  17.     investigating the problem.  Well, lo and behold after a couple of hours
  18.     staring at my monitor, I found that the AREAS.BBS file that Echolink
  19.     was looking at was not in the proper format!  QLink.EXE helped me out
  20.     with that conclusion cause it wouldn't run either!  This AREAS.BBS file
  21.     was created by a really nice new utility (I won't mention any names
  22.     here) that helps out a *LOT* with the editing of the Remote Access
  23.     Message and File Areas.
  24.     
  25.     After I got about halfway through the code for this FIXAREAS utility, I
  26.     thought to myself, "Wow!, maybe someone else might be able to use this
  27.     seeing as how as long as you keep with the proper order when creating
  28.     an AREAS.BBS, you can then run FIXAREAS.EXE and it will read your file,
  29.     sort it, and then write it back out in the proper format for all the
  30.     utilities that use it!"
  31.     
  32.     Well, Here it is! FIXAREAS.EXE!
  33.     
  34.     You will have to do 2 things to make it work.
  35.     
  36.     1. Place FIXAREAS.EXE somewhere in your path.
  37.     
  38.     2. In each of the directories that you have an existing AREAS.BBS,
  39.     create a file called AREAS.HDR that contains two lines of information.
  40.     The first line is the name of your BBS, i.e. Rocky Mountain Wildcat 
  41.     followed by a carriage return.  The second line is Your Name, assuming
  42.     you are the SYSOP of course! i.e. Tom Beattie followed by a carriage
  43.     return.
  44.     
  45.     THAT'S IT to the configuration anyway.
  46.     
  47.     Now, go to the directory that contains your AREAS.BBS and AREAS.HDR
  48.     files and type FIXAREAS.
  49.     
  50.     FixAreas will then read the AREAS.BBS and AREAS.HDR files, sort the
  51.     area information by area number, then write out a new AREAS.BBS file
  52.     with the proper format.
  53.     
  54.     When creating or modifying your AREAS.BBS, having FIXAREAS.EXE on hand
  55.     greatly simplifies your editing. You no longer have to worry about the
  56.     spacing. Just enter the information in the proper order, i.e. Board# or
  57.     path, EchoTag, Nodes to Forward To, all seperated by one or more spaces,
  58.     run FIXAREAS and voila! You have a new AREAS.BBS file in the proper format.
  59.     
  60.     NOTE:  If any line in the original AREAS.BBS file is more than 256
  61.     characters, it will be truncated at that point. I am currently working
  62.     on a fix for this and anyone that registers FIXAREAS between now and
  63.     then will receive a fresh copy when it is available.
  64.     
  65.     I have tried to think of all the possible combinations of AREAS.BBS
  66.     files but as a good friend of mine always says, "There's always at
  67.     least one more batchfile." So, if you do have any problems with
  68.     FIXAREAS.EXE, netmail me at 1:104/522 with a message explaining your
  69.     problem and file attach a copy of your AREAS.BBS so I can test it out.
  70.     
  71.     THANKS! Hope you like it!
  72.     
  73.     Tom Beattie
  74.     c/o KHOW/KSYY Radio
  75.     8975 E. Kenyon Ave.
  76.     Denver, CO 80237
  77.     
  78.     CHANGES/MODIFICATIONS
  79.     
  80.     1/22/91 - Added Support for Fido Style AREAS.BBS.  Also, the registered
  81.     version will now create an alphabetical list of echotags for use with
  82.     AREAFIX.  Say, if you get in a new AREAS.BBS type file from your STAR,
  83.     you can run FIXAREAS to create the list of available Echos from your
  84.     STAR.  
  85.     Also, added some commandline parameters which are all optional. Type
  86.     FIXAREAS ? at the DOS prompt for a help screen.
  87.     
  88.