                    Ŀ 
                       C H A T   W I T H   L I S A   
                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~   
                               Version 1.6           
                                                     
                       Copyright 1995 by Mike Fox    
                                                     
                                  *****              
                                                     
                       ChAoS Online (310) 318-5089   
                      
                    
LATEST VERSION:
===============
The latest version of Chat With Lisa is always available at:
 * ChAoS Online, in file area #1 (310) 318-5089. 
 * Wildcat Support BBS, in the Misc. Doors library (805) 873-2400.
 * T&J Software, in the BBS Doors library (717) 325-9481.
Version 1.6 was released September 15, 1995.

DISCLAIMER:
===========
THIS SOFTWARE PRODUCT IS DISTRIBUTED "AS IS" WITHOUT WARRANTY OF ANY 
KIND, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY 
AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL CHAOS ONLINE 
OR THE AUTHOR OF THIS SOFTWARE BE LIABLE FOR ANY KIND OF DAMAGES 
ARISING FROM THE USE OF THIS PRODUCT, INCLUDING BUT NOT LIMITED TO 
DIRECT, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES.

DISTRIBUTION:
=============
Chat With Lisa is Shareware. You may post the UNREGISTERED version for 
downloading or upload it to any other BBS, provided that you do not make 
any changes to the contents of the ZIP file. The REGISTERED version can
NOT be distributed - under penalty of copyright law. The archive and its 
individual contents may not be sold under any conditions.

PROGRAM DESCRIPTION:
====================
Chat With Lisa was created so that my callers would always have someone
to chat with. You can run Lisa as a Door, with an opening screen that 
introduces the caller to Lisa. Or you can skip the opening screen and 
pretend to page Lisa. She can be your virtual CoSysop 24 hours per day.

Lisa has "artificial intelligence" and will chat with your callers about 
any subject. She is programmed to recognize specific keywords and provide 
appropriate replies. If Lisa doesn't find any keywords, she uses generic 
responses. The Sysop can also configure Lisa's rating to be G, R, or X.

To help mimic human behavior, Lisa makes random typos and includes the 
caller's name in some of her responses. On my BBS, "Chat With Lisa" is
on the Main Menu and callers can page her. Many Sysops enjoy watching 
Lisa's chat sessions or reading the LOG files. 

Note: If you don't display the opening screen, some of your callers will
think Lisa is a real person. They might also get upset when they realize 
she is just a computer, and not available for dates! <grin>

STANDARD FEATURES:
==================
* Use any COM port from 1-15, up to 115k baud.
* Support for non-standard IRQ's and multiple nodes.
* Fossil driver support for multi-port boards. 
* Returns to BBS on dropped carrier. 
* Keyboard timeout after 4 minutes inactivity.
* Support for Wildcat and PCBoard % codes.
* Compatible with many BBS drop files.
* Support BBS available.

PLAYING LOCALLY:
================                                 
To try out Lisa, just type LISA LOCAL and press return. The unregistered
program's 15 second delay screens are not displayed during local mode.

The LISA.CFG file must be in the same directory as Lisa. Unless you
have already modified the configuration file, you will see the opening
screen and the rating will be set to R. Lisa's typing speed is set 
automatically every time the program starts up.

ADULT & NON-ADULT OPTIONS:
==========================
The Sysop can configure Lisa's rating to be G, R, or X. Lisa will  
behave (or misbehave) based on the following parameters:
 * The G-rated Lisa will not make sexual remarks or use profanity. 
   She will be less controversial and less sarcastic.
 * The R-rated Lisa can be sexy and provocative, but she won't use 
   profanity or engage in cybersex. 
 * The X-rated Lisa will have cybersex and use profanity, but only 
   if the caller persists in talking dirty to her. The "random" hot
   chat scripts will keep your adult callers from getting bored.
WARNING: SYSOP DISCRETION IS ADVISED! DO NOT ALLOW MINORS TO CHAT WITH 
THE X-RATED LISA! THE "X" OPTION IS NOT SUITABLE FOR MINORS OR PRUDES!

LOG FILES:
==========
With the LOG option turned on, the Lisa program will record the actual
conversation for each chat session. To prevent file sharing errors and
co-mingled conversations, a separate log file is created for each node.
Node 1 will be LISA1.LOG, Node 2 will be LISA2.LOG, etc.

The log files are SELF-MAINTAINING. At startup, the program checks the
file size of the current log. If the size is over 64,000 bytes, the file
is deleted and the log starts over. That is potentially 64k for every
node, so 10 nodes might fill up 640k of hard drive space. In practice,
some logs are 1k when others are 63k, so the average is about 32k each.

You may read the log files with any ASCII text viewer. While you are
viewing the log, the program can not record any chat sessions for that
node. If you have any problems with the log files, turn them off!

CHANGING LISA'S NAME:
=====================
Registered Sysops can specify Lisa's name in the LISA.CFG file. The new
name will be displayed everywhere that "Lisa" was previously shown. Any
female name up to 15 characters can be used. Choose carefully - hehe.

INSTALLATION:
=============
Installation consists of modifying two files: A batch file that your BBS
calls to run Lisa, and a configuration file that controls the various
options. The program also uses the ANSI.SYS driver that comes with DOS,
so make sure that is installed. Instructions follow:

SAMPLE BATCH FILE:
==================
A sample batch file (LISA.BAT) is included and consists of the following:

   ECHO OFF
   CD C:\DOORS\LISA   <--- Change to the door's directory.
   LISA LISA.CFG      <--- Run the door program using config filename.
   CD C:\WILDCAT      <--- Go back to BBS directory when user exits door.
   BBS.BAT            <--- Restart node or BBS. Use ONLY if you terminate
                           instead of shelling before using the door.

SEE YOUR INDIVIDUAL BBS DOCUMENTATION FOR INSTRUCTIONS ON RUNNING DOORS!

If you need to use a non-standard IRQ, add the IRQ number after LISA.CFG 
in the batch file. For example, to use IRQ 5:

   ECHO OFF
   CD C:\DOORS\LISA  
   LISA LISA.CFG /5  <--- Non-standard IRQ callout. Include the "slash" 
   CD C:\WILDCAT 
   
The /5 tells the program to use IRQ 5 instead of the standard IRQ. Or you 
can set the IRQ environment variable (SET IRQ=5) and use it as follows:   

   LISA LISA.CFG /%IRQ%  <--- Non-standard IRQ callout. Include the "slash"    
   
Don't forget to place the batch file in the proper directory so that
your BBS can execute it. Usually, the batch file is placed in the BBS
directory or subdirectory, not the Lisa directory.

CONFIGURATION:
==============
You must edit the LISA.CFG file to configure Lisa for your BBS. The Lisa 
program will read only the first 9 lines, and they must be in the order 
specified without any blank lines. The following example of LISA.CFG is 
for all BBS's:  (you should edit the LISA.CFG file already supplied)

C:\PCB\PCBOARD.SYS   <---,    The first line should be the full path to
C:\PCB\USERS.SYS         |    your BBS drop file. The Lisa program can
C:\BBS\DOOR.SYS          |    use any drop file shown here. Select the
C:\BBS\USERINFO.DAT      |--- correct one and edit the line to provide
C:\BBS\CALLINFO.BBS      |    the full path. Use only one line here. The
C:\BBS\DORINFOx.DEF      |    second line must be the name of your BBS,
C:\BBS\SFDOORS.DAT       |    as described below.
C:\BBS\TRIBBS.SYS    <---'
ChAoS Online     <--- The name of your BBS.
Mike            <--- First name of the Sysop.
Fox            <--- Last name of the Sysop.
9999999       <--- Registration code. Use any number if not registered.
                  Once registered, you cannot change lines 2, 3, or 4.
r           <--- Set rating to "G" or "R" or "X" (don't use quotes).
yes        <--- Display opening screen? "YES" or "NO" (don't use quotes).
1         <--- Create chat logs? 1 = YES, 0 = NO (must be 1 or 0).
Lisa     <--- Lisa's first name. Use any female name up to 15 characters.
             The program will capitalize the first letter & use lower-case 
            for the rest. The name will change on REGISTERED versions only.

Remember to press <enter> at the end of each line, including the last
one (don't leave trailing spaces on any line). Also check for spelling
errors and make sure that LISA.CFG is located in the Lisa directory.

MULTIPLE NODES:
===============
When specifying the location of the drop file on line 1 of LISA.CFG,
you may use the environment variables %wcnodeid%, %pcbdrive%, %pcbdir% 
and %pcbnode%. YOU MUST USE JUST ONE CONFIGURATION FILE TO RUN MULTIPLE 
NODES! The configuration filename must be LISA.CFG for proper operation. 
Here are some examples:

For Wildcat 4.X software, the first line in LISA.CFG could be:

   C:\WILDCAT\WCWORK\NODE%WCNODEID%\DOOR.SYS

The WCNODEID environment variable should be SET in the batch file 
that starts each node.

For PCBoard software, the first line in LISA.CFG could be:

   %PCBDRIVE%%PCBDIR%\NODE%PCBNODE%\USERS.SYS
    or just C:\BBSDIR\NODE%PCBNODE%\USERS.SYS
   
The PCB environment variables must also be SET in the batch file 
that starts the BBS or the batch file for each node. See below:

   SET PCBDRIVE=C:      <--- Drive letter of your BBS files.
   SET PCBDIR=\BBSDIR   <--- Path to your BBS files.
   SET PCBNODE=1        <--- Number of the node running Lisa. Since 
                             this could change, you should add it to 
                             the batch file that starts each node.

Other BBS systems can use the same variables as Wildcat and PCBoard.
The correct path to the drop file for different nodes could then be
specified in the LISA.CFG file by following the examples shown above.

Note: If you DO specify a filename other than LISA.CFG, Lisa will read 
the first line of the specified file to get the path for the drop file, 
and then open LISA.CFG to get all the other settings.

FOSSIL DRIVER SUPPORT:
======================
DoorFrame supports the use of Fossil drivers. To use the Fossil driver 
instead of the standard COM ports, just add /FD after LISA.CFG in the 
batch file. For example:

   ECHO OFF
   CD C:\DOORS\LISA  
   LISA LISA.CFG /FD   <--- Use the Fossil driver! 
   CD C:\WILDCAT 
   
If no Fossil driver is detected, DoorFrame will print a message to that 
effect and then exit the door gracefully.

TECHNICAL SUPPORT:
==================
I am trusting the DoorFrame software that "runs" Lisa to reliably support 
different BBS environments. If any internal errors do occur, check for a 
file called DFRAME.ERR and tell me what the error code says. Also read 
the HELP.TXT file for solutions to common problems.

Like all mortals, my time is limited. So please don't call and leave 
messages like "It doesn't work" or "I get an error". If you want my help, 
give me the details, ie: What did the screen display? When did it occur? 
What error code? Which BBS software? etc, etc.

And if you don't know how to use DOS, or haven't read the instructions,
or can't edit batch files, or don't know how to run your BBS, I will be 
happy to teach you... for $60.00 per hour :)

WHERE TO REACH ME:
==================
BBS:  ChAoS Online, (310) 318-5089 (I am the Sysop)
      If you want help, log on with your name and [Y]ell at the Sysop 
      from the Main Menu. Call back in 24 hrs to read your mail.

America Online:  Send e-mail to MikeFox1@aol.com
                 I check my mail at AOL at least once a week.
   
Snail Mail:  ChAoS Online
             P.O.Box 1211
             Torrance, CA 90505

LOCAL DISPLAY PROBLEMS:
=======================
If you observe strange looking characters when using the door locally, 
you need to add the following line to your CONFIG.SYS file:
   DEVICE=C:\DOS\ANSI.SYS
Read your DOS manual for more information. If you are multi-tasking
with DesqView, add DVANSI.COM to the batch file for each node.

PROBLEMS WITH 486DX COMPUTERS:
==============================
From the DoorFrame documentation: "The math co-processor in 486DX 
computers cannot handle the floating point math that all Microsoft 
Basics use". If you keep getting "keyboard timeout" errors or ERROR 5 
or ERROR 6, place the following line in your AUTOEXEC.BAT file:
   SET NO87=ON
This will turn off your math co-processor and allow the door to 
function properly.

SOME QUICKBASIC ERROR CODES (DOORFRAME USES THE SAME CODES):
============================================================
 2   Syntax error                       61   Disk full
 5   Illegal function call              62   Input past end of file
 6   Overflow                           63   Bad record number
 7   Out of memory                      64   Bad filename
11   Division by zero                   67   Too many files
13   Type mismatch                      68   Device unavailable
24   Device timeout                     69   Comm-buffer overflow
25   Device fault                       70   Permission denied
52   Bad filename or number             71   Disk not ready
53   File not found                     72   Disk media error
55   File already open                  74   Rename across disk
57   Device I/O error                   75   Path/File access error
58   File already exists                76   Path not found
59   Bad record length

Error #53 can be caused by a missing LISA.CFG or LISA.DAT file, or the
program cannot find the BBS drop file. Error #62 is usually caused by 
the LISA.CFG file not having enough lines.

REGISTERING:
============
Unregistered users will be subjected to a 15 second delay screen when
entering or exiting Lisa. Sorry about that, but I had to give you some 
incentive to send me money. Print out REGISTER.TXT to register by mail,
or read ONLINE.TXT if you prefer to register ONLINE. The fee is only 
$10 and applies to all future versions of Chat With Lisa.

FUTURE VERSIONS:
================
Tell me what you want. Some ideas for future versions include:
   * Group chat that would let you talk to Lisa and her friends.
   * User data file so Lisa could remember previous conversations.
   * Alternate personalities: bitch, nice girl, old, young, etc.
There are no guarantees that any of these ideas will be incorporated.

PS: Send me your LOG files. They will help me to make future versions 
    of Lisa even better.

END OF FILE!
============

