.\" DO NOT MODIFY THIS FILE!
.TH AINEBOT "1" "September 2010" "ainebot Version 0.9.6" "User Commands"
.SH NAME
ainebot \- manual page for 
.B aine 
and 
.B aine.cgi
interactive 'chatbot' programs
and the 
.B aine-query 
program for querying the ainebot 'brain' non-interactively.
.SH SYNOPSIS
.B aine 
[\-ious] [\fBARGUMENTS\fR]
.SH DESCRIPTION
.PP
.B aine.cgi
is the interactive cgi version of ainebot, for use by a web browser.
.PP
.B aine-query
is the non-interactive CLI version of ainebot for 'querying' the ainebot 'brain'.
.PP
.B aine
is the interactive console version of ainebot. It can be run with from the 
command\-line with any, or all of the options shown below.
.PP
Each of the above programs uses the same ainebot 'brain', which is compiled into
a semi-binary format from input files written in the Aine Language.
.SH OPTIONS
.TP
\fB\-i\fR FILE
Use FILE as the init file. The default is data/aine.ini.
.TP
\fB\-o\fR
Disactivate the stripping of URLs.
.TP
\fB\-u\fR NAME
Starts ainebot with NAME as the user name. This causes the bot to create 
and use a separate file to hold the users variables. When aine is started
without specifying the user name, then the default values found in defvars.txt 
will be used, and when shut down, the bot will save these values to the 
common file localuser.txt
.TP
\fB\-s\fR VARIABLE VALUE
Starts the bot with VARIABLE set to VALUE
.SH "EXAMPLES"
.IP
aine \-u David
.br
Start the bot using the user name 'David'.
.IP
aine \-s auto_punctuate 0
.br
Start the bot with the auto-punctuation feature turned off.
.SH CONFIGURATION FILES
When the interactive console version of aine is started it first 
reads basic configuration information from the aine.ini file, unless
an alternate file has been specified using the '-i FILE' option.
.PP
If the bot has been started without specifying the user name, the
default predicate values are *read* from the file data/defvars.txt.
When the bot is shutdown, if the users' name is still unknown, then
the last values for the predicates are *saved* in log/localuser.txt.
.PP
If the bot is started with a specified user name, then the initial
predicate values will be loaded from the users' personal predicate
file in log/users/name. If the user is 'logging in' to the bot for
the first time, then the defaults will be read from defvars.txt as
above.
.PP
When the program shuts down and the users' name is known, the program
writes the last values for the predicates to the users' personal file
at log/users/name. If the users' name is unknown, then the last 
default values are written to log/localuser.txt

.SH "SEE ALSO"
For more information on the cgi version of aine, see 
.B cgi-man.txt
.PP
See the file 
.B Aine-tutorial.txt
for a tutorial on writing or modifying *.aine files written using the
Aine Language.
.PP
The program aine-query uses a separate init file, aine-query.ini to 
allow for better control of the program. In particular, it may be useful
to run the aine-query program with auto_punctuate set to '0' (for OFF),
as this keeps the output from the bot from being capitalized and a default
period '.' added to the end of the output.
.PP
The full documentation for all the ainebot programs can be found
in the documents included with the package.
.SH "AUTHORS"
This man-page was written by: Gilbert Ashley <amigo@ibiblio.org>