files/blootbot.help

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