*****
>>MAIN HELP
>>
>>The help system of Spiderbot is designed to help
>>with each individual command.  The command
>>structure of Spiderbot is arranged in a tree form,
>>with the commands relating to each object being
>>under a specific branch of the tree.
>>Each command has to be told to the robot via
>>whispering, and of course you must be at least a
>>commander if not an owner of the robot.
>>The format of the command is given by putting
>>fields in {} and optional fields in [].  If there
>>is an optional field, and the field is not
>>entered, the robot will report the current value
>>or use the default for the situation.
>>
>>COMMANDS:
>>help, quit, globals, player, group,
>>stim, resp, room, exit, move, force
*****help
>>HELP
>>
>>Help is a help system designed to give individual
>>help with each command and related commands.
>>To use the help system, whisper help {command} to
>>the robot and it will tell you about command:
>>whether it has subcommands or options, as well as
>>the purpose of the command.
*****quit
>>QUIT
>>
>>Quit tells the robot to save all of the
>>information in its database and disconnect from
>>the site.
*****globals
>>GLOBALS
>>
>>Globals contains information about the robot, how
>>it connects and various special commands, as well
>>as the filenames of different data files.
>>
>>SUBCOMMANDS:
>>load, save, default, name, password, site, port,
>>room, home, command, moveodds, queuesize, queue
*****globals load
>>GLOBALS LOAD [{filename}]
>>
>>Erases the robot's current memory and loads the
>>information from the default [or given] file.
*****globals save
>>GLOBALS SAVE [{filename}]
>>
>>saves the information to the default file [or the
>>filename given] and continues operation.
*****globals default
>>GLOBALS DEFAULT [{filename}]
>>
>>Sets the globals default filename.  [which is
>>only used for the current run, since the robot
>>uses the parameter given on runtime as the global
>>file name]
*****globals name
>>GLOBALS NAME [{name}[|{name2}...|{nameN}]]
>>
>>Sets the name(s) of the robot...all of which are
>>used to determine what names the robot responds
>>to in stimuli.
*****globals password
>>GLOBALS PASSWORD [{password}]
>>
>>Sets the password for the robot. only works for
>>owners.
*****globals site
>>GLOBALS SITE [{site name/#}]
>>
>>Sets the name of the site for the robot to
>>connect to.
*****globals port
>>GLOBALS PORT [{port #}]
>>
>>Sets the port for the robot to connect to.
*****globals room
>>GLOBALS ROOM [{room name/#}]
>>
>>Sets the home room of the robot.
>>
>>SEE:
>>GLOBALS HOME
*****globals home
>>GLOBALS HOME [{home string}]
>>
>>Sets the command that sends the robot home.
>>
>>SEE:
>>GLOBALS ROOM
*****globals command
>>GLOBALS COMMAND [{command string}]
>>
>>Sets the string that activates the command system,
>>note:  the command has to be inclosed in double
>>quotes still.
*****globals moveodds
>>GLOBALS MOVEODDS [{move odds}]
>>
>>Determines the odds [one out of n] of the robot
>>moving per each robot action time.
*****globals queuesize
>>GLOBALS QUEUESIZE [{queue size}]
>>
>>Sets the size of the move queue.  The move
>>queue stores previously visited rooms, so that
>>the robot doesn't walk over its path unless
>>forced to.
*****globals queue
>>GLOBALS QUEUE
>>
>>Lists the rooms in the room queue.
*****globals actodds
>>GLOBALS ACTODDS [{action odds}]
>>
>>Determines the odds [one out of n] of the robot
>>acting per robot cycle.  The actions are taken from
>>the response list of the group RANDOM.
*****player
>>PLAYER
>>
>>Player is a group of commands dealing with player
>>information in the robot.
>>
>>SUBCOMMANDS:
>>load, save, default, add, delete, list, status,
>>verbose, ignore, command, owner
*****player load
>>PLAYER LOAD [{filename}]
>>
>>Erases the player information and loads it from
>>the default [or given] file.
*****player save
>>PLAYER SAVE [{filename}]
>>
>>Saves the robot's current player information to
>>the default [or given] file.
*****player default
>>PLAYER DEFAULT [{filename}]
>>
>>Sets the default file for the player information.
*****player add
>>PLAYER ADD {name}
>>
>>Adds the player to the player list.
*****player delete
>>PLAYER DELETE {name}
>>
>>Deletes the player from the player list.
*****player list
>>PLAYER LIST
>>
>>Lists the players currently known by the robot.
*****player status
>>PLAYER STATUS {name} [{status}]
>>
>>Sets the status for the player given.
>>Status is the 'rating' of the player in relation
>>to the robot.
>>The status is used to determine how the robot
>>will react to the player's actions.  The higher
>>the status, the more positively the robot will
>>react.
>>
>>SEE:
>>resp
*****player verbose
>>PLAYER VERBOSE {name} [t/f]
>>
>>Sets whether the player will be told various
>>information during command interactions.
>>t - give verbose messages to the player
>>f - only give terse or no messages to the player
*****player ignore
>>PLAYER IGNORE {name} [t/f]
>>
>>Sets whether the robot will ignore the player.
>>t - ignore the player in question
>>f - don't ignore the player
*****player command
>>PLAYER COMMAND {name} [t/f]
>>
>>Sets whether the player has the ability to
>>command the robot.
>>[Can only be changed by an owner]
>>t - player can command the robot
>>f - player cannot command the robot
*****player owner
>>PLAYER OWNER {name} [t/f]
>>
>>Sets whether the player can access special owner
>>commands.
>>[Can only be changed by an owner.]
>>t - player is an owner
>>f - player is not an owner
*****group
>>GROUP
>>
>>Groups are stimuli and responses grouped together
>>by types.  Each group has common characteristics
>>and the responses listed for the group only refer
>>to that group.
>>
>>SUBCOMMANDS:
>>load, save, default, add, delete, list, current
*****group load
>>GROUP LOAD [{filename}]
>>
>>Erases the current group info and loads the info
>>from the default [or given] filename.
*****group save
>>GROUP SAVE [{filename}]
>>
>>Saves the current group information to the
>>default [or given] file.
*****group default
>>GROUP DEFAULT [{filename}]
>>
>>Sets the default filename to be used for the
>>groups.
*****group add
>>GROUP ADD {name}
>>
>>Adds a new group to the list.
*****group delete
>>GROUP DELETE [{name}]
>>
>>Deletes the current [or given] group.
*****group list
>>GROUP LIST
>>
>>Lists the groups currently in memory.
*****group current
>>GROUP CURRENT [{name}]
>>
>>Sets the current group to the one given.  When
>>modifying stimuli and responses for the current
>>group, use * instead of the name as the group
>>option of the command.
*****stim
>>STIM
>>
>>Stim deals with stimuli of individual groups.
>>Stimuli are given in logical form, using
>>individual strings and logical operators.  The
>>operators currently supported are:
>>() - for nesting
>>&  - logical and
>>|  - logical or
>>!  - logical not
>>To match the robot's name, use ^ as one of the
>>elements.
>>Eg:to match any statement that contains "I",
>>"love" or "like", "you", but not "don't" or
>>"not", and the name of the robot, use:
>>i&(like|love)&^&!(don't|not)
>>The presidence is:!, & and | in descending order,
>>then left to right.
>>
>>SUBCOMMANDS:
>>add, delete, and list
*****stim add
>>STIM ADD {group} {stimulus}
>>
>>Adds a stimulus to the group given.
*****stim delete
>>STIM DELETE {group} {stim #}
>>
>>Deletes the stimulus number {stim #}.
*****stim list
>>STIM LIST {group}
>>
>>Lists the stimuli for the group.
*****resp
>>RESP
>>
>>Responses are individual actions that the robot
>>will take, depending on the acting player's
>>status, and a random selection.
>>Each response has a certain format:
>>{lower} to {upper}:{status_change}:{pri}:{action}
>>
>>EXPLANATION:
>>{lower} and {upper}
>>status limits for the certain action, using * to
>>stand for infinity [- infinity for lower limit.]
>>
>>{status_change}
>>the change in status that the response will result
>>in
>>
>>{priority}
>>a number greater than zero that represents the
>>odds of that action being chosen.  If there is
>>only one option for the robot, the odds are based
>>on the total priority between all possible
>>actions.
>>
>>{action}
>>a specific action [or set of actions] to be taken
>>by the robot, using these special strings:
>>%o - objective form of the player's name,
>>%p - possessive form,
>>%r - the current room name [that the bot knows],
>>/  - newline
>>
>>EXAMPLES:
>>-10 to 20:+2:10::laughs loudly at %o.
>>* to *:-1:20::does nothing but sit there.
>>30 to *:+1:10:"I like you/:kisses %p cheek.
>>
>>If the acting player had a status of fourty, he
>>would have a 33% chance of getting:
>>Robot says, "I like you"
>>Robot kisses Player's cheek.
>>
>>and 66% chance of getting:
>>Robot does nothing but sit there.
>>
>>SUBCOMMANDS:
>>add, delete, list
*****resp add
>>RESP ADD {group} {lower} TO {upper}:
>>{status_change}:{priority}:{action}
>>
>>Adds a response to the group given.
*****resp delete
>>RESP DELETE {group} {response #}
>>
>>Deletes the response {response #}.
*****resp list
>>RESP LIST {group}
>>
>>Lists the responses for the group.
*****room
>>ROOM
>>
>>Room commands are used to store an internal
>>movement map for the robot.  Each room stores
>>a list of exits to other rooms.
>>
>>SUBCOMMANDS:
>>add, delete, list, default, current, load
>>save
*****room add
>>ROOM ADD {room name}
>>
>>Adds a room to the room list.
*****room delete
>>ROOM DELETE {room name/#}/*
>>
>>Deletes a room from the room list.
*****room list
>>ROOM LIST
>>
>>Lists the rooms.
*****room default
>>ROOM DEFAULT [{filename}]
>>
>>Sets the default room file name.
*****room current
>>ROOM CURRENT [{room name/#}]
>>
>>Sets what the robot thinks is the current
>>room.
*****room load
>>ROOM LOAD [{filename}]
>>
>>Loads the room file.
*****room save
>>ROOM SAVE [{filename}]
>>
>>Saves the room file.
*****exit
>>EXIT
>>Exits are links from one room to another.
>>
>>SUBCOMMANDS:
>>add, delete, list
*****exit add
>>EXIT ADD {src room name/#}/*
>>{dest room name/#}/* {name}
>>
>>Adds an exit from the source room to the
>>destination room.
*****exit delete
>>EXIT DELETE {src room name/#}/*
>>{dest room name/#}/* {name/#}
>>
>>Deletes an exit.
*****exit list
>>EXIT LIST {src room name/#}/*
>>
>>Lists the exits in a room.
*****move
>>MOVE [{exit name}]
>>
>>Forces the robot to move; if no exit given,
>>or is an invalid name: chooses a random exit.