]> git.donarmstrong.com Git - infobot.git/blob - FAQ
dunno
[infobot.git] / FAQ
1 # $Id$
2
3 Q: What are factpacks and how do I install them?
4 A: A factpack is a partial database of factoids that you can import into
5    your configured infobot by running the script called "factpack.pl".
6
7    # IMPORTANT: Run from the bots base directory!
8    eg: ./scripts/factpack.pl /path/to/areacodes.fact
9
10 Q: Can I remove a fact pack I have installed?
11 A: Yes, but at the moment, you need to manually use SQL commands in your
12    favorite SQL program. The "created_by" field in the factoids will be
13    set to the filename of the fact pack you installed. For example, if
14    you installed the "areacodes.fact" file, "created_by" would be set to
15    "areacodes.fact". The SQL to remove the above example would be:
16
17    sql> DELETE FROM factoids WHERE created_by = 'areacodes.fact';
18
19 Q: Where can I download some existing fact packs?
20 A: As of yet, the fact packs aren't available in SVN. You can try the
21    original infobot web site at:
22
23      http://www.infobot.org/factpacks/
24
25    NOTE: The import script can't yet handle compressed files, so you must
26    extract the factpacks in advance.
27
28 Q: How can I make my own fact packs?
29 A: The syntax is pretty basic. You just need a plain text file that has
30    one key/value pair per line. Comment lines begin with a "#" character
31    and are ignored, as are blank lines. Extra whitespace around key/value
32    pairs should hopefully be stripped out as well. A few example lines from
33    the areacodes.fact file:
34
35      # Sample comment here
36      area code 011 => the International Access Code
37      area code 201 => Hackensack, Morristown and Newark, New Jersey
38      area code 202 => Washington, District of Columbia
39
40
41 Q: The bot exits after I run 'factstats testing' or 'kernel' or anything
42    that uses fork(). Is this a bug in the bot?
43
44 A: No, this is not a bug in the bot but rather Net::IRC.  A cheap hack is
45    to edit /usr/lib/perl5/Net/IRC/Connection.pm, search for DESTROY, and
46    comment out '$self->quit();'
47
48
49 Q: I notice that, in the bot logs, the bot attempts to close all current
50    DCC CHAT connections whenever a forked process ends. Why is this?
51
52 A: Yet another bug in Net::IRC. Currently, DCC CHAT connections are not
53    closed because there is an endless-loop bug when it is done.
54
55
56 Q: I executed 'scripts/setup_user.pl' but it said 'connection refused to
57    localhost'
58
59 A: Looks like a bug in the installation of mysqld. You need to reload or
60    restart the daemon.
61         reload => 'mysqladmin -u root -p reload'
62         restart => '/etc/init.d/mysql stop; /etc/init.d/mysql start'
63
64 Q: How do I get my bot to automatically ask for OP's from chanserv?
65
66 A: By default, the "chanServCheck" option is off in _default. You can
67    set it on a per channel basis or as default. For example, the following
68    commands will enable asking for OP by default, except on #notmychannel
69
70         chanset _default chanServCheck 1
71         chanset #notmychannel chanServCheck 0
72
73 # vim:ts=4:sw=4:expandtab:tw=80