@node Configuration File Placement, , Configuration Files, Configuration
@section Configuration File Placement
+@quotation
+[ I kinda think this should go before the detailed description of the
+config file. I was didn't see it at first and was very frustrated
+trying to find out @emph{where} to edit all this wonderful stuff. ]
+@end quotation
+
Bobot++ will look in @file{/etc/bobotpp/default/} for its default
config if none is specified on the command line. Put the configuration
files you want to be loaded by default in this directory. If you are
accepts the following command line arguments:
@itemize
-
@item @code{[--help][-h]} - Shows detailed help and exits
-
@item @code{[--version][-v]} - Shows version information and exits
-
@item @code{[--no-background][-b]} - Run bobot++ in the foreground
-
-@item @code{[--config-file file][-f]} - Use file instead of
-@file{bot.conf}
-
-@item @code{[--config-dir dir][-d]} - Use dir as dir to load config
-file from
-
+@item @code{[--config-file file][-f]} - Use file instead of @file{bot.conf}
+@item @code{[--config-dir dir][-d]} - Use dir as dir to load config file from
@item @code{[--config dir][-c]} - Search your config path (defaults to
@file{@var{$HOME}/.bobotpp/config/} and then @file{/etc/bobotpp/}) for
dir and then loads your config data using dir
-
@item @code{[--sys-config dir][-s]} - Looks for config in
@file{/etc/bobotpp/dir}. Note that the user dir is still searched
first
-
@item @code{[--user-config dir][-u]} - Looks for config in
@file{@var{$HOME}/.bobotpp/config/dir/}. Note that the system dir is
still searched after this if dir is not found.
-
@item @code{[--debug][-D]} Makes Bobot++ print debugging info and run
in the foreground
-
@end itemize
The default configuration is read from
numeric code.
@enumerate 0
-
@item No protection
-
@item No ban. If a user is banned the bot will unban him..
-
@item No kick. The user may still be kicked but the bot will kickban
the user who kicked the protected user.
-
@item No deop. The bot will ensure that the user always maintains
operator status.
-
@end enumerate
@node Automatic Op, Built-In Commands, Protection, Using the Bot
@section Built-In Commands
Bobot++ has many built-in commands that make it useful without
-scripting support. The reference leaves off the command char;
-remember to use whatever you defined the command char to be in
+scripting support. The reference leaves off the command char; remember
+to use whatever you defined the command char to be in
@file{bot.conf}. If a command needs the channel name then you must
specify the channel as the first argument to the command when private
messaging the bot a command.
-@multitable @columnfractions 0.25 0.25 0.25 0.25
+@multitable @columnfractions 0.20 0.15 0.15 0.50
@item @sc{command} @tab @sc{Needs Channel} @tab @sc{Min Level to Use} @tab @sc{Description}
@item @command{action} @option{do} @tab Yes @tab @var{USER} @tab
Causes the bot to perform the action @option{do} in the current
channel.
-@item @command{adduser}
+@item @command{adduser} @tab @tab @tab
-@item @command{addserver}
+@item @command{addserver} @tab @tab @tab Adds the server specified by
+@var{host name} or @var{ip address} to the server list.
-@item @command{addshit}
+@item @command{addshit} @tab @tab @tab
-@item @command{alias}
+@item @command{alias} @tab @tab @tab Makes an alias, and adds the
+function @var{new name}, that will do exactly the same command as
+@var{old name}.
-@item @command{ban}
+@item @command{ban} @tab @tab @tab Bans @var{mask} or @var{nick} from
+@var{channel}. You need to be a trusted user to ban with a
+@var{mask}.
-@item @command{banlist}
+@item @command{banlist} @tab @tab @tab
-@item @command{channels}
+@item @command{channels} @tab @tab @tab Prints the channel(s) where
+the bot is currently.
-@item @command{cycle}
+@item @command{cycle} @tab Yes @tab @tab Makes the bot leave and join
+@var{channel}.
-@item @command{dcclist}
+@item @command{dcclist} @tab @tab @tab Gives the list of all DCC Chat
+connections.
-@item @command{deban}
+@item @command{deban} @tab Yes @tab @tab Debans @var{mask} or
+@var{nick} from @var{channel}. You need to be a trusted user to deban
+with a @var{mask}.
-@item @command{delserver}
+@item @command{delserver} @tab @tab @tab Deletes server from server
+list whose number in the server list is @var{server number}.
-@item @command{deluser}
+@item @command{deluser} @tab @tab @tab Removes @var{nick} or
+@var{mask} from the userlist.
-@item @command{delshit}
+@item @command{delshit} @tab @tab @tab Removes @var{nick} or
+@var{mask} from the shitlist.
-@item @command{deop}
+@item @command{deop} @tab Yes @tab @tab Deops @var{mask} or @var{nick}
+on @var{channel}.
-@item @command{die}
+@item @command{die} @tab @tab @tab Makes the bot stop immediately.
-@item @command{do}
+@item @command{do} @tab @tab @tab
-@item @command{execute} @tab @tab @tab @strong{Only available if scripting
-support is enabled}
+@item @command{execute} @tab @tab @tab @strong{Only available if
+scripting support is enabled}
-@item @command{help}
+@item @command{help} @tab @tab @tab
-@item @command{ident}
+@item @command{ident} @tab @tab @tab Identifies you on the bot. Note
+that you should not use this command in public @dots{}
-@item @command{invite}
+@item @command{invite} @tab Yes @tab @tab Invites @var{nick} on
+@var{channel}.
-@item @command{join}
+@item @command{join} @tab @tab @tab Makes the bot join @var{channel}.
-@item @command{keep}
+@item @command{keep} @tab Yes @tab @tab Sets the @var{modes} that the
+bot will keep for @var{channel}.
-@item @command{kick}
+@item @command{kick} @tab Yes @tab @tab Kicks @var{mask} or @var{nick}
+out of @var{channel}, because of @var{reason}. You need to be a
+trusted user to use a @var{mask}.
-@item @command{kickban}
+@item @command{kickban} @tab Yes @tab @tab Bans then kicks @var{mask}
+or @var{nick} out of @var{channel}, because of @var{reason}. You need
+to be a trusted user to use a @var{mask}.
-@item @command{load}
+@item @command{load} @tab @tab @tab Reloads the userlist from disk.
-@item @command{loadscript} @tab @tab @tab @strong{Only available if scripting
-support is enabled}
+@item @command{loadscript} @tab @tab @tab @strong{Only available if
+scripting support is enabled}
-@item @command{lock}
+@item @command{lock} @tab @tab @tab Locks topic on @var{channel}.
-@item @command{mode}
+@item @command{mode} @tab Yes @tab @tab Sends @var{mode string} as
+mode for @var{channel}.
-@item @command{msg}
+@item @command{msg} @tab @tab @tab
-@item @command{names}
+@item @command{names} @tab Yes @tab @tab Shows the nicknames and
+status of users on @var{channel}.
-@item @command{nextserver}
+@item @command{nextserver} @tab @tab @tab Makes the bot connect to the
+next server in its server list.
-@item @command{nick}
+@item @command{nick} @tab @tab @tab Makes the bot use nickname @var{nick}.
-@item @command{nslookup}
+@item @command{nslookup} @tab @tab @tab Does a nameserver query about
+@var{nick} host, @var{host} or @var{ip address}.
-@item @command{op}
+@item @command{op} @tab Yes @tab @tab Ops @var{nick} on @var{channel}.
-@item @command{part}
+@item @command{part} @tab Yes @tab @tab Makes the bot leave @var{channel}.
-@item @command{password}
+@item @command{password} @tab @tab @tab Changes your password on the
+bot. Use @code{NONE} as password if you want to clear it. Do not use this
+command in public!
-@item @command{reconnect}
+@item @command{reconnect} @tab @tab @tab Makes the bot reconnect to
+its current server.
-@item @command{rspymessage}
+@item @command{rspymessage} @tab @tab @tab Removes you from the spy
+list.
-@item @command{save}
+@item @command{save} @tab @tab @tab Saves the userlist.
-@item @command{say}
+@item @command{say} @tab Yes @tab @tab Makes the bot say @var{message}
+on @var{channel}.
-@item @command{server}
+@item @command{server} @tab @tab @tab Select the server to connect
+to. @var{server number} is the number of the server in the serverlist.
-@item @command{serverlist}
+@item @command{serverlist} @tab @tab @tab Shows the bot's serverlist.
-@item @command{setfloodrate}
+@item @command{setfloodrate} @tab @tab @tab
-@item @command{setversion}
+@item @command{setversion} @tab @tab @tab
-@item @command{shitlist}
+@item @command{shitlist} @tab @tab @tab Shows the bot's shitlist.
-@item @command{spylist}
+@item @command{spylist} @tab @tab @tab Shows the bot's spylist.
-@item @command{spymessage}
+@item @command{spymessage} @tab @tab @tab Adds you to the spylist
-@item @command{stats}
+@item @command{stats} @tab Yes @tab @tab Gives @var{channel}'s statistics.
-@item @command{tban}
+@item @command{tban} @tab Yes @tab @tab Bans @var{nick} or @var{mask}
+from @var{channel} for @var{time} seconds.
-@item @command{tkban}
+@item @command{tkban} @tab Yes @tab @tab Bans @var{nick} or @var{mask}
+from @var{channel} for @var{time} seconds, then kicks him/them because
+of @var{reason}.
-@item @command{topic}
+@item @command{topic} @tab Yes @tab @tab If no @var{topic}is given,
+prints @var{channel}'s topic. Otherwise, the bot will change
+@var{channel}'s topic to @var{topic}.
-@item @command{unlock}
+@item @command{unlock} @tab Yes @tab @tab Makes the bot unlock topic
+on @var{channel}
-@item @command{userlist}
+@item @command{userlist} @tab @tab @tab Shows the bot's userlist
-@item @command{who}
+@item @command{who} @tab Yes @tab @tab Show your level on @var{channel}
-@item @command{whois}
+@item @command{whois} @tab Yes @tab @tab Shows information about
+@var{nick} on @var{channel}
@end multitable
@node Adding New Commands, Hooks, Scripting, Scripting
@section Adding New Commands
-@findex addcommand
-Adding a new command is simple. To register a new command use
-@code{bot:addcommand}. The prototype for @code{bot:addcommand} is
-@code{(bot:addcommand name func needs-channel? num-of-args
-min-level)}. The @code{name} is a string representing the name of the
-command being added. @code{func} is a function accepting
-@code{num-of-args} arguments. @code{needs-channel?} is a bool that is
-true if the function needs the channel name as its first arg, and
-false otherwise. @code{num-of-args} is the number of args @code{func}
-will take and must be within zero (0) and twenty
-(20). @code{min-level} is one of the @ref{Scheme User Levels}. A user must be
-at least a @code{min-level} user to use the new command. None of the
-arguments are guaranteed to be passed; if they aren't they are set to
-the empty string @code{""}. An example of a new command would be:
+Adding a new command is simple. To register a new command use @code{bot:addcommand}.
+
+@defun bot:addcommand name func needs-channel? num-of-args min-level
+
+The @var{name} is a string representing the name of the command being
+added. @var{func} is a function accepting @var{num-of-args}
+arguments. @var{needs-channel?} is a bool that is true if the function
+needs the channel name as its first arg, and false otherwise.
+@var{num-of-args} is the number of args @var{func} will take and must
+be within zero (0) and twenty (20). @var{min-level} is one of the
+@ref{Scheme User Levels}. A user must be at least a @code{min-level}
+user to use the new command. None of the arguments are guaranteed to
+be passed; if they aren't they are set to the empty string @code{""}.
+An example of a new command would be:
@example
(define (hello channel name)
@end example
This will display ``Hello World!'' if called as @kbd{!hello} and
-``Hello World @code{USER}'' if called as @kbd{!hello @var{USER}}.
+``Hello World @code{USER}'' if called as @kbd{!hello @var{USER}}.
+@end defun
@node Hooks, Scheme User Levels, Adding New Commands, Scripting
@section Hooks
@node Creating a Hook, Hook Types, Hooks, Hooks
@subsection Creating a Hook
-@findex addhook
-To add a new hook you use the function
-@code{bot:addhook}. @code{bot:addhook} is prototyped as
-@code{(bot:addhook type regex function pri fall name)}. @code{type}
-specifies the type of hook (the types of hooks are listed in @ref{Hook
-Types}). @code{regex} is a standard regular expression. If
-@code{regex} is matched, @code{function} will be
-called. @code{function} will take a different number of args depending
-on the hook type. @code{pri} specifies the priority of the
-hook---higher priority hooks are executed first. This argument is
-optional and defaults to @code{0}. @code{fall} is @code{#t} if the
-hook is a fallthrough hook and @code{#f} is the hook is not a
-fallthrough hook. This arg is also optional and default to
-@code{#t}. @code{name} is the optional name of the hook that defaults
-to ``DEFAULT''. If you set the name then you can have more than one
-hook that matches the same regexp, as long as they have the same
-name. E.g. in a log script you could have the regexps for the log
-function all be @code{".*"} and set their names to @code{"log"} to
-avoid a conflict with other hooks.
+To add a new hook you use the function @code{bot:addhook}.
+
+@defun bot:addhook type regex function [pri fall name]
+@var{type} specifies the type of hook (the types of hooks are listed
+in @ref{Hook Types}). @var{regex} is a standard regular expression. If
+@var{regex} is matched, @var{function} will be called. @var{function}
+will take a different number of args depending on the hook
+type. @var{pri} specifies the priority of the hook---higher priority
+hooks are executed first. This argument is optional and defaults to
+@code{0}. @var{fall} is @code{#t} if the hook is a fallthrough hook
+and @code{#f} is the hook is not a fallthrough hook. This arg is also
+optional and default to @code{#t}. @var{name} is the optional name of
+the hook that defaults to ``DEFAULT''. If you set the name then you
+can have more than one hook that matches the same regexp, as long as
+they have the same name. E.g. in a log script you could have the
+regexps for the log function all be @code{".*"} and set their names to
+@code{"log"} to avoid a conflict with other hooks.
+@end defun
@node Hook Types, , Creating a Hook, Hooks
@subsection Hook Types
-Here is a list of the various hooks are notes on each one. The general
-format of a hook is:
+Here is a list of the various hooks funtions and notes on each
+one. The general format of each hook description is as if it was was
+function to be defined, but these describe the function to be passwd
+to @code{bot:add-hook}. Do @emph{not} name your functions these
+names.
-@itemize @bullet
-@item
-@code{hooks/name} (this is the Scheme variable name of the hook)
-@itemize @minus
-@item
-Description of the hook
-@item
-@var{arg1} @var{arg2} ... @var{argn}
-@itemize @minus
-@item
-@var{arg1}: desc
-@item
-@var{arg2}: desc
-@item
-...
-@item
-@var{argN}: desc
-@end itemize
-@end itemize
-@end itemize
+@quotation
+[ Boy, that's clumsy. I want to say that the hook/xx functions that
+are documented below are not funtions that you call. They are the
+functions that needs to be passed to bot:addhook for that kind of
+hook.
-That said, here is the list of available hooks:
-FIXME: write docs
+Still clumsy. Oh well. ]
+@end quotation
-@itemize @bullet
-@item
-@vindex hooks/action
-@code{hooks/action}
-@itemize @minus
-@item
-This hook is triggered when someone performs an action.
-@item
-@var{from}, @var{to}, @var{action}
-@itemize @minus
-@item
-@var{from}: this is the address of the person that performed the
-action in the form @samp{@var{nick} ! @var{user} @@ @var{host}}
-(without the spaces).
-@item
-@var{to}: This is the target of the action, which is either a channel
-or the Bot's nick.
-@item
-@var{action}: This is the text of the action. E.g. if someone did
-@samp{* foobar does baz}, then @var{action} would be the string
+That said, here is the list of available hooks functions.
+FIXME: write docs
+
+@defun hooks/action from to action
+This hook is triggered when someone performs an action. @var{from} is
+the address of the person that performed the action in the form
+@samp{@var{nick} ! @var{user} @@ @var{host}} (without the spaces).
+@var{to} is the target of the action, which is either a channel or the
+Bot's nick. @var{action} is the text of the action. E.g. if someone
+did @samp{* foobar does baz}, then @var{action} would be the string
@code{"does baz"}.
-@end itemize
-@end itemize
+@end defun
-@item
-@vindex hooks/nickname
-@code{hooks/nickname}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
-@item
-@vindex hooks/signoff
-@code{hooks/signoff}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/nickname old-nick new-nick
+This hook gets called when someone changes thir nickname from
+@var{old-nick} to @var{new-nick}.
+@end defun
-@item
-@vindex hooks/ctcp
-@code{hooks/ctcp}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/signoff nick rest
+@end defun
-@item
-@vindex hooks/ctcp-reply
-@code{hooks/ctcp-reply}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/ctcp nick to command rest
+@end defun
-@item
-@vindex hooks/disconnect
-@code{hooks/disconnect}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/ctcp-reply nick command rest
+@end defun
-@item
-@vindex hooks/flood
-@code{hooks/flood}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/disconnect ?
+[ Is this ever called? I can't find it in the source ]
+@end defun
-@item
-@vindex hooks/invite
-@code{hooks/invite}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/flood nick
+@end defun
-@item
-@vindex hooks/join
-@code{hooks/join}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/invite nick channel
+@end defun
-@item
-@vindex hooks/kick
-@code{hooks/kick}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/join nick channel
+@end defun
-@item
-@vindex hooks/part
-@code{hooks/part}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/kick target from channel reason
+@end defun
-@item
-@vindex hooks/mode
-@code{hooks/mode}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/leave nick channel
+@defunx hooks/part nick channel
+@end defun
-@item
-@vindex hooks/message
-@code{hooks/message}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/mode nick channel modes
+@end defun
-@item
-@vindex hooks/notice
-@code{hooks/notice}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/message from message
+@end defun
-@item
-@vindex hooks/public
-@code{hooks/public}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/notice nick message
+@end defun
-@item
-@vindex hooks/public-notice
-@code{hooks/public-notice}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/public from to message
+@end defun
-@item
-@vindex hooks/raw
-@code{hooks/raw}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/public-notice nick to message
+@end defun
-@item
-@vindex hooks/timer
-@code{hooks/timer}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/raw raw-message
+@end defun
-@item
-@vindex hooks/topic
-@code{hooks/topic}
-@itemize @minus
-@item
-Description of the hook
-@item
-# of args
-@itemize @minus
-@item
-@code{arg1}: desc
-@end itemize
-@end itemize
+@defun hooks/timer time
+This hook seems to be called once a minute. @var{time} is in
+@code{hh:mm} format.
+@end defun
-@item
-@vindex hooks/dcc/begin
-@code{hooks/dcc/begin}
-@itemize @minus
-@item
-This hook is triggered when a user begins a DCC CHAT with the bot.
-@item
-@var{FROM}
-@itemize @minus
-@item
-@var{FROM}: This is the user's address in the form
-@samp{nick!user@@host}.
-@end itemize
-@end itemize
+@defun hooks/topic nick channel new-topic
+@end defun
-@item
-@vindex hooks/dcc/message
-@code{hooks/dcc/message}
-@itemize @minus
-@item
-This hook is triggered when a user sends a message to the bot through
-a DCC CHAT
-@item
-@var{FROM} @var{MESSAGE}
-@itemize @minus
-@item
-@var{FROM}: This is the user's address in the form
-@samp{nick!user@@host}.
-@item
-@var{MESSAGE}: This is the message the user sent to the bot.
-@end itemize
-@end itemize
-@end itemize
+@defun hooks/send/public mynick dest message
+@end defun
+
+@defun hooks/send/message botnick message
+@end defun
+@defun hooks/send/action mynick to message
+@end defun
+
+@defun hooks/send/ctcp mynick to command message
+@end defun
+
+@defun hooks/dcc/chat-begin from
+This hook is triggered when a user begins a DCC CHAT with the bot.
+@var{from} is the user's address in the form @samp{nick!user@@host}.
+@end defun
+
+@defun hooks/dcc/chat-message from message
+This hook is triggered when a user sends a message to the bot through
+a DCC CHAT @var{from} is the user's address in the form
+@samp{nick!user@@host}. @var{message} is the message the user sent to
+the bot.
+@end defun
@node Scheme User Levels, Sending Messages, Hooks, Scripting
@section Scheme User Levels
@section Sending Messages
There are several types of messages you can send with Bobot++ from
-scripts. There is the simple, but rather limited, @code{bot:say},
-@code{bot:action} and @code{bot:msg}, and
-the more powerful, but lower level, @code{bot:send-MESSAGE}
-functions. Most bots will probably only need the higher level
-functions, but for the sake of why-not Bobot++ lets you use the lower
-level functions (in progress).
+scripts. There is the simple, but rather limited, @code{bot:say},
+@code{bot:action} and @code{bot:msg}, and the more powerful, but lower
+level, @code{bot:send-MESSAGE} functions. Most bots will probably only
+need the higher level functions, but for the sake of why-not Bobot++
+lets you use the lower level functions (in progress).
@menu
* High Level Message Functions::
@node High Level Message Functions, Low Level Message Functions, Sending Messages, Sending Messages
@subsection ``High Level'' Message Functions
-...
+@defun bot:say channel message
+Send a public or private @var{message} to @var{channel}.
+
+Sends a normal text message, as if a user had typed it in. The
+@var{dest} can be a nickname or a channel.
+@end defun
+
+@defun bot:action channel message
+Send an ``action'' type @var{message} to @var{channel}
+@end defun
+
+@defun bot:msg nick message
+The same as if a user typed @code{/msg nick message} to their IRC client.
+@end defun
@node Low Level Message Functions, , High Level Message Functions, Sending Messages
@subsection ``Low Level'' Message Functions
+@c Add a url for rfc2812
The ``Low Level'' messaging functions allow you to do things like send
CTCP messages. You probably want to read rfc 2812 and the CTCP spec
before using these. If you have no idea what these do, read rfc 2812
(IRC Client Protocol) and CTCP spec. These functions all return
-@code{*unspecified*} always, so don't use the return value for anything.
-
-@itemize @bullet
+@code{*unspecified*} always, so don't use the return value for
+anything.
-@item @code{bot:send-CTCP to command message}
+@defun bot:send-CTCP to command message
@code{to} is the target of your CTCP message, @code{command} is the
CTCP command, and @code{message} is the message (or arguments) of the
command. Make sure to @code{bot:ctcp-quote} the message!
-
-@end itemize
+@end defun
@node Misc Scripting Stuff, , Sending Messages, Scripting
@section Misc. Scripting Stuff
argumentless procedure (a thunk). When the bot exits your thunk will
be called.
+@quotation
+[ I didn't know where to put any of these, so I jsut stuck them in
+here.
+
+There probably needs to be several sections added, like dealing with
+users (kicking, added, etc), dealing with the bot (channels, nickname
+of the bot, etc), server issues (serverlist), useful tools (nslookup,
+whois), and do on. ]
+@end quotation
+
+
+@defun bot:adduser nick-or-mask cbannel-mask level prot auto-op
+Adds an user to the userlist, for a @code{nick!user@@host} matching the
+one given, on a channel matching the @var{channelMask} given.
+
+@multitable @columnfractions 0.33 0.33 0.33
+@item The @var{level} can be: @tab The @var{prot} can be: @tab The @var{auto-op} can be:
+@item 0 - No level @tab 0 - No protection @tab 0 - No auto-op
+@item 1 - User @tab 1 - No ban @tab 1 - Op on join
+@item 2 - Trusted User @tab 2 - No kick @tab
+@item 3 - Friend @tab 3 - No deop @tab
+@item 4 - Master @tab @tab
+@end multitable
+
+@end defun
+
+@c (3, 4, 0)
+@defun bot:addserver hostname ip-address [portnumber]
+Adds the server specified by @var{hostname} or @var{ip-address} to
+the server list.
+@end defun
+
+@c (3, 2, 0)
+@defun bot:addshit nick-or-mask channel-mask level [time reason]
+Adds an user to the shitlist, for a nick!user@@host matching the
+one given, on a channel matching the @var{channelMask} given.
+
+@display
+The @var{level} can be:
+ 0 - No shit
+ 1 - No op
+ 2 - Kick and Ban on join
+ 3 - Kick and Ban on join, no deban
+@end display
+
+@end defun
+
+@c (2, 0, 0)
+@defun bot:ban channel mask-or-nick
+Bans @var{mask} or @var{nick} from @var{channel}. You need to be a trusted
+user to ban with a @var{mask}.
+@end defun
+
+@c (2, 0, 0)
+@defun bot:change-command-level nick-or-mask channel-mask new-level
+Gives @var{nick} or @var{mask} level @var{new-level} on channel(s)
+@var{channel-mask}. Note that you can not change level for someone
+whose level is greater than yours, and that you can not give a
+level greater than yours.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:cycle channel
+Makes the bot leave and join @var{channel}.
+@end defun
+
+@c (2, 0, 0)
+@defun bot:deban channel mask-or-nick
+Debans @var{mask} or @var{nick} from @var{channel}. You need to be a trusted
+user to deban with a @var{mask}.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:delserver server-number
+Deletes server from server list whose number in the server list
+is @var{server-number}
+@end defun
+
+@c (2, 0, 0)
+@defun bot:deluser nick-or-mask channel-mask
+Removes @var{nick} or @var{mask} from the userlist.
+@end defun
+
+@c (2, 0, 0)
+@defun bot:delshit nick-or-mask channel-mask
+Removes @var{nick} or @var{mask} from the shitlist.
+@end defun
+
+@c (2, 0, 0)
+@defun bot:deop channel mask-or-nick
+Deops @var{mask} or @var{nick} on @var{channel}.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:die reason
+Makes the bot stop immediately.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:do ?
+@end defun
+
+@c (2, 0, 0)
+@defun bot:invite channel nick
+Invites @var{nick} on @var{channel}.
+@end defun
+
+@c (1, 1, 0)
+@defun bot:join channel
+Makes the bot join @var{channel}.
+@end defun
+
+@c (2, 0, 0)
+@defun bot:keep channel modes
+Sets the @var{modes} that the bot will keep for @var{channel}.
+See also STATS.
+@end defun
+
+@c (2, 1, 0)
+@defun bot:kick channel mask-or-nick [reason]
+Kicks @var{mask} or @var{nick} out of @var{channel}, because of @var{reason}.
+You need to be a trusted user to use a @var{mask}.
+@end defun
+
+@c (2, 1, 0)
+@defun bot:kickban channel mask-or-nick [reason]
+Bans then kicks @var{mask} or @var{nick} out of @var{channel},
+because of @var{reason}.
+You need to be a trusted user to use a @var{mask}.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:lock channel
+Locks topic on @var{channel}.
+@end defun
+
+@c (0, 0, 0)
+@defun bot:logport
+[ Probably returns the log port? ]
+@end defun
+
+@c (2, 0, 0)
+@defun bot:mode channel mode-string
+Sends @var{mode-string} as mode for @var{channel}.
+@end defun
+
+@c (0, 0, 0)
+@defun bot:nextserver
+Makes the bot connect to the next server in its server list.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:nick nick
+Makes the bot use nickname @var{nick}.
+@end defun
+
+@c (2, 0, 0)
+@defun bot:op channel nick
+Ops @var{nick} on @var{channel}.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:part channel
+Makes the bot leave @var{channel}.
+@end defun
+
+@c (0, 0, 0)
+@defun bot:reconnect
+Makes the bot reconnect to its current server.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:server server-number
+Select the server to connect to. @var{server-number} is the number of
+the server in the serverlist.
+@end defun
+
+@c (1, 0, 0)
+@defun bot:setfloodrate ?
+@end defun
+
+@c (1, 0, 0)
+@defun bot:setversion ?
+@end defun
+
+@c (3, 0, 0)
+@defun bot:tban channel nick-or-mask time
+Bans @var{nick} or @var{mask} from @var{channel} for @var{time} seconds.
+@end defun
+
+@c (3, 1, 0)
+@defun bot:tkban channel nick-or-mask time [reason]
+Bans @var{nick} or @var{mask} from @var{channel} for @var{time} seconds,
+then kicks him/them because of @var{reason}.
+@end defun
+
+@c (2, 0, 0)
+@defun bot:topic channel topic
+If no @var{topic} is given, prints @var{channel}'s topic. Otherwise,
+the bot will change @var{channel}'s topic to @var{topic}.
+@end defun
+
+@defun bot:unlock channel
+Makes the bot unlock topic on @var{channel}.
+@end defun
+
+@c (0, 0, 0)
+@defun bot:getnickname
+[ Gets the bot's nickname? ]
+@end defun
+
+@c (0, 0, 0)
+@defun bot:getserver
+@end defun
+
+@c (0, 0, 0)
+@defun bot:getserverlist
+@end defun
+
+@c (0, 0, 0)
+@defun bot:flush
+[ Flushes the socket to the server? ]
+@end defun
+
+@c (0, 0, 0)
+@defun bot:flushport
+[ Flushes the log port? ]
+@end defun
+
+@c (1, 0, 0)
+@defun bot:random ?
+[ Returns a random number? What range? Why? ]
+@end defun
+
+@c (1, 0, 0)
+@defun bot:delcommand
+[ Probably deletes a command added with @code{bot:addcommand} ? ]
+@end defun
+
+@c (2, 0, 0)
+@defun bot:addtimer ? ?
+@end defun
+
+@c (1, 0, 0)
+@defun bot:deltimer ?
+@end defun
+
+@c (2, 0, 0)
+@defun bot:dcc-chat-send ? ?
+@end defun
+
+@quotation
+[ And what about the stuff defined in @file{bobot-utils.scm} ? I just
+added it here so it could be somewhere. There should also be a
+section dealing with modules. How to use them. What module scripts
+are in. What module bobot++ provided primites are in. And so on. ]
+@end quotation
+
+@defun bot:log . messages
+Write as many @var{messages} as you want to the log. If the arg is a
+thunk it will be executed and it's output will be written to the log.
+@end defun
+
+@defun bot:load file
+@end defun
+
+@defun bot:load-module module-spec
+@end defun
+
+@defun bot:use-module module-spec
+@end defun
+
+@defun bot:match-not-channel regex
+match-not-channel adds a prefix regex to your @var{regex} so it
+doesn't match the sender or channel in a PUBLIC message
+@end defun
+
+@defun bot:match-to-me regex
+match-to-me matches text that was addressed to the bot with a
+':', ',', or nothing after the bot name.
+@end defun
+
+@defun bot:sent-to-me? message
+@end defun
+
+@defun bot:ctcp-quote message
+Returns the CTCP quoted message
+Input @emph{MUST NOT} contain the trailing @code{\r\n}
+(it is added by the message sending code).
+@end defun
+
+
+@defvar %bot:loadpath
+@end defvar
+
+@defun %bot:load-extensions
+@end defun
+
+
+
@node Concept Index, Function Index, Scripting, Top
@unnumbered Concept Index
@printindex cp
HCoop / clinton / bobotpp.git / blobdiff