home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FC102B.ZIP / INSTALL.DOC < prev    next >
Encoding:
Text File  |  1993-01-03  |  6.7 KB  |  155 lines
  1.                        FastChat Installation Documentation
  2.                                   Version 1.02/b
  3.  
  4.                               (c) 1993 Peter Hebert
  5.  
  6.      Purpose
  7.      ───────
  8.  
  9.      This documentation serves only briefly explain the physical aspects
  10.      of installing FastChat.  Directions for setting it up with your BBS
  11.      software are found in FASTCHAT.DOC, under the subtitle
  12.      "Installation".  You should carefully read this document before
  13.      running FC_INST.
  14.  
  15.      Documentation
  16.      ─────────────
  17.  
  18.      If you wish to read the documentation prior to installation, it is
  19.      present as the file FASTCHAT.DOC.  This is a standard ASCII text
  20.      file that you can view with your favorite text file viewer.
  21.  
  22.      If you have either an Epson-compatible dot matrix printer or an HP
  23.      PCL4 or higher compatible laser printer, and you wish to print the
  24.      documentation, use the included DocUtil utility.  It allows you to
  25.      print either parts or all of the documentation, preserving
  26.      attributes such as bold and underline to enhance its appearance.
  27.  
  28.      Installation
  29.      ────────────
  30.  
  31.      FastChat comes in a smart "installation bundle", which is kind of
  32.      like a self-extracting archive.  This allows it to selectively
  33.      install only the parts of itself appropriate to your setup.  This
  34.      also provides a level of security, because only I have the software
  35.      that makes a bundle, and all the files in the bundle are encrypted
  36.      to prevent tampering.
  37.  
  38.      FastChat must be installed in a directory of its own, most likely
  39.      "FC" under your current main BBS directory (i.e. C:\MAX\FC).  If
  40.      you extracted these files to your main BBS directory, you can move
  41.      them by typing "FCMOVETO dirname" (FCMoveTo is a batch file that
  42.      should have come with your archive).
  43.  
  44.      Once you have the FastChat files in their proper directory, you can
  45.      run FC_INST to extract FastChat.  The first question it asks you is
  46.      a directory confirmation; hit "Y" to confirm your directory choice.
  47.      The next question asks you which version of FastChat you wish to
  48.      install.  Your choices are:
  49.  
  50.      ┌──────────────────────────────────────────────────────────────────┐
  51.      │         Please select the version of FastChat to install         │
  52.      ├───┬────────────────────────────┬───┬─────────────────────────────┤
  53.      │ 1 │ Maximus                    │ 3 │ EzyCom                      │
  54.      │ 2 │ RemoteAccess               │ 4 │ Generic: DORINFO.DEF        │
  55.      └───┴────────────────────────────┴───┴─────────────────────────────┘
  56.  
  57.      If your BBS software is not listed, you have two choices:
  58.  
  59.         a)  Select one of the Generic options, if your BBS software can
  60.             create that kind of drop file.
  61.  
  62.         b)  Select a BBS software with which your BBS software makes
  63.             100% (or 99%, anyway) compatible binary drop files (ie: one
  64.             of the unlisted Hudson clones might pick RemoteAccess or
  65.             QuickBBS)
  66.  
  67.      It is in most cases a ten minute procedure for me to add support
  68.      for another BBS software, so if you can provide me with Pascal (or
  69.      even C, though that takes longer) structures, I will happily make
  70.      you a loader for your BBS software.
  71.  
  72.      After selecting your BBS software, the appropriate FastChat files
  73.      for your BBS system will be extracted.
  74.  
  75.      After extraction of the main files, you will be asked if you wish
  76.      to extract the interfaces for the other BBS softwares FastChat
  77.      supports.  Do this only if you plan to switch in the near future,
  78.      or if your BBS software was not listed and you may need to try the
  79.      interface for another.
  80.  
  81.      Environment variables
  82.      ─────────────────────
  83.  
  84.      You must set up an environment variable for FastChat, so that it
  85.      can find itself and its configuration files.  You should enter into
  86.      your AUTOEXEC.BAT either SET FC=dir or SET FASTCHAT=dir (the former
  87.      one preferred).
  88.  
  89.      There is no need to add FastChat to your PATH statement.
  90.  
  91.      Directory structure
  92.      ───────────────────
  93.  
  94.      After installation, FastChat will be laid out like this:
  95.  
  96.      FC
  97.       ├─ UTIL
  98.       ├─ DOCS
  99.       ├─ LANG
  100.       ├─ TEXT (or SAMPTEXT)
  101.       └─ OTHERBBS
  102.  
  103.      FC holds all main executables (FastChat, its loader, and its
  104.      configuration program) and all configuration files.  This directory
  105.      is the directory that you installed FastChat into.
  106.  
  107.      UTIL holds all add-on utilities (the user editor, attribute editor,
  108.      etc.)  It also holds FC-TSR, which is described in the
  109.      documentation.
  110.  
  111.      DOCS holds all documentation files, including DocUtil, the printing
  112.      utility.
  113.  
  114.      LANG holds all language related files, including the sample
  115.      languages that come with FastChat and the language compiler, LNG2L.
  116.  
  117.      TEXT holds all of FastChat's text files.  With some BBS softwares,
  118.      you may want to mix this in with your regular text files; in this
  119.      case, the directory is called SAMPTEXT.  The naming conventions for
  120.      the files follow the RA style (*.A??, base names reflect the ones
  121.      used in RA).
  122.  
  123.      OTHERBBS holds all of FastChat's loaders, if you elected to install
  124.      them.  Also included are any BBS-specific utilities, such as user
  125.      editors, and the appropriate sample FASTVIEW.CFG file for each
  126.      software.
  127.  
  128.      Installing loaders
  129.      ──────────────────
  130.  
  131.      Unfortunately, telling FastChat what BBS software you are using is
  132.      not as simple as setting an option in FCConfig.  In order to
  133.      provide maximum compatibility with each software that FastChat
  134.      supports, and to keep the size of FastChat's .EXE file reasonable,
  135.      I have opted to isolate the BBS-specific portion of FastChat in a
  136.      file, called a loader.
  137.  
  138.      Each loader translates your BBS system's drop file into something
  139.      FastChat can understand.  It also tells FastChat how to draw the
  140.      user information window.  Since you can delete the loaders for the
  141.      BBS software you don't run (the FastChat installation bundle
  142.      doesn't install them unless you ask it to), you save disk space,
  143.      too.
  144.  
  145.      If you're going to switch software... it's as simple as finding the
  146.      correct loader and renaming it to FASTCHAT.EXE (in the main
  147.      FastChat directory).  In some cases, a user editor is provided as
  148.      well (FCUERA.EXE is for RA, for example).  Rename this to
  149.      FCUSERED.EXE in the UTIL directory.
  150.  
  151.      Please note that your FastChat command line may vary slightly for
  152.      various BBS softwares.  For more information, see the Invocation
  153.      section in the FastChat documentation.
  154.  
  155.