Documentation?  Are you CRAZY?  Oh... All right... 

This is a hodgepodge of stuff taken from a stagnant but 
running, non-devopment agent, known as Thoth on DragonMud
(telnet dragonmud.org 4201) and currently ported/developed for the
talker "PinWHeeLs" by me, Cygnus (cygnus@misty.com) to work on the
SunOS operating system. I make no guarantees that this bot will work on
other OSs. You're lucky if it does. :-)

It's up to you to read through storybot.c, make the customizations
that it requires and any supporting directories if it's unable
to create them upon startup. I started structuring him for user
interaction besides the story stuff.. the function is handle_action()
where I began. 

What you will find:
manual  ---  how to use the storybot (flatfile).
restart  --- The startup script.
Stories   --- The directory that holds all learned stories.
storybot.c --- the current source code. (has a lame paginator
        to break up long lists of stories, and some decorative
        characterization for most recent implementation)

DO:
    
    Search and replace all occurances of "Spokes" (my bot name)
    in the code with your bot's true name, ie: Daisy

    Change the destination address and port in the code.
    Change the bot's username and password in #define CONNMSG
    Change anything else you deem necessary to work with your talker.

    If this is for a talker..create an account on the talker for the
    bot with the name and password you put in the code file.
    Make the bot the highest rank in the talker.
    For ncohafmuta people, this can be done with:
    .pcreate <bot_name> <highest_level_in_talker> <bot_password>
    (example: .pcreate daisy 4 botpass)

    * Make sure the bot's account has highlighting for .tells/pages TURNED
      OFF!
     For ncohafmuta people, you can do this 2 ways.
      1) log in as the bot and type: .set hi
      2) as the BOTS_ROOTID type: .force <bot_name> hi

    * Turn the .monitor on for the bot
     For ncohafmuta people, you can do this 2 ways.
      1) log in as the bot and type: .monitor
      2) as the BOTS_ROOTID (with the bot logged in) type:
         .force <bot_name> com .monitor

    Type "compile" to compile the code

    Type "restart" to boot the bot.

TIPS:
as the BOTS_ROOTID you have control over the bot like noone else.
You can force it, tell it to delete any story you wish, abort writing by
anyone, etc..
You can also tell it to reboot or shutdown itself.
.tell it "reboot" to make him reboot itself
.tell it "shutdown" to make him shutdown itself

PLEASE REMEMBER, the bot is designed to work with a communication format
of <user> says "<message>", <user> tells you: "<message>", etc.. as
defaulted in the ncohafmuta talker code's constants.h
It will NOT work if you change these. You will have to go in the bot code
itself and make modifications for your specific communication formats.

You may want to fire off mail to John Crane (jopsy@ucsd.edu)
letting him know that you obtained this code from " Cray ", and are using
it, and for what, just so he knows.

Do NOT expect either John Crane or myself to support this code,
or answer questions from overweening users having trouble getting
it running.   ;-)

However, If you patch it, fix it, or modify it, patches are very
welcome at jopsy@ucsd.edu and cygnus@misty.com.

This code is not for resale or value added arrangements.  
Distribution is strictly on an "as-interested" basis, in
other words, please don't post the code or put it up on 
an ftp archive for the world to grab.

Thank you, and enjoy!

-Cygnus
