.. _plugin:learn:

=====
LEARN
=====
| 

about
-----
| 

:author:  FeedBackLoop <feedbackloop@gmail.com>
:contact: FREENODE/#fbf
:distribution: core
:license:  

| 

description
-----------
| 

 learn information items .. facts .. factoids. 



| 

commands
--------
| 


    :commands in this plugin: learn-searchitems .. learn .. learn-forgetchan .. learn-forget .. learn-items .. learn-toglobal .. learn-chan .. learn-whatis

| 

1) *learn .. [handle_learn]*

    :description: " arguments: <item> is <description> - set an information item. 

    :permissions: OPER .. USER .. GUEST

    :code: :ref:`fbf.plugs.extra.learn_learn_command`.

    :examples:

    ::

        <user> ;learn dunk is botpapa
        <output> dunk item added to global database


2) *learn-chan .. [handle_learnchan]*

    :description: " arguments: <item> is <description> - set an information item. 

    :permissions: OPER .. USER .. GUEST

    :code: :ref:`fbf.plugs.extra.learn_learn-chan_command`.

    :examples:

    ::

        <user> ;learn-chan dunk is botpapa
        <output> dunk item added to #test database


3) *learn-forget .. [handle_forget]*

    :description: " arguments: <item> and <matchstring> - set an information item. 

    :permissions: OPER .. USER

    :code: :ref:`fbf.plugs.extra.learn_learn-forget_command`.

    :examples:

    ::

        <user> ;learn-forget dunk and botpapa
        <output> item removed from global database


4) *learn-forgetchan .. [handle_forgetchan]*

    :description: " arguments: <item> and <matchstring> - set an information item. 

    :permissions: OPER .. USER

    :code: :ref:`fbf.plugs.extra.learn_learn-forgetchan_command`.

    :examples:

    ::

        <user> ;learn-forgetchan dunk and botpapa
        <output> item removed from #test database


5) *learn-items .. [handle_items]*

    :description:  no arguments - show what items the bot has learned. 

    :permissions: OPER .. USER .. GUEST

    :code: :ref:`fbf.plugs.extra.learn_learn-items_command`.

    :examples:

    ::

        <user> ;learn-items
        <output> i know 2 items: dunk, dunk


6) *learn-searchitems .. [handle_searchitems]*

    :description:  argument: <searchtxt>  - search the items the bot has learned. 

    :permissions: OPER .. USER .. GUEST

    :code: :ref:`fbf.plugs.extra.learn_learn-searchitems_command`.

    :examples:

    ::

        <user> ;learn-searchitems fbfbot
        <output> found 0 items:


7) *learn-toglobal .. [handle_learntoglobal]*

    :description:  argument: <searchtxt>  - search the items the bot has learned. 

    :permissions: OPER

    :code: :ref:`fbf.plugs.extra.learn_learn-toglobal_command`.

    :examples:

    ::

        <user> ;learn-toglobal
        <output> 1 items copy to the global database.


8) *learn-whatis .. [handle_whatis]*

    :description:  arguments: <item> - show what the bot has learned about a factoid. 

    :permissions: OPER .. USER .. GUEST

    :code: :ref:`fbf.plugs.extra.learn_learn-whatis_command`.

    :examples:

    ::

        <user> ;learn-whatis fbf
        <output> no information known about fbf