                    Ŀ
                       C H A T   W I T H   L I S A   
                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~   
                               Version 1.8           
                                                     
                       Copyright 1996 by Mike Fox    
                                                     
                                  *****              
                                                     
                       ChAoS Online (310) 318-5089   
                    

LATEST VERSION:
===============
The most recent 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.
   * WWW at http://home.aol.com/Chat2Lisa (under construction).  
Version 1.8 was released March 15, 1996. The filename is LISA18.ZIP.

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 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 replies. She even remembers recent callers!
On my BBS, "Chat With Lisa" is on the Main Menu and users can page her. 
Many Sysops enjoy watching Lisa's chat sessions or reading the LOG files. 

MAD ABOUT LISA!
===============
Please note that if you do not 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>

One Sysop created a fake Lisa account and put her e-mail address on the 
Page Menu; now he answers her mail! Other Sysops provide GIFs of Lisa for 
downloading. Don't blame me when your callers find out you tricked them.

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.

CUSTOM RESPONSE FILE:
=====================
If you would like Lisa to answer questions about your BBS or talk about 
your special interests, please read the CUSTOM.TXT file. 

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. 
   But she might tease the caller or be 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.

THE X-RATED SETTING WORKS ON REGISTERED VERSIONS ONLY! THIS MEANS
SYSOPS CAN DISTRIBUTE LISA18.ZIP (UNREGISTERED) WITHOUT RESTRICTIONS.

NOTE: THE TELECOMMUNICATIONS ACT OF 1996 MAKES IT A CRIMINAL OFFENSE 
TO KNOWINGLY EXPOSE MINORS TO INDECENT MATERIALS. REGISTERED SYSOPS 
SHOULD NOT ALLOW MINORS (OR PRUDES) TO CHAT WITH THE X-RATED LISA. 

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:
=====================
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.

SETTING LISA'S TYPING SPEED:
============================
Lisa's typing speed can be specified on line 10 of the LISA.CFG file. 
Entering 0 will set the speed automatically, which we recommend. But you 
can enter 1 to 100 to manually control her typing speed. The speed varies 
by the square of the number (1 is fast, 100 is slow). 

Before setting the speed manually, you should check the number that Lisa 
is using for her AUTOMATIC speed setting. Just enter -1 (negative one) on
line 10 to put Lisa in her diagnostic mode. The speed setting will then
be shown on your local monitor, right after the "PAGE SENT TO..." line. 
Use this number as a starting point for your manual speed setting. 

The other numbers displayed are: K = Keywords stored, R = Replies stored,
MEM = Memory available while using Lisa, STK = Stack space, STR = String
space. Don't forget to change line 10 back to 0, or your own setting.

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 10 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 (not displayed to callers).
Fox            <--- Last name of the Sysop (not displyed to callers).
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 always capitalize the first letter. 
0      <--- Lisa's typing speed. Enter 0 to set the speed automatically.
           We recommend using 0, but you can enter 1-100 to manually 
          control her typing speed (1 is fast, 100 is slow). 

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.

DON'T FORGET TO INSTALL SHARE.EXE IN YOUR AUTOEXEC.BAT FILE IF YOU ARE 
RUNNING MULTIPLE NODES!

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:
==================
Almost every problem that you might encounter while installing Lisa has 
been described and solved in the HELP.TXT file. If any internal errors do 
occur, check for a file called DFRAME.ERR and tell me what the error code 
says. But try reading the HELP.TXT file before asking for help.

Like all mortals, my time is limited. So please don't 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? Which Operating System? 

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.
      (don't ask me to call your BBS, you need to call back!)

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 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 get
ERROR 5 or 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.

THREE REASONS TO REGISTER:
==========================
1) The unregistered delay screens will go away! 
2) You can use the CUSTOM.DAT file to have Lisa answer questions about 
   your BBS or talk about your special interests.
3) You can use the X-rated setting to entertain your adult callers with 
   random Hot Chat scripts. Lisa loves cybersex! (unregistered versions
   will switch to R-rated mode whenever the X-rated setting is used) 
The registration fee is $12 if you register by mail (read REGISTER.TXT)
or only $10 if you register online (read ONLINE.TXT). The fee 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 friend.
   * User data file so Lisa could remember previous conversations.
There are no guarantees that these ideas will be incorporated.

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

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

