diff --git a/_static/.gitignore b/_static/.gitignore new file mode 100644 index 0000000..9985a95 --- /dev/null +++ b/_static/.gitignore @@ -0,0 +1,2 @@ +# This file is here to stop Sphinx complaining about missing _static +# directory. diff --git a/use/faq.rst b/use/faq.rst index 2349396..1a21480 100644 --- a/use/faq.rst +++ b/use/faq.rst @@ -3,11 +3,12 @@ Frequently Asked Questions ************************** How do I make my Supybot connect to multiple servers? +===================================================== Just use the `connect` command in the `Network` plugin. -Why does my bot not recognize me or tell me that I don't have the -'owner' capability? +Why does my bot not recognize me or tell me that I don't have the 'owner' capability? +===================================================================================== Because you've not given it anything to recognize you from! @@ -24,7 +25,11 @@ Why does my bot not recognize me or tell me that I don't have the course, you should change myOwnerUser and myOwnerUserPassword appropriately for your bot). + For additional ways to identify to your bot, you may want to see + :ref:`getting-started`. + What is a hostmask? +=================== Each user on IRC is uniquely identified by a string which we call a `hostmask`. The IRC RFC refers to it as a prefix. Either way, it @@ -34,6 +39,7 @@ What is a hostmask? components and that they're joined in the appropriate manner. My bot can't handle nicks with brackets in them! +================================================ It always complains about something not being a valid command, or about spurious or missing right brackets, etc. @@ -46,24 +52,33 @@ My bot can't handle nicks with brackets in them! `supybot.commands.nested.brackets` to some other value (like ``<>``, which can't occur in IRC nicks). -I added an alias, but it doesn't work! +I loaded Alias before, how do I move to Aka? +============================================ - Take a look at ``help ``. If the alias the bot has +First load both of the plugins, Aka and Alias. Then run +``aka importaliasdatabase`` and ``unload Alias``. Now all your aliases +should be imported to the Aka plugin. + +I added an aka, but it doesn't work! +==================================== + + Take a look at ``aka show ``. If the aka the bot has listed doesn't match what you're giving it, chances are you need to - quote your alias in order for the brackets not to be evaluated. For - instance, if you're adding an alias to give you a link to your + quote your aka in order for the brackets not to be evaluated. For + instance, if you're adding an aka to give you a link to your homepage, you need to say:: - alias add mylink "format concat http://my.host.com/ [urlquote $1]" + aka add mylink "format concat http://my.host.com/ [urlquote $1]" and not:: - alias add mylink format concat http://my.host.com/ [urlquote $1] + aka add mylink format concat http://my.host.com/ [urlquote $1] The first version works; the second version will always return the same url. What does 'lobotomized' mean? +============================= I see this word in commands and in my `channels.conf`, but I don't know what it means. What does Supybot mean when it says "lobotomized"? @@ -80,6 +95,7 @@ What does 'lobotomized' mean? as possible. Is there a way to load all the plugins Supybot has? +=================================================== No, there isn't. Even if there were, some plugins conflict with other plugins, so it wouldn't make much sense to load them. For instance, @@ -89,8 +105,8 @@ Is there a way to load all the plugins Supybot has? If you want to know more about the plugins that are available, check out our `plugin index`_ at our `website`_. -Is there a command that can tell me what capability another command -requires? +Is there a command that can tell me what capability another command requires? +============================================================================= No, there isn't, and there probably never will be. @@ -103,14 +119,16 @@ requires? add this partial solution. Why doesn't `Karma` seem to work for me? +======================================== `Karma`, by default, doesn't acknowledge karma updates. If you check the karma of whatever you increased/decreased, you'll note that your increment or decrement still took place. If you'd rather `Karma` acknowledge karma updates, change the `supybot.plugins.Karma.response` - configuration variable to "On". + configuration variable to "True". Why won't Supybot respond to private messages? +============================================== The most likely cause is that you are running your bot on the Freenode network. Around Sept. 2005, Freenode added a user mode which @@ -125,6 +143,7 @@ Why won't Supybot respond to private messages? registered, and your Supybot has the +R user mode set. Can users with the "admin" capability change configuration? +=========================================================== Currently, no. Feel free to make your case to us as to why a certain configuration variable should only require the `admin` capability @@ -132,11 +151,13 @@ Can users with the "admin" capability change configuration? change it for the next release. How can I make my Supybot log my IRC channel? +============================================= To log all the channels your Supybot is in, simply load the `ChannelLogger` plugin, which is included in the main distribution. How do I find out channel modes? +================================ I want to know who's an op in a certain channel, or who's voiced, or what the modes on the channel are. How do I do that? @@ -155,6 +176,7 @@ How do I find out channel modes? From there, things should be self-evident. Can Supybot connect through a proxy server? +=========================================== Limnoria can connect to specific network using socks proxy, simply set the configuration variable `supybot.networks..socksproxy`. For @@ -166,6 +188,7 @@ Can Supybot connect through a proxy server? does work with these. Why can't Supybot find the plugin I want to load? +================================================= Why does my bot say that 'No plugin "foo" exists.' when I try to load the foo plugin? @@ -179,10 +202,12 @@ Why can't Supybot find the plugin I want to load? makes a difference to Python. I've found a bug, what do I do? +=============================== Submit your bug at our `issue tracker`_. Is Python installed? +==================== I run Windows, and I'm not sure if Python is installed on my computer. How can I find out for sure? @@ -200,5 +225,5 @@ Is Python installed? .. _website: http://supybot.com/ .. _blocks: http://freenode.net/faq.shtml#blockingmessages .. _tsocks: http://tsocks.sourceforge.net -.. _issue_tracker: https://github.com/ProgVal/Limnoria/issues +.. _issue tracker: https://github.com/ProgVal/Limnoria/issues .. _download it: http://python.org/download/