files/blootbot.help

   1 # Revised: 19991109.
   2 #  Author: xk
   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 literal: used to get a raw factoid contents
   8 literal: U: ## <factoid>
   9 literal: E: ## blootbot
  10
  11 author: oznoid (mailto:lenzo@ri.cmu.edu) is my original author.
  12
  13 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.
  14 corrections: you can append stuff to a factoid with "also". "x is also at ..."
  15
  16 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"
  17
  18 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".
  19
  20 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.
  21
  22 redirection: If a factoid x contains simply "<reply> see y", then when asked for x, I will deliver factoid y instead
  23
  24 # now the commands...
  25 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
  26
  27 unlobotomy: Which is not possible in real life, an unlobotomy will bring me back to life in the case of a lobotomy.
  28
  29 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)
  30
  31 forget: If I have an old/redundant factoid x, "forget x" will cause me to erase it.
  32
  33 unforget: If a factoid has been forgotten, "unforget x" will cause me to unerase it.
  34
  35 find: D: Debian Packages (fallback to Contents) search
  36 find: U: ## <string> [dist]
  37 find: E: ## strings.h
  38 find: E: ## x11amp potato
  39
  40 contents: D: Debian Contents search only (no Packages)
  41 contents: U: ## <string> [dist]
  42 contents: E: ## strings.h
  43 contents: E: ## x11amp potato
  44
  45 dauthor: D: Find Debian package maintainers, and list the packages they maintain
  46 dauthor: U: ## <string> [dist]
  47 dauthor: E: ## Wichert
  48 dauthor: E: ## Wichert potato
  49
  50 ddesc: D: Search the Description: lines in Debian packages
  51 ddesc: U: ## <string> [dist]
  52 ddesc: E: ## mule
  53 ddesc: E: ## mule potato
  54
  55 bugs: D: Show the current count of release critical bugs (latest versions)
  56 bugs: U: ##
  57
  58 dstats: D: Show basic stats on the current size of the Debian distros
  59 dstats: U: ## [dist]
  60 dstats: E: ##
  61 dstats: E: ## potato
  62
  63 uptime: D: Show the current uptime, and the top 3 uptimes recorded
  64 uptime: U: ##
  65
  66 rename: D: Factoid renaming
  67 rename: U: ## 'from' 'to'
  68 rename: E: ## 'infobot' 'blootbot'
  69
  70 nslookup: D: Query DNS
  71 nslookup: U: ## <host|ip>
  72 nslookup: E: ## debian.org
  73 nslookup: E: ## 3.1.33.7
  74
  75 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.
  76
  77 crypt: It's good that you thought about encryption. I can do it for you.
  78 crypt: U: ## <string> <salt>
  79 crypt: E: ## changeme 69
  80
  81 join: U: ## <#chan> [key]
  82 join: E: ## #debian
  83 join: E: ## #debian rules
  84
  85 kick: U: ## <nick> [#chan]
  86 kick: E: ## oznoid
  87 kick: E: ## larne #debian
  88
  89 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).
  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: ## #debian
  95
  96 dict: D: DICT Protocol Client
  97 dict: U: ## <query>
  98 dict: E: ## AI
  99 dict: E: ## 1 linux
 100
 101 freshmeat: D: Frontend to www.freshmeat.net
 102 freshmeat: U: ## <query>
 103 freshmeat: E: ## blootbot
 104
 105 factstats: D: Display statistical data (max of 15) about factoids.
 106 factstats: U: ## <type>
 107 factstats: == author    -- top author of factoids.
 108 factstats: == broken    -- broken factoids.
 109 factstats: == dupe      -- duplicate factoids.
 110 factstats: == locked    -- locked factoids.
 111 factstats: == new       -- recent addition of factoids.
 112 factstats: == partdupe  -- initial partial duplicate factoids.
 113 factstats: == profanity -- possibly offensive factoids.
 114 factstats: == redir     -- redirection in factoids.
 115 factstats: == requested -- most requested factoids.
 116 factstats: == toolong   -- factoid {key|value} exceeding specified length.
 117 factstats: == unrequest -- unrequested factoids.
 118 factstats: E: ## new
 119
 120 lart: D: Luser Attitude Readjustment Tool
 121 lart: U: ## [#chan] <who>
 122 lart: E: ## lenzo infobot's bugginess
 123 lart: E: ## #perl everyone perl \=\= lamerville
 124
 125 listauth: D: Search the factoid extension db by creator
 126 listauth: U: ## <search>
 127 listauth: E: ## xk
 128
 129 listkeys: D: Search the factoid database by key (factoid)
 130 listkeys: U: ## <regex>
 131 listkeys: E: ## blootbot
 132
 133 listvalues: D: Search the factoid database by value (description)
 134 listvalues: U: ## <regex>
 135 listvalues: E: ## blootbot
 136
 137 quote: D: Frontend to yahoo's online stock market share listing
 138 quote: U: ## <query...>
 139 quote: E: ## RHAT,MSFT
 140
 141 topic add: D: Add your own topic
 142 topic add: U: ## <topic>
 143 topic add: E: ## This is a test
 144
 145 topic del: D: Delete one or two subtopics
 146 topic del: U: ## <#>
 147 topic del: E: ## 1
 148 topic del: E: ## 1-3,5
 149 topic del: E: ## last
 150
 151 topic mod: D: Search and replace strings in the topic
 152 topic mod: U: ## <REGEX>
 153 topic mod: E: s/test/TEST/
 154 topic mod: E: s#msg test#/msg test#g
 155
 156 topic mv: D: Move subtopics around.
 157 topic mv: U: ## <#> <before|after|swap> <#>
 158 topic mv: E: ## 1 after 2
 159 topic mv: E: ## first before last
 160
 161 topic restore: D: Restores the topic to an earlier version
 162 topic restore: U: ## <#>
 163 topic restore: E: ## 3
 164
 165 topic: Usage for 'topic [#chan] <params>':
 166 topic:   ---------------- __Subtopic__:
 167 topic:   add <TOPIC>    - Append <TOPIC> to topic.
 168 topic:   del <#>        - Remove subtopic <#> from topic.
 169 topic:   list           - Display subtopics.
 170 topic:   mod s/old/new/ - Search and replace topic.
 171 topic:   mv <ARGS>      - 'topic mv'.
 172 topic:   shuffle        - Randomly organize subtopics.
 173 topic:   ---------------- __Topic__
 174 topic:   history        - Show previous topics.
 175 topic:   restore <#>    - Restore topic to <#>.
 176 topic:   rehash         - Rehash changes to topic.
 177 topic:   info           - Who and time info.
 178 topic:   ---------------- __Misc__
 179 topic:   about          - Read the file :)
 180 topic:   help           - This screen.
 181 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.
 182 topic: NOTE: commands can be preceeded? with '-' in order not to enforce changes to topic.
 183 topic: End of help.
 184
 185 part: D: Leave a channel (DCC only)
 186 part: U: ## <#channel>
 187 part: E: ## #debian
 188 part: NOTE: /kick is an alternative
 189
 190 seen: D: Report last seen time for somebody
 191 seen: U: ## <nick>
 192 seen: E: ## blootbot
 193
 194 factinfo: D: View statistical information about a particular factoid.
 195 factinfo: U: ## <factoid>
 196 factinfo: E: ## test
 197
 198 cookie: I can feed your appetite with random factoids.
 199
 200 slashdot: D: News for nerds, Stuff that matters. [tm] (shows the headlines)
 201 slashdot: U: ##
 202
 203 babelfish: D: Frontend to babelfish translating service provided by http://babelfish.altavista.com/ Note that utf8 is used for non-ascii characters.
 204 babelfish: U: x <fromLang> <toLang> <words>
 205 babelfish: U: translate <fromLang> <toLang> <words>
 206 babelfish: E: x en de your cars rock
 207
 208 search: U: ## <engine> for <string>
 209 search: E: ## google for evil
 210
 211 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?"
 212
 213 kernel: D: Frontend to linux.kernel.org's finger response.
 214 kernel: U: ##
 215
 216 lock: D: Factoid locking to prevent removal by others.
 217 lock: U: ## <factoid>
 218 lock: E: ## abuse
 219 lock: N: By default, only registered "ops" on the bots or factoids matching the user's nick are able to lock factoids.
 220 lock: N: Requires factoid extension (extra) support enabled.
 221
 222 unlock: D: Factoid unlocking to allow removal by others.
 223 unlock: U: ## <factoid>
 224 unlock: E: ## abuse
 225
 226 dollar variables: D: To be used in factoids
 227 dollar variables: $Fdunno      - ...
 228 dollar variables: $Fquestion   - ...
 229 dollar variables: $Fupdate     - ...
 230 dollar variables: $channel     - channel from which the factoid was requested
 231 dollar variables: $date        - current date
 232 dollar variables: $factoids    - factoid count
 233 dollar variables: $host        - hostname of factoid requester
 234 dollar variables: $ident       - bot nick
 235 dollar variables: $lastspeaker - ...
 236 dollar variables: $memusage    - ...
 237 dollar variables: $rand        - random number, also $rand100.2
 238 dollar variables: $randnick    - random nick
 239 dollar variables: $startTime   - start time
 240 dollar variables: $time        - current time
 241 dollar variables: $uptime      - ...
 242 dollar variables: $user        - username of factoid requester
 243 dollar variables: $who         - nick of factoid requester
 244
 245 chanset: D: FIXME
 246 chanset: U: ## [#chan] [what] [val]
 247 chanset: E: ## #c +test
 248 chanset: E: ## #c -test
 249 chanset: E: ## #c test
 250 chanset: E: ## #c test testing123
 251
 252 chanunset: D: FIXME.
 253 chanunset: U: ## <#chan> [what]
 254 chanunset: E: ## #c
 255 chanunset: E: ## #c test
 256
 257 chpass: D: FIXME.
 258 chpass: U: ## [user] <pass>
 259 chpass: E: ## testing
 260 chpass: E: ## testing test0R
 261
 262 chattr: D: FIXME.
 263 chattr: U: ## <user> [flags]
 264 chattr: E: ## bloot +nmo
 265 chattr: E: ## bloot -ot
 266 chattr: E: ## bloot
 267
 268 chnick: D: FIXME.
 269 chnick: U: ## [nick] <new-nick>
 270 chnick: E: ## moron
 271 chnick: E: ## owner eleet
 272
 273 +host: D: FIXME.
 274 +host: U: ## [user] <mask>
 275 +host: E: ## *!*@owns.org
 276 +host: E: ## owner leet!leet@*.heh.org
 277
 278 -host: D: FIXME.
 279 -host: U: ## [user] <mask>
 280 -host: E: ## *!*@owns.org
 281 -host: E: ## owner leet!leet@*.heh.org
 282
 283 +ban: D: FIXME.
 284 +ban: U: ## <mask|user> [chan] [time] [reason]
 285 +ban: E: ## *!*@owns.org #bots 60 stop flooding.
 286 +ban: E: ## *!*@*microsoft.com STOOPID
 287 +ban: E: ## MoronMan
 288
 289 -ban: D: FIXME.
 290 -ban: U: ## <mask|user>
 291 -ban: E: ## *!*@owns.org
 292 -ban: E: ## MoronMan
 293
 294 ircstats: ircstats dumps some status information on the bot's IRC connection
 295
 296 status: status dumps general status information
 297
 298 cpustats: cpustats dumps the bot's cpu usage this session
 299
 300 ord: D: Convert ascii to decimal
 301 ord: U: ## <single character>
 302 ord: E: ## c
 303
 304 hex: D: Convert ascii to hex
 305 hex: U: ## <string>
 306 hex: E: ## carrot
 307
 308 cycle: D: Causes me to cycle in the channel it's said, or in the named channel
 309 cycle: U: ## [channel]
 310 cycle: E: ##
 311 cycle: E: ## #debian-bots
 312
 313 rot13: D: ROT13's the given string
 314 rot13: U: ## <string>
 315 rot13: E: ## guvf vf n ynzr rknzcyr
 316
 317 nickometer: D: Measures the lame-ness of a nick or channel
 318 nickometer: U: ## {nick,channel}
 319 nickometer: E: ## unknown_lamer
 320 nickometer: E: ## #debian-bots
 321
 322 news: D: News functin
 323 news: U: ## [chan] <add,del,mod,set,latest,read,help>
 324
 325 news add: D: Add news items
 326 news add: U: news [chan] add <title>
 327 news add: E: news add This is a test
 328 news add: see _news set Text_ aswell
 329
 330 news set: D: Set stuff for news item
 331 news set: U: news [chan] set <item> <what> [value]
 332 news set:    valid <what>: Expire, Text
 333 news set: E: news set 1 Text ok, this works
 334 news set: E: news set test Text and this is a test
 335 news set: E: news set test Text
 336
 337 news set expire: D: Set expire for news item
 338 news set expire: U: news [chan] expire <what> <value>
 339 news set expire: value can be: Xd Xh Xm Xs
 340 news set expire: value can be: never
 341 news set expire: news expire 1 3days
 342 news set expire: news expire 2 +20d
 343 news set expire: news expire Test 30d 20h 10m 5s
 344 news set expire: news expire TEST never
 345
 346 news del: D: Delete news item (requires +o or be author)
 347 news del: U: news [chan] del <item>
 348 news del: E: news del 1
 349 news del: E: news del test
 350
 351 news mod: D: Modify a news item (todo: modify Text aswell)
 352 news mod: E: news [chan] mod <item> s/<from>/<to>/[g]
 353 news mod: E: news mod 1 s/test/Test/
 354 news mod: E: news mod test s/test/Test/g
 355
 356 tell: D: Tell someone about a factoid or command
 357 tell: U: tell <who> -?about <what>
 358 tell: E: tell me about blootbot
 359 tell: E: tell someone -about testing