X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=files%2Fblootbot.help;h=2044d086a9e3e23c6039e3f15a280a8fde20e089;hb=b99961b44489812effb7b7c676ef2c8879694534;hp=63fa50790cfcc32126d2939c295929c8a505b514;hpb=508d0ee492cc5c6d38eefa3ee78c7926728398de;p=infobot.git diff --git a/files/blootbot.help b/files/blootbot.help index 63fa507..2044d08 100644 --- a/files/blootbot.help +++ b/files/blootbot.help @@ -1,106 +1,189 @@ -# Revised: 19991109. -# Author: xk +# Revised: 20050224 +# Author: Tim Riker ### main: I learn mainly by observing declarative statements such as "x is at http://www.xxx.com", and then reply when people ask things like "where can i find x?" -literal: used to get a raw factoid contents -literal: U: ## -literal: E: ## blootbot +action: This is used to override the usual response. "x is does the hokey-pokey". When asked about x, the bot does this "* blootbot does the hokey-pokey" + +alternation: The || symbol in an entry causes an blootbot to choose one of the replies at random. "X is Y||Z" will produce "X is Y" or "X is Z" randomly. author: oznoid (mailto:lenzo@ri.cmu.edu) is my original author. +dollar variables: D: To be used in factoids +dollar variables: $Fdunno - ... +dollar variables: $Fquestion - ... +dollar variables: $Fupdate - ... +dollar variables: $channel - channel from which the factoid was requested +dollar variables: $date - current date (GMT) +dollar variables: $day - day of week (full name, locale) +dollar variables: $factoids - factoid count +dollar variables: $host - hostname of factoid requester +dollar variables: $ident - bot nick +dollar variables: $lastspeaker - ... +dollar variables: $memusage - ... +dollar variables: $rand - random number, also $rand100.2 +dollar variables: $randnick - random nick +dollar variables: $startTime - start time +dollar variables: $time - current time (GMT) +dollar variables: $uptime - ... +dollar variables: $user - username of factoid requester +dollar variables: $who - nick of factoid requester + corrections: If I come back with "...but x is at http://xx.xx.xx" or something like that, and you want to change the entry, use "no, x is at http://sdfsdfsdf". The "No," tells me to supercede the existing value. corrections: you can append stuff to a factoid with "also". "x is also at ..." -action: This is used to override the usual response. "x is does the hokey-pokey". When asked about x, the bot does this "* blootbot does the hokey-pokey" - -reply: There is a special tag, , that is used to override the usual response. Usually, a response is "X is Y", but it can be made "Y" by making the entry "X is Y". - -alternation: The || symbol in an entry causes an blootbot to choose one of the replies at random. "X is Y||Z" will produce "X is Y" or "X is Z" randomly. +math: D: math expresions can be evaluated. This uses Perl syntax. +math: E: 1+1 +math: + - add +math: - - subtract +math: * - multiply +math: / - division +math: ** - to the power +math: pi - pi +math: & - and +math: | = or +math: ^ - xor redirection: If a factoid x contains simply " see y", then when asked for x, I will deliver factoidor command result y instead. +reply: There is a special tag, , that is used to override the usual response. Usually, a response is "X is Y", but it can be made "Y" by making the entry "X is Y". + # now the commands... -lobotomy: I can be given a lobotomy ([o] is required) if people start to abuse me. To bring me back to life, give me an unlobotomy -unlobotomy: Which is not possible in real life, an unlobotomy will bring me back to life in the case of a lobotomy. +adduser: D: Administrative command to add new user to the .users file +adduser: U: ## +adduser: E: ## bloot bloot!bloot@example.com addressing: It is a good idea if I stay in REQUIRE mode so that I won't yell out random crap if I listen in too hard. Currently there is no way to turn this off on-the-fly. (REQUIRE mode requires me to be addressed by name if I am to respond) -forget: If I have an old/redundant factoid x, "forget x" will cause me to erase it. +babelfish: D: Frontend to babelfish translating service provided by http://babelfish.altavista.com/ Note that utf8 is used for non-ascii characters. +babelfish: U: x +babelfish: U: translate +babelfish: E: x en de your cars rock -unforget: If a factoid has been forgotten, "unforget x" will cause me to unerase it. +-ban: D: FIXME: +-ban: U: ## +-ban: E: ## *!*@owns.org +-ban: E: ## MoronMan -find: D: Debian Packages (fallback to Contents) search -find: U: ## [dist] -find: E: ## strings.h -find: E: ## x11amp potato ++ban: D: FIXME: ++ban: U: ## [chan] [time] [reason] ++ban: E: ## *!*@owns.org #bots 60 stop flooding. ++ban: E: ## *!*@*microsoft.com STOOPID ++ban: E: ## MoronMan + +botmail: D: Send someone botmail +botmail: U: ## {for [:] }|stats|check|read +botmail: E: ## for infobot: you rock! +botmail: E: ## stats +botmail: E: ## check +botmail: E: ## read + +-chan: D: Leave a channel permanently +-chan: U: ## -#channel +-chan: E: ## -#botpark + ++chan: D: Join a channel permanently ++chan: U: ## #channel ++chan: E: ## #botpark + +chaninfo: D: Display channel statistics on Op, Ban, Deop, Unban, Part, Join, SignOff, PublicMsg, Kick and Topic +chaninfo: U: ## [#channel] +chaninfo: E: ## +chaninfo: E: ## #botpark + +chanset: D: set a variable for a channel +chanset: U: ## [#chan] [what] [val] +chanset: E: ## #c +test +chanset: E: ## #c -test +chanset: E: ## #c test +chanset: E: ## #c test 0 +chanset: E: ## #c test testing123 + +chanunset: D: remove a variable from a channel +chanunset: U: ## <#chan> [what] +chanunset: E: ## #c +chanunset: E: ## #c test + +chattr: D: Change flags on a user (see @regFlagsUser in source) +chattr: U: ## [flags] +chattr: E: ## bloot +nmo +chattr: E: ## bloot -ot +chattr: E: ## bloot + +chnick: D: rename a nick (user) entry +chnick: U: ## [nick] +chnick: E: ## moron +chnick: E: ## owner eleet + +chpass: D: Change a user's password +chpass: U: ## [user] +chpass: E: ## testing +chpass: E: ## testing test0R contents: D: Debian Contents search only (no Packages) contents: U: ## [dist] contents: E: ## strings.h contents: E: ## x11amp potato +cookie: I can feed your appetite with random factoids. + +cpustats: cpustats dumps the bot's cpu usage this session + +crypt: It's good that you thought about encryption. I can do it for you. +crypt: U: ## +crypt: E: ## 69 changeme +crypt: E: ## $1$abcde changeme + +cycle: D: Causes me to cycle in the channel it's said, or in the named channel +cycle: U: ## [channel] +cycle: E: ## +cycle: E: ## #botpark + dauthor: D: Find Debian package maintainers, and list the packages they maintain dauthor: U: ## [dist] dauthor: E: ## Wichert dauthor: E: ## Wichert potato +dbugs: D: Show the current count of release critical bugs (latest versions) +dbugs: U: ## + +deluser: D: Administrative command to remove a user from the .users file +deluser: U: ## +deluser: E: ## bloot + ddesc: D: Search the Description: lines in Debian packages ddesc: U: ## [dist] ddesc: E: ## mule ddesc: E: ## mule potato -bugs: D: Show the current count of release critical bugs (latest versions) -bugs: U: ## +dfind: D: Debian Packages (fallback to Contents) search +dfind: U: ## [dist] +dfind: E: ## strings.h +dfind: E: ## x11amp potato + +dict: D: DICT Protocol Client - likely dicts: elements web1913 wn gazetteer jargon foldoc easton hitchcock devils world02 vera +dict: U: ## [entry num] [/dict] +dict: E: ## linux +dict: E: ## 33 set/wn + +dns: D: Query DNS +dns: U: ## +dns: E: ## debian.org +dns: E: ## 3.1.33.7 + +do: D: operator command to do things in a channel +do: U: ## dstats: D: Show basic stats on the current size of the Debian distros dstats: U: ## [dist] dstats: E: ## dstats: E: ## potato -uptime: D: Show the current uptime, and the top 3 uptimes recorded -uptime: U: ## - -rename: D: Factoid renaming -rename: U: ## 'from' 'to' -rename: E: ## 'infobot' 'blootbot' - -nslookup: D: Query DNS -nslookup: U: ## -nslookup: E: ## debian.org -nslookup: E: ## 3.1.33.7 - -spell: You've guessed it right, I'm a spell checker. Give me any word and I can confirm whether it's good or bad. - -crypt: It's good that you thought about encryption. I can do it for you. -crypt: U: ## -crypt: E: ## 69 changeme - -join: U: ## <#chan> [key] -join: E: ## #debian -join: E: ## #debian rules - -kick: U: ## [#chan] -kick: E: ## oznoid -kick: E: ## larne #debian - -wantnick: If someone's taken my nick (I hope not) and I'm using some temporary nick, I can change back to my original nick if it's not taken (again). - -chaninfo: D: Display channel statistics on Op, Ban, Deop, Unban, Part, Join, SignOff, PublicMsg, Kick and Topic -chaninfo: U: ## [#channel] -chaninfo: E: ## -chaninfo: E: ## #debian - -dict: D: DICT Protocol Client -dict: U: ## -dict: E: ## AI -dict: E: ## 1 linux - -freshmeat: D: Frontend to www.freshmeat.net -freshmeat: U: ## -freshmeat: E: ## blootbot +factinfo: D: View statistical information about a particular factoid. +factinfo: U: ## +factinfo: E: ## test factstats: D: Display statistical data (max of 15) about factoids. factstats: U: ## @@ -125,11 +208,49 @@ factstats: == unrequest -- unrequested factoids. factstats: == vandalism -- ?? factstats: E: ## new +forget: If I have an old/redundant factoid x, "forget x" will cause me to erase it. + +freshmeat: D: Frontend to www.freshmeat.net +freshmeat: U: ## +freshmeat: E: ## blootbot + +hex: D: Convert ascii to hex +hex: U: ## +hex: E: ## carrot + +httpdtype: D: Get httpd server software version / configuration +httpdtype: U: ## +httpdtype: E: ## example.com + +ignore: D: ignore list management +ignore: E: ## [mask chan expire comment] +ignore: E: addignore guu!*@* + +ircstats: ircstats dumps some status information on the bot's IRC connection + +join: U: ## <#chan> [key] +join: E: ## #botpark +join: E: ## #botpark rules + +karma: Karma is a community rating system. Use "X++" to increase the karma, or "X--" to decrease it. Ask for ratings using "karma for X?" + +kernel: D: Frontend to linux.kernel.org's finger response. +kernel: U: ## + +kick: U: ## [#chan] [message] +kick: E: ## oznoid +kick: E: ## larne #botpark +kick: E: ## john #foo go away! + lart: D: Luser Attitude Readjustment Tool lart: U: ## [#chan] lart: E: ## lenzo infobot's bugginess lart: E: ## #perl everyone perl \=\= lamerville +lc: D: lower case a given string +lc: U: ## +lc: E: ## When will blootbot achieve world domination? + listauth: D: Search the factoid extension db by creator listauth: U: ## listauth: E: ## xk @@ -142,10 +263,130 @@ listvalues: D: Search the factoid database by value (description) listvalues: U: ## listvalues: E: ## blootbot +literal: used to get a raw factoid contents. Use _default to ignore factoidSearch path. +literal: U: ## [_default|prefix] +literal: E: ## blootbot + +lobotomy: I can be given a lobotomy ([o] is required) if people start to abuse me. To bring me back to life, give me an unlobotomy + +lock: D: Factoid locking to prevent removal by others +lock: U: ## +lock: E: ## abuse +lock: N: By default, only registered "ops" on the bots or factoids matching the user's nick are able to lock factoids. +lock: N: Requires factoid extension (extra) support enabled. + +md5: D: calculates the md5sum of a given string +md5: U: ## +md5: E: ## When will blootbot achieve world domination? + +mode: set modes for a channel +mode: U: ## <#chan> +mode: E: ## #botpark +t +mode: E: ## #botpark -i + +news: D: News functions +news: U: ## [chan] + +news add: D: Add news items +news add: U: news [chan] add +news add: E: news add This is a test +news add: see _news set Text_ aswell + +news set: D: Set stuff for news item +news set: U: news [chan] set <item> <what> [value] +news set: valid <what>: Expire, Text +news set: E: news set 1 Text ok, this works +news set: E: news set test Text and this is a test +news set: E: news set test Text + +news set expire: D: Set expire for news item +news set expire: U: news [chan] expire <what> <value> +news set expire: value can be: Xd Xh Xm Xs +news set expire: value can be: never +news set expire: news expire 1 3days +news set expire: news expire 2 +20d +news set expire: news expire Test 30d 20h 10m 5s +news set expire: news expire TEST never + +news del: D: Delete news item (requires +o or be author) +news del: U: news [chan] del <item> +news del: E: news del 1 +news del: E: news del test + +news mod: D: Modify a news item (todo: modify Text aswell) +news mod: E: news [chan] mod <item> s/<from>/<to>/[g] +news mod: E: news mod 1 s/test/Test/ +news mod: E: news mod test s/test/Test/g + +nickometer: D: Measures the lame-ness of a nick or channel +nickometer: U: ## {nick,channel} +nickometer: E: ## unknown_lamer +nickometer: E: ## #botpark + +onjoin: D: get/set OnJoin message (needs chan option +OnJoin) +onjoin: U: ## [#chan|_default] [-]<nick> [message] +onjoin: E: ## blootbot Hey! It's another blootbot! + +ord: D: Convert ascii to decimal +ord: U: ## <single character> +ord: E: ## c + +page: D: Send someone a pager message +page: U: ## <who> <message> +page: E: ## infobot you rock! +page: NOTE: this uses the "<who>'s pager" factoids for the From: and To: addresses of the format "example's pager" is "mailto:me@example.com" + +part: D: Leave a channel (DCC only) +part: U: ## <#channel> +part: E: ## #botpark +part: NOTE: /kick is an alternative + +piglatin: D: translates english text into piglatin +piglatin: U: ## <string> +piglatin: E: ## When will blootbot achieve world domination? + quote: D: Frontend to yahoo's online stock market share listing quote: U: ## <query...> quote: E: ## RHAT,MSFT +rename: D: Factoid renaming +rename: U: ## 'from' 'to' +rename: E: ## 'infobot' 'blootbot' + +reverse: D: reverses a given string +reverse: U: ## <string> +reverse: E: ## When will blootbot achieve world domination? + +rot13: D: ROT13's a given string +rot13: U: ## <string> +rot13: E: ## guvf vf n ynzr rknzcyr + +say: D: operator command to say things in a channel +say: U: ## <chan> <what> + +scramble: D: scrambles a given string +scramble: U: ## <string> +scramble: E: ## When will blootbot achieve world domination? + +search: U: ## <engine> for <string> +search: E: ## google for blootbot + +seen: D: Report last seen time for somebody +seen: U: ## <nick> +seen: E: ## blootbot + +slashdot: D: News for nerds, Stuff that matters. [tm] (shows the headlines) +slashdot: U: ## + +spell: You've guessed it right, I'm a spell checker. Give me any word and I can confirm whether it's good or bad. + +status: status dumps general status information + +tell: D: Tell someone about a factoid or command +tell: U: ## <who> -?about <what> +tell: E: ## me about blootbot +tell: E: ## someone -about testing + topic add: D: Add your own topic topic add: U: ## <topic> topic add: E: ## This is a test @@ -158,8 +399,8 @@ topic del: E: ## last topic mod: D: Search and replace strings in the topic topic mod: U: ## <REGEX> -topic mod: E: s/test/TEST/ -topic mod: E: s#msg test#/msg test#g +topic mod: E: ## s/test/TEST/ +topic mod: E: ## s#msg test#/msg test#g topic mv: D: Move subtopics around. topic mv: U: ## <#> <before|after|swap> <#> @@ -186,182 +427,44 @@ topic: info - Who and time info. topic: ---------------- __Misc__ topic: about - Read the file :) topic: help - This screen. + topic: NOTE: #chan arg is only required if command is sent over private message to nick, otherwise it is not needed if sent to the channel. topic: NOTE: commands can be preceeded? with '-' in order not to enforce changes to topic. topic: End of help. -part: D: Leave a channel (DCC only) -part: U: ## <#channel> -part: E: ## #debian -part: NOTE: /kick is an alternative - -seen: D: Report last seen time for somebody -seen: U: ## <nick> -seen: E: ## blootbot - -factinfo: D: View statistical information about a particular factoid. -factinfo: U: ## <factoid> -factinfo: E: ## test - -cookie: I can feed your appetite with random factoids. - -slashdot: D: News for nerds, Stuff that matters. [tm] (shows the headlines) -slashdot: U: ## +uc: D: upper case a given string +uc: U: ## <string> +uc: E: ## When will blootbot achieve world domination? -babelfish: D: Frontend to babelfish translating service provided by http://babelfish.altavista.com/ Note that utf8 is used for non-ascii characters. -babelfish: U: x <fromLang> <toLang> <words> -babelfish: U: translate <fromLang> <toLang> <words> -babelfish: E: x en de your cars rock - -search: U: ## <engine> for <string> -search: E: ## google for evil - -karma: Karma is a community rating system. Use "X++" to increase the karma, or "X--" to decrease it. Ask for ratings using "karma for X?" - -kernel: D: Frontend to linux.kernel.org's finger response. -kernel: U: ## +unforget: If a factoid has been forgotten, "unforget x" will cause me to unerase it. -lock: D: Factoid locking to prevent removal by others. -lock: U: ## <factoid> -lock: E: ## abuse -lock: N: By default, only registered "ops" on the bots or factoids matching the user's nick are able to lock factoids. -lock: N: Requires factoid extension (extra) support enabled. +unlobotomy: Not possible in real life, an unlobotomy will bring me back to life in the case of a lobotomy. unlock: D: Factoid unlocking to allow removal by others. unlock: U: ## <factoid> unlock: E: ## abuse -dollar variables: D: To be used in factoids -dollar variables: $Fdunno - ... -dollar variables: $Fquestion - ... -dollar variables: $Fupdate - ... -dollar variables: $channel - channel from which the factoid was requested -dollar variables: $date - current date -dollar variables: $factoids - factoid count -dollar variables: $host - hostname of factoid requester -dollar variables: $ident - bot nick -dollar variables: $lastspeaker - ... -dollar variables: $memusage - ... -dollar variables: $rand - random number, also $rand100.2 -dollar variables: $randnick - random nick -dollar variables: $startTime - start time -dollar variables: $time - current time -dollar variables: $uptime - ... -dollar variables: $user - username of factoid requester -dollar variables: $who - nick of factoid requester - -chanset: D: FIXME -chanset: U: ## [#chan] [what] [val] -chanset: E: ## #c +test -chanset: E: ## #c -test -chanset: E: ## #c test -chanset: E: ## #c test testing123 - -chanunset: D: FIXME. -chanunset: U: ## <#chan> [what] -chanunset: E: ## #c -chanunset: E: ## #c test - -chpass: D: FIXME. -chpass: U: ## [user] <pass> -chpass: E: ## testing -chpass: E: ## testing test0R +uptime: D: Show the current uptime, and the top 3 uptimes recorded +uptime: U: ## -chattr: D: FIXME. -chattr: U: ## <user> [flags] -chattr: E: ## bloot +nmo -chattr: E: ## bloot -ot -chattr: E: ## bloot +wantnick: If someone's taken my nick (I hope not) and I'm using some temporary nick, I can change back to my original nick if it's not taken (again). -chnick: D: FIXME. -chnick: U: ## [nick] <new-nick> -chnick: E: ## moron -chnick: E: ## owner eleet +wikipedia: D: Frontend to the Wikipedia at http://www.wikipedia.org/wiki/ Note that utf8 is used for non-ascii characters. +wikipedia: U: ## <topic> +wikipedia: U: wiki <topic> +wikipedia: E: wiki irc -+host: D: FIXME. -+host: U: ## [user] <mask> -+host: E: ## *!*@owns.org -+host: E: ## owner leet!leet@*.heh.org +wtf: D: Interface to the BSD wtf command +wtf: U: ## <abbreviation> +wtf: E: ## iirc --host: D: FIXME. +-host: D: admin command to remove hostmask from a user account -host: U: ## [user] <mask> -host: E: ## *!*@owns.org -host: E: ## owner leet!leet@*.heh.org -+ban: D: FIXME. -+ban: U: ## <mask|user> [chan] [time] [reason] -+ban: E: ## *!*@owns.org #bots 60 stop flooding. -+ban: E: ## *!*@*microsoft.com STOOPID -+ban: E: ## MoronMan - --ban: D: FIXME. --ban: U: ## <mask|user> --ban: E: ## *!*@owns.org --ban: E: ## MoronMan - -ircstats: ircstats dumps some status information on the bot's IRC connection - -status: status dumps general status information - -cpustats: cpustats dumps the bot's cpu usage this session - -ord: D: Convert ascii to decimal -ord: U: ## <single character> -ord: E: ## c - -hex: D: Convert ascii to hex -hex: U: ## <string> -hex: E: ## carrot - -cycle: D: Causes me to cycle in the channel it's said, or in the named channel -cycle: U: ## [channel] -cycle: E: ## -cycle: E: ## #debian-bots - -rot13: D: ROT13's the given string -rot13: U: ## <string> -rot13: E: ## guvf vf n ynzr rknzcyr - -nickometer: D: Measures the lame-ness of a nick or channel -nickometer: U: ## {nick,channel} -nickometer: E: ## unknown_lamer -nickometer: E: ## #debian-bots - -news: D: News functin -news: U: ## [chan] <add,del,mod,set,latest,read,help> - -news add: D: Add news items -news add: U: news [chan] add <title> -news add: E: news add This is a test -news add: see _news set Text_ aswell - -news set: D: Set stuff for news item -news set: U: news [chan] set <item> <what> [value] -news set: valid <what>: Expire, Text -news set: E: news set 1 Text ok, this works -news set: E: news set test Text and this is a test -news set: E: news set test Text - -news set expire: D: Set expire for news item -news set expire: U: news [chan] expire <what> <value> -news set expire: value can be: Xd Xh Xm Xs -news set expire: value can be: never -news set expire: news expire 1 3days -news set expire: news expire 2 +20d -news set expire: news expire Test 30d 20h 10m 5s -news set expire: news expire TEST never - -news del: D: Delete news item (requires +o or be author) -news del: U: news [chan] del <item> -news del: E: news del 1 -news del: E: news del test - -news mod: D: Modify a news item (todo: modify Text aswell) -news mod: E: news [chan] mod <item> s/<from>/<to>/[g] -news mod: E: news mod 1 s/test/Test/ -news mod: E: news mod test s/test/Test/g - -tell: D: Tell someone about a factoid or command -tell: U: tell <who> -?about <what> -tell: E: tell me about blootbot -tell: E: tell someone -about testing ++host: D: admin command to list or add hostmasks to a user account ++host: U: ## [user] [<mask>] ++host: E: ## owner ++host: E: ## *!*@owns.org ++host: E: ## owner leet!leet@*.heh.org