misc/DOCS/INFUSION.DOX

13 KB ccd0bfe97f96d561…









 Infusion Bulletin Board Software - Main Documentation for Version 1.0a10pre
          (c)copyright Grant Passmore (skaboy101) / idt 1997-98










 %%(contents)%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 Section I   - (Registration and Features)
  ■ A - (Basic Infusion Features)
  ■ B - (Registering Infusion)
  ■ C - (Further Support)

 Section II  - (Installation and Initial Setup)
  ■ A - (Minimal System Requirements)
  ■ B - (Basic Installation Process)
  ■ C - (System Initialization)
  
 Section III - (Configuring Your System)
  ■ A - (Using the Setup Program)
  ■ B - (Using the Menueditor)
  ■ C - (Using the Usereditor)
  ■ D - (Using the Menuset Editor)
  ■ E - (Using the Language Compiler)
  ■ F - (Using the Data-Area Editor)
  ■ G - (Using Menu Script Compiler)
  ■ H - (Using Menu Script De-Compiler)

 ■≡ Section One  - (Registration and Features) ≡■    
  |                                            |
 %%(section I  - A/Basic Infusion Features)%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 Infusion even in this pre-release, contains MANY great and powerful
 features, some often not found in other systems.  These include ::

        ■ Fossil driven communications upto 115200 bps
        ■ Multinode (upto 255 nodes under a multitasker)
        ■ Internal Teleconference with actions, Instant Messages, etc.
        ■ 100% Configurable Menus, with POWERFUL menu editor
        ■ Menu Command Stacking
        ■ Menu scripting with compiler AND decompiler
        ■ Over 300 configurable display strings
        ■ Data-areas, similar to OBV's but better
        ■ Multiple languages, with language compiler
        ■ Ascii,Ansi,Avatar, & Ansi/2 local emulation support (FAST parser)
        ■ Multiple menusets, each with their own acs level requirements
        ■ Interactive Generic Menu Generation
        ■ Support for local ADF emulation (binary pallete/font changes)
        ■ Support for upto 50 external file transfer protocols
        ■ Built in Netmodem/32 (tm) Integration for inbound telnet
        ■ Internet Gateway (TelGate) for semmingly internal telnet support
        ■ Powerful Usereditor with Configurable ACS levels
        ■ Fido-style *.MSG message base format support
        ■ Configurable File_ID.Diz Length Display (upto 20 lines)
        ■ ACiD'S SAUCE commenting --> File_ID.Diz extraction
        ■ Configurable WFC, with outbound faxing capabilites
        ■ Door.sys, DorinfoX.def, Tribbs.sys, Pcboard.dat, & Infudoor.sys
          drop file support
        ■ Powerful & handy local sysop console while user is online
        ■ Editable pc-speaker/adlib chat pagers
        ■ Dropin ICL (infusion coding language) - (next release, 75% done)
        ■ And many, many more!

 %%(section I  - B/Registering Infusion)%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 Infusion Bulletin Board System is shareware software.  This means that you
 are allowed to 'try' or evaluate the software before you choose to purchase
 a site license.  Infusion is has an extremely LOW registration price, and
 it is worth well more than it.  $20 (Twenty US Dollars) is the cost for
 running Infusion, and it grants you the following ::

        ■ All Unregistered delays and notices are removed
        ■ iDt Technical support, and direct author support
        ■ All future private releases (NON-PUBLIC) are sent to you
        ■ All future public releases are sent to you
        ■ You help expand the development of Infusion

 Registering Infusion is fast and easy.  Simply run REGISTER.EXE and follow
 the instructions given there.  The application will prompt you for questions
 pertaining to your system, and status as a sysop, and then a binary file
 containg your information will be created.  From that your two keyfiles will
 be derived and sent to you.

 Just a note, Infusion cracks DO NOT work.  I/we are not responsible in any
 way to damages to your system, etc.  Infusion keys are created in a unique
 manner which keeps them from being distributed.  If you attempt to run Infusion
 with an illegally distributed, or generated key file, the results can be
 catastrophic, and Infusion will fail to function from then on out.

 %%(section I  - C/Further Support)%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 Although you are required to register Infusion, technical support will still
 be given to those who are evaluating the software as often as possible. All
 iDt (Infusion Development Team) members are available for technical support,
 as well as me.  If you have a bug report, comment, feature you would like
 added, etc please dont hesitate to contact us.  You can go about this in
 the following manners ::

 Whenever you are reporting a bug, posting a comment, etc you must run the
 IdtNote.exe program.  This application generates a file that can be attatched
 to email, Dcc'd over irc, and is available on our web page that is used by
 all Idt member and organized with our IdtRead program.  This allows us to
 very easily exchange bugs, feature requests, etc in a manner that is similar
 to a message network.  This lets us fix bugs FASTER and more efficently.
 These files can be sent to the Idt support team, as well as an iDt member.
 Here are the addresses for main support team ::

        ■ Skaboy101 (Grant Passmore) - skaboy101@mindless.com
        ■ Mrplastik (Matt Frietag) - mrplastik@main.com
        ■ Raekwon (Your Name) - youraddy@bitchx.org
         
        ■ You can also DCC on efnet/irc - #InfusionBBS
                                          #Ansipunx


 ---->(SnIp)<----


 ■≡ Section Two  - (System Requirements and Initialization) ≡■
  |                                                         |
 %%(section II - A/Minimal System Requirements)%%%%%%%%%%%%%%%%%%%%%%%%%%%

 In order for you to run Infusion, your system needs to equal or surpass the
 following ::

        ■ FOSSIL communications driver (ADF/Winfossil)
        ■ Netmodem/32 for telnet (distibuted with Infusion)
        ■ 386+ (an intel 386 or higher processor)
        ■ XMS/EMS (infusion utilized eXtended memory for its overlay)
        ■ At least 2 mb free diskspace for system files
        ■ At least 20-30 mb for file bases (can be anything, good standard)
        ■ 9600 bps or higher modem (you must be SICK)
        ■ Dos 3.3 or higher for single node system
        ■ Microsoft Windows or equivalent multitasker for multinode usage
        ■ Microsoft Windows '95 or higher for inbound telnet

 These few items should be considered MINIMUMS, and if you plan on running a
 bbs with just these, i hope you have great art support =)

 %%(section II - B/Basic Installation Process)%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 Installing Infusion is both fast and easy.  This alpha is packaged with an
 instalation program, so there is no 'work' that needs to be done by you.

 To Install Infusion ::
        ■ Run INSTALL.EXE from the Infusion root directory
        ■ Select 'INSTALL INFUSION' from the command screen
        
 You will now be confronted with a selection screen, prompting you for basic
 information pertaining to your system.  The first section is data pertaining
 to your site license.

        ■ System Name                - This is your BBS name
        ■ Sysop Handle               - Sysop's Username
        ■ System Location            - The location (ie 'Infusion Whq')
        ■ System Acronym             - 3 charachter BBS Abreviation

 Once those have been filled out, the following section pertains to your path-
 names and directories.

        ■ Main Infusion Dir          - Root Infusion directory
        ■ Data Dir                   - All main data binary's are here
        ■ Msgs Dir                   - The message base directory
        ■ Menu Dir                   - The menu binary directory
        ■ Screens Dir                - The directory containing wfc, etc
        ■ Upload Dir                 - The work/upload directory
        ■ Extract Dir                - Temporary directory
        ■ Boards Dir                 - Subboard directory
        ■ Text Dir                   - Ansi/Avatar/Ansi2 display files direc.
        ■ Doors Dir                  - Where doors are held

 Those are the basic system directories.  Once you have filled them in with
 the correct information press F10 and the installation process will begin.
 If your installation was succesfull then you should be returned to the DOS
 prompt with an ansi saying 'Infusion Installation Complete!'.  Congratulations.

 %%(section III - C/System Initialization)%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 Although Infusion's installation program creates most of the default config
 files for your system, there are still a few things that need to be done.
 First off, you must compile your default language.

 Infusion's languages are very similar to string data files, but allow the
 user to select a different 'language' without altering the current menuset.
 To compile the default language, and init the string file type the following ::

 C:\INFUSION>I_LANGX LANGUAGE.1

 ■ The default langugage is now compiled.  

 Now you must configure the modem.  Run

 C:\INFUSION>SETUP.EXE INFUSION.DAT

 <- and go into 'MODEM/Node CONFIGURATION'.  Enter the port corresponding to
 your Fossil driver, and then exit with saving changes (F10), else changes are
 aborted.

 ■ You are ready to go

 Infusion should now be succesfully initiated, and can be executed by typing

 C:\INFUSION>BBS.BAT


 ---->(SnIp)<----


 ■≡ Section Three  - (Configuring Your System) ≡■
  |                                            |
 %%(section III - A/Using the Setup Program)%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 Infusion's core configuration revolves around ONE single datafile.  This is
 a dynamic filename (depending one node) but it is edited with the SETUP
 program.  This gives the sysop an easy to use interface for editing config
 options while a user is online, very efficiently.

 In this sub-section we will go over EVERY configuration option available in
 this version, so this might get a little lengthy (=[).

 You will first be faced with a main selection screen, similar to this one ::

 /-------------------------------------->
 |  Basic System Information (i)
 |  Basic System Information (ii)
 |  Infusion Directories
 |  Modem/Node Configuration
 |  Telnet Configuration
 |  Information Forms (infoforms)
 |  Access Variables (ACS)
 |  System Passwords
 |  New user access / NUV
 |  File area configuration
 |  System Colors
 |  External File Transfer Protocols
 |  External Door Configuration
 |  Message Conferences
 |  File Conferences
 |  Text file Archives
 |  (Q)uit/Ctrl-Z
 \-------------------------------------->

 Select your option of choice, and edit from there.  Now we will cover each
 and every configuration option in alpha 10pre.

 ■-->Basic System Information (i)

     This is the initial system information config setup.  If you select it,
     you will be faced with a screen similar to this ::

     /------------------------>
     | ■ Basic System Information (i)
     |
     | System Name              ; BBS Name, as supplied in Install
     | Sysop Handle             ; Your handle/username
     | Co-Sysop Handle          ; Co-sysop's handle (no limit)
     | System Phone Number      ; Your Bbs' phone number (current node)
     | System Location          ; Location as displayed to users
     | Registration Code One    ; Regcode #1
     | Registration Code Two    ; Regcode #2
     | Node Number              ; Current node number, linked to node/modem
     | Cd-rom Drive(s)          ; CDrom drives (ie D, not D:) or (DE, not D:E:)
     \------------------------>

 ■-->Basic System Information (ii)

    This contains many options, some that could be classified as miscellaneous.
    When you select it, the screen will look like this ::

    /------------------------->
    | System Acronym           ; 3 character BBS abreviation (|SA)
    | Use lightbar matrix      ; Do you want a logon matrix/shuttle ? (YES)
    | Total number of matrixes ; Total number of matrixes to rotate (MATRIX.1,etc)
    | Default WFC Screen       ; Wfc to load from screens dir (wfc.1,.2,etc)
    | Use direct screen writes ; Should be NO if under multitasker
    | Use EMS/XMS              ; Should be YES or infusion will crash
    | Swap mem for dosshell    ; Do you want to swap memory during shell?
    | Force local sysop login  ; Similar to telegard's (F)AST option
    | Minutes until screensave ; Minutes to wait before saving screen (blank)
    | Is this a closed system  ; NO if you wanto accept new users
    | Chat cost to user        ; Filepoints deducted for chat page
    | Allow chat time start    ; Starting time for chat pages (ie 5:00 pm)
    | Allow chat time end      ; Ending time for chat pages (ie 9:00 pm)
    | Make noise on chat page  ; Do you want to use a custom chat pager?
    \------------------------->

 ■-->Infusion Directories

    /------------------------->
    |
    |
    |
    |
    |
    |
    |
    |