files/infobot.help

   1 # Revised: 20090320
   2 #  Author: Tim Riker <Tim@Rikers.org>
   3 #  Contributors: Simon C., Tim M., others (see AUTHORS)
   4 ###
   5
   6 # Special entry
   7 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?"
   8
   9 action: This is used to override the usual response. "x is <action> does the hokey-pokey". When asked about x, the bot does this "* infobot does the hokey-pokey"
  10
  11 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)
  12
  13 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.
  14
  15 author: oznoid (mailto:lenzo@ri.cmu.edu) is my original author.
  16
  17 babelfish: D: Frontend to babelfish translating service provided by http://babelfish.altavista.com/ Note that utf8 is used for non-ascii characters.
  18 babelfish: U: x <fromLang> <toLang> <words>
  19 babelfish: U: translate <fromLang> <toLang> <words>
  20 babelfish: E: x en de your cars rock
  21
  22 bandel: D: FIXME:
  23 bandel: U: ## <mask|user>
  24 bandel: E: ## *!*@owns.org
  25 bandel: E: ## MoronMan
  26
  27 banadd: D: FIXME:
  28 banadd: U: ## <mask|user> [chan] [time] [reason]
  29 banadd: E: ## *!*@owns.org #bots 60 stop flooding.
  30 banadd: E: ## *!*@*microsoft.com STOOPID
  31 banadd: E: ## MoronMan
  32
  33 botmail: D: Send someone botmail
  34 botmail: U: ## {for <who>[:] <message>}|stats|check|read
  35 botmail: E: ## for infobot: you rock!
  36 botmail: E: ## stats
  37 botmail: E: ## check
  38 botmail: E: ## read
  39
  40 chanadd: D: Join a channel permanently
  41 chanadd: U: ## #channel
  42 chanadd: E: ## #botpark
  43
  44 chandel: D: Leave a channel permanently
  45 chandel: U: ## -#channel
  46 chandel: E: ## -#botpark
  47
  48 chaninfo: D: Display channel statistics on Op, Ban, Deop, Unban, Part, Join, SignOff, PublicMsg, Kick and Topic
  49 chaninfo: U: ## [#channel]
  50 chaninfo: E: ##
  51 chaninfo: E: ## #botpark
  52
  53 chanset: D: set a variable for a channel
  54 chanset: U: ## [#chan] [what] [val]
  55 chanset: E: ## #c +test
  56 chanset: E: ## #c -test
  57 chanset: E: ## #c test
  58 chanset: E: ## #c test 0
  59 chanset: E: ## #c test testing123
  60
  61 chanunset: D: remove a variable from a channel
  62 chanunset: U: ## <#chan> [what]
  63 chanunset: E: ## #c
  64 chanunset: E: ## #c test
  65
  66 chattr: D: Change flags on a user (see "help flags")
  67 chattr: U: ## <user> [flags]
  68 chattr: E: ## bloot +nmo
  69 chattr: E: ## bloot -ot
  70 chattr: E: ## bloot
  71
  72 chnick: D: rename a nick (user) entry
  73 chnick: U: ## [nick] <new-nick>
  74 chnick: E: ## moron
  75 chnick: E: ## owner eleet
  76
  77 chpass: D: Change a user's password
  78 chpass: U: ## [user] <pass>
  79 chpass: E: ## testing
  80 chpass: E: ## testing test0R
  81
  82 contents: D: Debian Contents search only (no Packages)
  83 contents: U: ## <string> [dist]
  84 contents: E: ## strings.h
  85 contents: E: ## x11amp potato
  86
  87 convert: D: Convert from one unit to another
  88 convert: U: ## [number] <units> to <units>
  89 convert: E: ## 55 tempF to tempC
  90 convert: E: ## 60 mph to kph
  91 convert: E: ## 60 miles per hour to km/hour
  92 convert: E: ## gallons to cm^3
  93
  94 cookie: I can feed your appetite with random factoids.
  95
  96 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.
  97 corrections: you can append stuff to a factoid with "also". "x is also at ..."
  98
  99 cpustats: cpustats dumps the bot's cpu usage this session
 100
 101 crypt: It's good that you thought about encryption. I can do it for you.
 102 crypt: U: ## <salt> <string>
 103 crypt: E: ## 69 changeme
 104 crypt: E: ## $1$abcde changeme
 105
 106 cycle: D: Causes me to cycle in the channel it's said, or in the named channel
 107 cycle: U: ## [channel]
 108 cycle: E: ##
 109 cycle: E: ## #botpark
 110
 111 dauthor: D: Find Debian package maintainers, and list the packages they maintain
 112 dauthor: U: ## <string> [dist]
 113 dauthor: E: ## Wichert
 114 dauthor: E: ## Wichert potato
 115
 116 dbugs: D: Show the current count of release critical bugs (latest versions)
 117 dbugs: U: ##
 118
 119 ddesc: D: Search the Description: lines in Debian packages
 120 ddesc: U: ## <string> [dist]
 121 ddesc: E: ## mule
 122 ddesc: E: ## mule potato
 123
 124 dfind: D: Debian Packages (fallback to Contents) search
 125 dfind: U: ## <string> [dist]
 126 dfind: E: ## strings.h
 127 dfind: E: ## x11amp potato
 128
 129 dice: D: simulate dice rolls using I<a>dI<b>[+-*/b]I<c>
 130 dice: U: ## <dice>
 131 dice: E: ## 3d6
 132 dice: E: ## 4d10+12
 133
 134 dict: D: DICT Protocol Client - likely dicts: elements web1913 wn gazetteer jargon foldoc easton hitchcock devils world02 vera
 135 dict: U: ## [entry num] <query>[/dict]
 136 dict: E: ## linux
 137 dict: E: ## 33 set/wn
 138
 139 dns: D: Query DNS
 140 dns: U: ## <host|ip>
 141 dns: E: ## debian.org
 142 dns: E: ## 3.1.33.7
 143
 144 do: D: operator command to do things in a channel
 145 do: U: ## <chan> <what>
 146
 147 dollar variables: D: To be used in factoids
 148 dollar variables: $Fdunno      - ...
 149 dollar variables: $Fquestion   - ...
 150 dollar variables: $Fupdate     - ...
 151 dollar variables: $channel     - channel from which the factoid was requested
 152 dollar variables: $date        - current date (GMT)
 153 dollar variables: $day         - day of week (full name, locale)
 154 dollar variables: $factoids    - factoid count
 155 dollar variables: $host        - hostname of factoid requester
 156 dollar variables: $ident       - bot nick
 157 dollar variables: $lastspeaker - ...
 158 dollar variables: $memusage    - ...
 159 dollar variables: $rand        - random number, also $rand100.2
 160 dollar variables: $randnick    - random nick
 161 dollar variables: $startTime   - start time
 162 dollar variables: $time        - current time (GMT)
 163 dollar variables: $uptime      - ...
 164 dollar variables: $urlchannel  - html encoded channel from which the factoid was requested
 165 dollar variables: $user        - username of factoid requester
 166 dollar variables: $who         - nick of factoid requester
 167
 168 dstats: D: Show basic stats on the current size of the Debian distros
 169 dstats: U: ## [dist]
 170 dstats: E: ##
 171 dstats: E: ## potato
 172
 173 factinfo: D: View statistical information about a particular factoid.
 174 factinfo: U: ## <factoid>
 175 factinfo: E: ## test
 176
 177 factstats: D: Display statistical data (max of 15) about factoids.
 178 factstats: U: ## <type>
 179 factstats: == author    -- top author of factoids.
 180 factstats: == deadredir -- ??
 181 factstats: == duplicate -- duplicate factoids.
 182 factstats: == listfix   -- ??
 183 factstats: == locked    -- locked factoids.
 184 factstats: == new       -- recent addition of factoids.
 185 factstats: == nullfactoids -- ??
 186 factstats: == partdupe  -- initial partial duplicate factoids.
 187 factstats: == profanity -- possibly offensive factoids.
 188 factstats: == redir     -- redirection in factoids.
 189 factstats: == reqrate   -- ??
 190 factstats: == requested -- most requested factoids.
 191 factstats: == requesters -- most requested factoids.
 192 factstats: == seefix    -- ??
 193 factstats: == toolong   -- factoid {key|value} exceeding specified length.
 194 factstats: == tooshort  -- factoid {key|value} shorter than specified length.
 195 factstats: == total     -- ??
 196 factstats: == unrequest -- unrequested factoids.
 197 factstats: == vandalism -- ??
 198 factstats: E: ## new
 199
 200 flags: D: Flags for chattr command
 201 flags: D: "A" - bot administration over /msg (default is only via DCC CHAT)
 202 flags: D: "O" - dynamic ops (as on channel). (automatic +o)
 203 flags: D: "T" - add topics.
 204 flags: D: "a" - ask/request factoid.
 205 flags: D: "m" - modify all factoids. (includes renaming)
 206 flags: D: "M" - modify own factoids. (includes renaming)
 207 flags: D: "n" - bot owner, can "reload"
 208 flags: D: "o" - master of bot (automatic +amrt)
 209 flags: D:        - can search on factoid strings shorter than 2 chars
 210 flags: D:        - can tell bot to join new channels
 211 flags: D:        - can [un]lock factoids
 212 flags: D: "r" - remove factoid.
 213 flags: D: "t" - teach/add factoid.
 214 flags: D: "s" - Bypass +silent on channels
 215
 216 forget: If I have an old/redundant factoid x, "forget x" will cause me to erase it.
 217
 218 freshmeat: D: Frontend to www.freshmeat.net
 219 freshmeat: U: ## <query>
 220 freshmeat: E: ## infobot
 221
 222 google: D: What Is: Google Search frontend
 223 google: D: Configuration: "chanset [_default or channelname] +Google"
 224 google: U: ## google <query>
 225 google: E: ## google infobot
 226
 227 hex: D: Convert ascii to hex
 228 hex: U: ## <string>
 229 hex: E: ## carrot
 230
 231 hex2ip: D: Convert Hex idents for some gateways to an IP address
 232 hex2ip: U: ## <8 char hex value>
 233 hex2ip: E: ## AabBcC12
 234
 235 hostadd: D: admin command to list or add hostmasks to a user account
 236 hostadd: U: ## [user] [<mask>]
 237 hostadd: E: ## owner
 238 hostadd: E: ## *!*@owns.org
 239 hostadd: E: ## owner leet!leet@*.heh.org
 240
 241 hostdel: D: admin command to remove hostmask from a user account
 242 hostdel: U: ## [user] <mask>
 243 hostdel: E: ## *!*@owns.org
 244 hostdel: E: ## owner leet!leet@*.heh.org
 245
 246 httpdtype: D: Get httpd server software version / configuration
 247 httpdtype: U: ## <hostname>
 248 httpdtype: E: ## example.com
 249
 250 identify: D: identify in a PRIVATE message with infobot to add new mask to user account
 251 identify: E: ## <password>
 252
 253 ignore: D: ignore list management
 254 ignore: E: ## [mask chan expire comment]
 255 ignore: E: addignore guu!*@*
 256
 257 ircstats: ircstats dumps some status information on the bot's IRC connection
 258
 259 join: U: ## <#chan> [key]
 260 join: E: ## #botpark
 261 join: E: ## #botpark rules
 262
 263 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.
 264
 265 kernel: D: Frontend to linux.kernel.org's finger response.
 266 kernel: U: ##
 267
 268 kick: U: ## <nick> [#chan] [message]
 269 kick: E: ## oznoid
 270 kick: E: ## larne #botpark
 271 kick: E: ## john #foo go away!
 272
 273 lart: D: Luser Attitude Readjustment Tool
 274 lart: U: ## [#chan] <who>
 275 lart: E: ## lenzo infobot's bugginess
 276 lart: E: ## #perl everyone perl \=\= lamerville
 277
 278 lc: D: lower case a given string
 279 lc: U: ## <string>
 280 lc: E: ## When will infobot achieve world domination?
 281
 282 listauth: D: Search the factoid extension db by creator
 283 listauth: U: ## <search>
 284 listauth: E: ## xk
 285
 286 listkeys: D: Search the factoid database by key (factoid)
 287 listkeys: U: ## <regex>
 288 listkeys: E: ## infobot
 289
 290 listvalues: D: Search the factoid database by value (description)
 291 listvalues: U: ## <regex>
 292 listvalues: E: ## infobot
 293
 294 literal: used to get a raw factoid contents. Use _default to ignore factoidSearch path.
 295 literal: U: ## [_default|prefix] <factoid>
 296 literal: E: ## infobot
 297
 298 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
 299
 300 lock: D: Factoid locking to prevent removal by others
 301 lock: U: ## <factoid>
 302 lock: E: ## abuse
 303 lock: N: By default, only registered "ops" on the bots or factoids matching the user's nick are able to lock factoids.
 304 lock: N: Requires factoid extension (extra) support enabled.
 305
 306 math: D: math expresions can be evaluated. This uses Perl syntax.
 307 math: E: 1+1
 308 math: + - add
 309 math: - - subtract
 310 math: * - multiply
 311 math: / - division
 312 math: ** - to the power
 313 math: pi - pi
 314 math: & - and
 315 math: | = or
 316 math: ^ - xor
 317
 318 md5: D: calculates the md5sum of a given string
 319 md5: U: ## <string>
 320 md5: E: ## When will infobot achieve world domination?
 321
 322 mode: set modes for a channel
 323 mode: U: ## <#chan> <mode>
 324 mode: E: ## #botpark +t
 325 mode: E: ## #botpark -i
 326
 327 news: D: News functions
 328 news: U: ## [chan] <add,del,mod,set,latest,read,help>
 329
 330 news add: D: Add news items
 331 news add: U: news [chan] add <title>
 332 news add: E: news add This is a test
 333 news add: see _news set Text_ aswell
 334
 335 news set: D: Set stuff for news item
 336 news set: U: news [chan] set <item> <what> [value]
 337 news set:    valid <what>: Expire, Text
 338 news set: E: news set 1 Text ok, this works
 339 news set: E: news set test Text and this is a test
 340 news set: E: news set test Text
 341
 342 news set expire: D: Set expire for news item
 343 news set expire: U: news [chan] expire <what> <value>
 344 news set expire: value can be: Xd Xh Xm Xs
 345 news set expire: value can be: never
 346 news set expire: news expire 1 3days
 347 news set expire: news expire 2 +20d
 348 news set expire: news expire Test 30d 20h 10m 5s
 349 news set expire: news expire TEST never
 350
 351 news del: D: Delete news item (requires +o or be author)
 352 news del: U: news [chan] del <item>
 353 news del: E: news del 1
 354 news del: E: news del test
 355
 356 news mod: D: Modify a news item (todo: modify Text aswell)
 357 news mod: E: news [chan] mod <item> s/<from>/<to>/[g]
 358 news mod: E: news mod 1 s/test/Test/
 359 news mod: E: news mod test s/test/Test/g
 360
 361 nickometer: D: Measures the lame-ness of a nick or channel
 362 nickometer: U: ## {nick,channel}
 363 nickometer: E: ## unknown_lamer
 364 nickometer: E: ## #botpark
 365
 366 onjoin: D: get/set OnJoin message (needs chan option +OnJoin)
 367 onjoin: U: ## [#chan|_default] [-]<nick> [message]
 368 onjoin: E: ## infobot Hey! It's another infobot!
 369
 370 ord: D: Convert ascii to decimal
 371 ord: U: ## <single character>
 372 ord: E: ## c
 373
 374 page: D: Send someone a pager message
 375 page: U: ## <who> <message>
 376 page: E: ## infobot you rock!
 377 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"
 378
 379 part: D: Leave a channel (DCC only)
 380 part: U: ## <#channel>
 381 part: E: ## #botpark
 382 part: NOTE: /kick is an alternative
 383
 384 piglatin: D: translates english text into piglatin
 385 piglatin: U: ## <string>
 386 piglatin: E: ## When will infobot achieve world domination?
 387
 388 quote: D: Frontend to yahoo's online stock market share listing
 389 quote: U: ## <query...>
 390 quote: E: ## RHAT,MSFT
 391
 392 redirection: If a factoid x contains simply "<reply> see y", then when asked for x, I will deliver factoidor command result y instead.
 393
 394 rename: D: Factoid renaming
 395 rename: U: ## 'from' 'to'
 396 rename: E: ## 'infobot' 'infobot'
 397
 398 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".
 399
 400 reverse: D: reverses a given string
 401 reverse: U: ## <string>
 402 reverse: E: ## When will infobot achieve world domination?
 403
 404 rot13: D: ROT13's a given string
 405 rot13: U: ## <string>
 406 rot13: E: ## guvf vf n ynzr rknzcyr
 407
 408 say: D: operator command to say things in a channel
 409 say: U: ## <chan> <what>
 410
 411 scramble: D: scrambles a given string
 412 scramble: U: ## <string>
 413 scramble: E: ## When will infobot achieve world domination?
 414
 415 search: U: ## <engine> for <string>
 416 search: E: ## google for infobot
 417
 418 seen: D: Report last seen time for somebody
 419 seen: U: ## <nick>
 420 seen: E: ## infobot
 421
 422 slashdot: D: News for nerds, Stuff that matters. [tm] (shows the headlines)
 423 slashdot: U: ##
 424
 425 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.
 426
 427 status: status dumps general status information
 428
 429 tell: D: Tell someone about a factoid or command
 430 tell: U: ## <who> -?about <what>
 431 tell: E: ## me about infobot
 432 tell: E: ## someone -about testing
 433
 434 topic add: D: Add your own topic
 435 topic add: U: ## <topic>
 436 topic add: E: ## This is a test
 437
 438 topic del: D: Delete one or two subtopics
 439 topic del: U: ## <#>
 440 topic del: E: ## 1
 441 topic del: E: ## 1-3,5
 442 topic del: E: ## last
 443
 444 topic mod: D: Search and replace strings in the topic
 445 topic mod: U: ## <REGEX>
 446 topic mod: E: ## s/test/TEST/
 447 topic mod: E: ## s#msg test#/msg test#g
 448
 449 topic mv: D: Move subtopics around.
 450 topic mv: U: ## <#> <before|after|swap> <#>
 451 topic mv: E: ## 1 after 2
 452 topic mv: E: ## first before last
 453
 454 topic restore: D: Restores the topic to an earlier version
 455 topic restore: U: ## <#>
 456 topic restore: E: ## 3
 457
 458 topic: Usage for 'topic [#chan] <params>':
 459 topic:   ---------------- __Subtopic__:
 460 topic:   add <TOPIC>    - Append <TOPIC> to topic.
 461 topic:   del <#>        - Remove subtopic <#> from topic.
 462 topic:   list           - Display subtopics.
 463 topic:   mod s/old/new/ - Search and replace topic.
 464 topic:   mv <ARGS>      - 'topic mv'.
 465 topic:   shuffle        - Randomly organize subtopics.
 466 topic:   ---------------- __Topic__
 467 topic:   history        - Show previous topics.
 468 topic:   restore <#>    - Restore topic to <#>.
 469 topic:   rehash         - Rehash changes to topic.
 470 topic:   info           - Who and time info.
 471 topic:   ---------------- __Misc__
 472 topic:   about          - Read the file :)
 473 topic:   help           - This screen.
 474
 475 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.
 476 topic: NOTE: commands can be preceeded? with '-' in order not to enforce changes to topic.
 477 topic: End of help.
 478
 479 uc: D: upper case a given string
 480 uc: U: ## <string>
 481 uc: E: ## When will infobot achieve world domination?
 482
 483 unforget: If a factoid has been forgotten, "unforget x" will cause me to unerase it.
 484
 485 unlobotomy: Not possible in real life, an unlobotomy will bring me back to life in the case of a lobotomy.
 486
 487 unlock: D: Factoid unlocking to allow removal by others.
 488 unlock: U: ## <factoid>
 489 unlock: E: ## abuse
 490
 491 upsidedown: D: display a string in pseudo upside down unicode text
 492 upsidedown: U: ## <string>
 493 upsidedown: E: ## When will infobot achieve world domination?
 494
 495 uptime: D: Show the current uptime, and the top 3 uptimes recorded
 496 uptime: U: ##
 497
 498 useradd: D: Administrative command to add new user to the .users file
 499 useradd: U: ## <user> <mask>
 500 useradd: E: ## SomeAccount SomeAccount!someguy@example.com
 501
 502 userdel: D: Administrative command to remove a user from the .users file
 503 userdel: U: ## <user>
 504 userdel: E: ## SomeAccount
 505
 506 verstats: D: Commnd to CTCP VERSION the specified channel for client statistics
 507 verstats: U: ## <channel>
 508 verstats: E: ## #infobot
 509 verstats: E: < infobot> IRC Client versions for #infobot (2): unknown/cloak - 3 (75%) ;; irssi - 1 (25%).
 510
 511 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).
 512
 513 whois: D: List available information for an account on the bot
 514 whois: U: ## <account>
 515 whois: E: ## SomeAccount
 516
 517 wikipedia: D: Frontend to the Wikipedia at http://www.wikipedia.org/wiki/ Note that utf8 is used for non-ascii characters.
 518 wikipedia: U: ## <topic>
 519 wikipedia: U: wiki <topic>
 520 wikipedia: E: wiki irc
 521
 522 wtf: D: Interface to the BSD wtf command
 523 wtf: U: ## <abbreviation>
 524 wtf: E: ## iirc
 525
 526 rssfeeds: D: rssfeeds is used to control the RSS Feed tracking module
 527 rssfeeds: U: rssfeeds [command]
 528 rssfeeds: E: rssfeeds flush
 529 rssfeeds: D: flush - Will erase the cache file. (Must be chattr +o)
 530 rssfeeds: D: update - Force a manual update of the feeds. (Must be chattr +o)
 531
 532 # vim:ts=4:sw=4:expandtab:tw=80