X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=files%2Finfobot.help;h=cace7d15f3d3437dd0f86f9380ee1cb6e5c8f337;hb=e029359714e3bff3e6d4e816cb16695bacd79f59;hp=04abac41beb3db8ed70548cf9bdb9266d538538e;hpb=bb482ed34735d13cad2a02cf0f5cdc322b6b9f89;p=infobot.git diff --git a/files/infobot.help b/files/infobot.help index 04abac4..cace7d1 100644 --- a/files/infobot.help +++ b/files/infobot.help @@ -1,136 +1,449 @@ -# Revised: 19991109. -# Author: xk +# Revised: 20090320 +# Author: Tim Riker +# Contributors: Simon C., Tim M., others (see AUTHORS) ### +# Special entry 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?" -author: oznoid (mailto:lenzo@ri.cmu.edu) is my original author. - -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 "* infobot does the hokey-pokey" +action: This is used to override the usual response. "x is does the hokey-pokey". When asked about x, the bot does this "* infobot 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". -reply: This is a good way to close junk entries; use "X is " with nothing after it. +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) -alternation: The || symbol in an entry causes an infobot to choose one of the replies at random. "X is Y|Z" will produce "X is Y" or "X is Z" randomly. +alternation: The || symbol in an entry causes an infobot to choose one of the replies at random. "X is Y||Z" will produce "X is Y" or "X is Z" randomly. -# 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 +author: oznoid (mailto:lenzo@ri.cmu.edu) is my original author. -unlobotomy: which is not possible in real life, an unlobotomy will bring me back to life in the case of a lobotomy. +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 + +bandel: D: FIXME: +bandel: U: ## +bandel: E: ## *!*@owns.org +bandel: E: ## MoronMan + +banadd: D: FIXME: +banadd: U: ## [chan] [time] [reason] +banadd: E: ## *!*@owns.org #bots 60 stop flooding. +banadd: E: ## *!*@*microsoft.com STOOPID +banadd: 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 + +chanadd: D: Join a channel permanently +chanadd: U: ## #channel +chanadd: E: ## #botpark + +chandel: D: Leave a channel permanently +chandel: U: ## -#channel +chandel: 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 "help flags") +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 + +convert: D: Convert from one unit to another +convert: U: ## [number] to +convert: E: ## 55 degF to degC +convert: E: ## 60 mph to kph +convert: E: ## 60 miles per hour to km/hour +convert: E: ## gallons to cm^3 + +cookie: I can feed your appetite with random factoids. -addressing: it is a good idea if i stay in REQUIRE mode then i won't yell out random crap if i listen in too hard. currently there is no way to turn this of on-the-fly. +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 ..." -forget: FIXME +cpustats: cpustats dumps the bot's cpu usage this session -find: D: Debian Packages (fallback to Contents) Search -find: U: ## [dcc] [dist] -find: E: ## strings.h -find: E: ## dcc usr/bin -find: E: ## slink x11amp +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 -rename: D: Factoid renaming. -rename: U: ## 'from' 'to' -rename: E: ## 'infobot' 'blootbot' +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 -nslookup: D: Query DNS. -nslookup: U: ## -nslookup: E: ## debian.org -nslookup: E: ## 3.1.33.7 +dauthor: D: Find Debian package maintainers, and list the packages they maintain +dauthor: U: ## [dist] +dauthor: E: ## Wichert +dauthor: E: ## Wichert potato -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. +dbugs: D: Show the current count of release critical bugs (latest versions) +dbugs: U: ## -crypt: it's good that you thought about encryption. i can do it for you. -crypt: U: ## -crypt: E: ## changeme 69 +ddesc: D: Search the Description: lines in Debian packages +ddesc: U: ## [dist] +ddesc: E: ## mule +ddesc: E: ## mule potato -join: U: ## <#chan> [key] -join: E: ## #debian -join: E: ## #debian rules +dfind: D: Debian Packages (fallback to Contents) search +dfind: U: ## [dist] +dfind: E: ## strings.h +dfind: E: ## x11amp potato -kick: U: ## [#chan] -kick: E: ## oznoid -kick: E: ## larne #debian +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 -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). +dns: D: Query DNS +dns: U: ## +dns: E: ## debian.org +dns: E: ## 3.1.33.7 -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 +do: D: operator command to do things in a channel +do: U: ## -dict: D: DICT Protocol Client. -dict: U: ## -dict: E: ## AI -dict: E: ## 1 linux +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: $urlchannel - html encoded channel from which the factoid was requested +dollar variables: $user - username of factoid requester +dollar variables: $who - nick of factoid requester + +dstats: D: Show basic stats on the current size of the Debian distros +dstats: U: ## [dist] +dstats: E: ## +dstats: E: ## potato -freshmeat: D: Frontend to www.freshmeat.net -freshmeat: U: ## -freshmeat: E: ## infobot +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: ## factstats: == author -- top author of factoids. -factstats: == broken -- broken factoids. -factstats: == dupe -- duplicate factoids. +factstats: == deadredir -- ?? +factstats: == duplicate -- duplicate factoids. +factstats: == listfix -- ?? factstats: == locked -- locked factoids. factstats: == new -- recent addition of factoids. +factstats: == nullfactoids -- ?? factstats: == partdupe -- initial partial duplicate factoids. factstats: == profanity -- possibly offensive factoids. factstats: == redir -- redirection in factoids. +factstats: == reqrate -- ?? factstats: == requested -- most requested factoids. +factstats: == requesters -- most requested factoids. +factstats: == seefix -- ?? factstats: == toolong -- factoid {key|value} exceeding specified length. +factstats: == tooshort -- factoid {key|value} shorter than specified length. +factstats: == total -- ?? factstats: == unrequest -- unrequested factoids. +factstats: == vandalism -- ?? factstats: E: ## new +flags: D: Flags for chattr command +flags: D: "A" - bot administration over /msg (default is only via DCC CHAT) +flags: D: "O" - dynamic ops (as on channel). (automatic +o) +flags: D: "T" - add topics. +flags: D: "a" - ask/request factoid. +flags: D: "m" - modify all factoids. (includes renaming) +flags: D: "M" - modify own factoids. (includes renaming) +flags: D: "n" - bot owner, can "reload" +flags: D: "o" - master of bot (automatic +amrt) +flags: D: - can search on factoid strings shorter than 2 chars +flags: D: - can tell bot to join new channels +flags: D: - can [un]lock factoids +flags: D: "r" - remove factoid. +flags: D: "t" - teach/add factoid. +flags: D: "s" - Bypass +silent on channels + +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: ## infobot + +google: D: What Is: Google Search frontend +google: D: Configuration: "chanset [_default or channelname] +Google" +google: U: ## google +google: E: ## google infobot + +hex: D: Convert ascii to hex +hex: U: ## +hex: E: ## carrot + +hex2ip: D: Convert Hex idents for some gateways to an IP address +hex2ip: U: ## <8 char hex value> +hex2ip: E: ## AabBcC12 + +hostadd: D: admin command to list or add hostmasks to a user account +hostadd: U: ## [user] [] +hostadd: E: ## owner +hostadd: E: ## *!*@owns.org +hostadd: E: ## owner leet!leet@*.heh.org + +hostdel: D: admin command to remove hostmask from a user account +hostdel: U: ## [user] +hostdel: E: ## *!*@owns.org +hostdel: E: ## owner leet!leet@*.heh.org + +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?". Karma updates must be in a channel, not private. + +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 -listauth: D: Search the factoid extension db by creator. +lc: D: lower case a given string +lc: U: ## +lc: E: ## When will infobot achieve world domination? + +listauth: D: Search the factoid extension db by creator listauth: U: ## listauth: E: ## xk -listkeys: D: Search the factoid database by key (factoid). +listkeys: D: Search the factoid database by key (factoid) listkeys: U: ## listkeys: E: ## infobot -listvalues: D: Search the factoid database by value (description). +listvalues: D: Search the factoid database by value (description) listvalues: U: ## listvalues: E: ## infobot -quote: D: Frontend to yahoo's online stock market share listing. -quote: U: ## -quote: E: ## RHAT +literal: used to get a raw factoid contents. Use _default to ignore factoidSearch path. +literal: U: ## [_default|prefix] +literal: E: ## infobot + +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. + +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 + +md5: D: calculates the md5sum of a given string +md5: U: ## +md5: E: ## When will infobot 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: ## infobot Hey! It's another infobot! + +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 infobot achieve world domination? + +quote: D: Frontend to yahoo's online stock market share listing +quote: U: ## <query...> +quote: E: ## RHAT,MSFT + +redirection: If a factoid x contains simply "<reply> see y", then when asked for x, I will deliver factoidor command result y instead. + +rename: D: Factoid renaming +rename: U: ## 'from' 'to' +rename: E: ## 'infobot' 'infobot' + +reply: There is a special tag, <reply>, 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 <reply> Y". + +reverse: D: reverses a given string +reverse: U: ## <string> +reverse: E: ## When will infobot 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 infobot achieve world domination? + +search: U: ## <engine> for <string> +search: E: ## google for infobot + +seen: D: Report last seen time for somebody +seen: U: ## <nick> +seen: E: ## infobot + +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 -weather: D: Frontend to www.weather.com. -weather: U: ## <query> -weather: E: ## Sydney -weather: E: ## Perth, Australia -weather: N: For first timers, please search for the city as all search results are kept in the local cache. You can then query 'city, location'. +tell: D: Tell someone about a factoid or command +tell: U: ## <who> -?about <what> +tell: E: ## me about infobot +tell: E: ## someone -about testing -topic add: D: Add your own topic. +topic add: D: Add your own topic topic add: U: ## <topic> topic add: E: ## This is a test -topic del: D: Delete one or two subtopics. +topic del: D: Delete one or two subtopics topic del: U: ## <#> topic del: E: ## 1 topic del: E: ## 1-3,5 +topic del: E: ## last -topic mod: D: Search and replace strings in the topic. +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> <#> topic mv: E: ## 1 after 2 topic mv: E: ## first before last +topic restore: D: Restores the topic to an earlier version topic restore: U: ## <#> topic restore: E: ## 3 @@ -150,63 +463,62 @@ 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: U: ## <#channel> -part: E: ## #debian - -seen: U: ## <nick> -seen: E: ## infobot +uc: D: upper case a given string +uc: U: ## <string> +uc: E: ## When will infobot achieve world domination? -factinfo: D: View statistical information about a particular factoid. -factinfo: U: ## <factoid> -factinfo: E: ## test +unforget: If a factoid has been forgotten, "unforget x" will cause me to unerase it. -cookie: i can feed your appetite with random factoids. +unlobotomy: Not possible in real life, an unlobotomy will bring me back to life in the case of a lobotomy. -slashdot: D: News for nerds, Stuff that matters. [tm] -slashdot: U: ## +unlock: D: Factoid unlocking to allow removal by others. +unlock: U: ## <factoid> +unlock: E: ## abuse -babelfish: D: Frontend to babelfish translating service provided by digital.com -babelfish: U: x to <lang>: <words> -babelfish: U: translate from <lang>: <words> -babelfish: E: x to de: your cars rock +upsidedown: D: display a string in pseudo upside down unicode text +upsidedown: U: ## <string> +upsidedown: E: ## When will infobot achieve world domination? -insult: FIXME +uptime: D: Show the current uptime, and the top 3 uptimes recorded +uptime: U: ## -search: U: ## <engine> for <string> -search: E: ## google for evil +useradd: D: Administrative command to add new user to the .users file +useradd: U: ## <user> <mask> +useradd: E: ## SomeAccount SomeAccount!someguy@example.com -nickometer: FIXME +userdel: D: Administrative command to remove a user from the .users file +userdel: U: ## <user> +userdel: E: ## SomeAccount -rot13: FIXME +verstats: D: Commnd to CTCP VERSION the specified channel for client statistics +verstats: U: ## <channel> +verstats: E: ## #infobot +verstats: E: < infobot> IRC Client versions for #infobot (2): unknown/cloak - 3 (75%) ;; irssi - 1 (25%). -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?" +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). -kernel: D: Frontend to linux.kernel.org's finger response. -kernel: U: ## +whois: D: List available information for an account on the bot +whois: U: ## <account> +whois: E: ## SomeAccount -maths: FIXME +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 -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. +wtf: D: Interface to the BSD wtf command +wtf: U: ## <abbreviation> +wtf: E: ## iirc -unlock: D: Factoid unlocking to allow removal by others. -unlock: U: ## <factoid> -unlock: E: ## abuse +rssfeeds: D: rssfeeds is used to control the RSS Feed tracking module +rssfeeds: U: rssfeeds [command] +rssfeeds: E: rssfeeds flush +rssfeeds: D: flush - Will erase the cache file. (Must be chattr +o) +rssfeeds: D: update - Force a manual update of the feeds. (Must be chattr +o) -dollar variables: D: To be used in factoids -dollar variables: $date - ... -dollar variables: $time - ... -dollar variables: $who - ... -dollar variables: $username - ... -dollar variables: $host - ... -dollar variables: $channel - ... -dollar variables: $lastspeaker - ... -dollar variables: $factoid - ... -dollar variables: ... - ... +# vim:ts=4:sw=4:expandtab:tw=80