mirror of
https://github.com/pragma-/pbot.git
synced 2024-10-04 18:38:47 +02:00
doc/Commands.md: improvements
This commit is contained in:
parent
d6a77e9480
commit
89f7c35593
@ -2,20 +2,22 @@
|
|||||||
# Commands
|
# Commands
|
||||||
|
|
||||||
<!-- md-toc-begin -->
|
<!-- md-toc-begin -->
|
||||||
* [Command interpreter](#command-interpreter)
|
* [Command interpreter](#command-interpreter)
|
||||||
* [Piping](#piping)
|
* [Piping](#piping)
|
||||||
* [Substitution](#substitution)
|
* [Substitution](#substitution)
|
||||||
* [Chaining](#chaining)
|
* [Chaining](#chaining)
|
||||||
* [Variables](#variables)
|
* [Variables](#variables)
|
||||||
* [Inline invocation](#inline-invocation)
|
* [Inline invocation](#inline-invocation)
|
||||||
* [Types of commands](#types-of-commands)
|
* [Types of commands](#types-of-commands)
|
||||||
* [Built-in commands](#built-in-commands)
|
* [Built-in commands](#built-in-commands)
|
||||||
* [Creating new built-in commands](#creating-new-built-in-commands)
|
* [Creating new built-in commands](#creating-new-built-in-commands)
|
||||||
* [Plugins](#plugins)
|
* [Plugins](#plugins)
|
||||||
* [Factoids](#factoids)
|
* [Factoids](#factoids)
|
||||||
* [Code Factoids](#code-factoids)
|
* [Code Factoids](#code-factoids)
|
||||||
* [Modules](#modules)
|
* [Modules](#modules)
|
||||||
* [List of commands](#list-of-commands)
|
* [List of commands](#list-of-commands)
|
||||||
|
* [version](#version)
|
||||||
|
* [help](#help)
|
||||||
* [Administrative commands](#administrative-commands)
|
* [Administrative commands](#administrative-commands)
|
||||||
* [Logging in and out of PBot](#logging-in-and-out-of-pbot)
|
* [Logging in and out of PBot](#logging-in-and-out-of-pbot)
|
||||||
* [login](Admin.md#login)
|
* [login](Admin.md#login)
|
||||||
@ -34,6 +36,19 @@
|
|||||||
* [chanset](Admin.md#chanset)
|
* [chanset](Admin.md#chanset)
|
||||||
* [chanunset](Admin.md#chanunset)
|
* [chanunset](Admin.md#chanunset)
|
||||||
* [chanlist](Admin.md#chanlist)
|
* [chanlist](Admin.md#chanlist)
|
||||||
|
* [ignore](Admin.md#ignore)
|
||||||
|
* [unignore](Admin.md#unignore)
|
||||||
|
* [whitelist](Admin.md#whitelist)
|
||||||
|
* [blacklist](Admin.md#blacklist)
|
||||||
|
* [op](Admin.md#op)
|
||||||
|
* [deop](Admin.md#deop)
|
||||||
|
* [voice](Admin.md#voice)
|
||||||
|
* [devoice](Admin.md#devoice)
|
||||||
|
* [mode](Admin.md#mode)
|
||||||
|
* [ban/mute](Admin.md#banmute)
|
||||||
|
* [unban/unmute](Admin.md#unbanunmute)
|
||||||
|
* [invite](Admin.md#invite)
|
||||||
|
* [kick](Admin.md#kick)
|
||||||
* [Module management commands](#module-management-commands)
|
* [Module management commands](#module-management-commands)
|
||||||
* [load](Admin.md#load)
|
* [load](Admin.md#load)
|
||||||
* [unload](Admin.md#unload)
|
* [unload](Admin.md#unload)
|
||||||
@ -169,29 +184,40 @@ module. Such commands are registered throughout PBot's source code. The owner
|
|||||||
of the PBot instance can locally add new commands by editing PBot's source code
|
of the PBot instance can locally add new commands by editing PBot's source code
|
||||||
or by acquiring and loading Plugins.
|
or by acquiring and loading Plugins.
|
||||||
|
|
||||||
|
* only bot owner can locally create new built-in commands
|
||||||
|
* built-in commands have access to PBot internal API functions and data structures
|
||||||
|
|
||||||
#### Plugins
|
#### Plugins
|
||||||
|
|
||||||
Additional built-in commands can be created by loading PBot Plugins. Plugins are
|
Additional built-in commands can be created by loading PBot Plugins. Plugins are
|
||||||
stand-alone self-contained units of code that can be loaded by the PBot owner.
|
stand-alone self-contained units of code that can be loaded by the PBot owner.
|
||||||
|
|
||||||
Plugins have access to PBot's internal APIs and data structures.
|
* only bot owner can install and load PBot Plugins
|
||||||
|
* PBot Plugins have access to PBot internal API functions and data structures
|
||||||
|
|
||||||
### Factoids
|
### Factoids
|
||||||
|
|
||||||
Factoids are another type of command. Factoids are simple textual strings that
|
Factoids are another type of command. Factoids are simple text commands which
|
||||||
anybody can create. At their most simple, they display their text when invoked.
|
anybody can create. In their most basic form, they simply display their text
|
||||||
However, significantly more complex Factoids can be created by using the powerful
|
when invoked. However, significantly more complex Factoids can be created by
|
||||||
interpreter and by using the even more powerful `/code` Factoid command.
|
using the [powerful interpreter features](#command-interpreter) and by using the even more powerful
|
||||||
|
[`/code` Factoid command](Factoids.md#code).
|
||||||
|
|
||||||
Factoids do not have access to PBot's internal API or data structures.
|
* anybody can create Factoids
|
||||||
|
* Factoids do not have access to PBot internal API functions and data structures
|
||||||
|
|
||||||
|
For more information, see the [Factoids documentations.](Factoids.md)
|
||||||
|
|
||||||
#### Code Factoids
|
#### Code Factoids
|
||||||
|
|
||||||
Code Factoids are Factoids whose text begins with the `/code` command.
|
Code Factoids are Factoids whose text begins with the `/code` command.
|
||||||
These Factoids will execute their text using the scripting or programming
|
These Factoids will execute their text using the scripting or programming
|
||||||
language specified by the `/code` command.
|
language specified by the argument following the `/code` command.
|
||||||
|
|
||||||
Code Factoids do not have access to PBot's internal API or data structures.
|
* anybody can create Code Factoids
|
||||||
|
* Code Factoids do not have access to PBot internal API functions and data structures
|
||||||
|
|
||||||
|
For more information, see the [Code Factoid documentation.](Factoids.md#code)
|
||||||
|
|
||||||
#### Modules
|
#### Modules
|
||||||
|
|
||||||
@ -199,13 +225,30 @@ Modules are simple stand-alone external command-line scripts and programs. Just
|
|||||||
about any application that can be run in your command-line shell can be loaded as
|
about any application that can be run in your command-line shell can be loaded as
|
||||||
a PBot module.
|
a PBot module.
|
||||||
|
|
||||||
Modules do not have access to PBot's internal API or data structures.
|
* only bot owner can install new command-line modules
|
||||||
|
* Modules do not have access to PBot internal API functions and data structures
|
||||||
|
|
||||||
|
For more information, see the [Modules documentation.](Modules.md)
|
||||||
|
|
||||||
## List of commands
|
## List of commands
|
||||||
|
|
||||||
Here is the list of all of PBot's built-in commands and some of the more useful
|
Here is the list of all of PBot's built-in commands and some of the more useful
|
||||||
Factoids, Plugins and Modules.
|
Factoids, Plugins and Modules.
|
||||||
|
|
||||||
|
### version
|
||||||
|
|
||||||
|
The `version` command displays the currently installed PBot revision and
|
||||||
|
revision date. It will also check to see if there is a new version available.
|
||||||
|
|
||||||
|
<pragma-> !version
|
||||||
|
<PBot> PBot version 2845 2020-01-19; new version available: 2850 2020-01-20!
|
||||||
|
|
||||||
|
### help
|
||||||
|
|
||||||
|
The `help` command displays useful information about built-in commands and Factoids.
|
||||||
|
|
||||||
|
Usage: `help [keyword] [channel]`
|
||||||
|
|
||||||
### Administrative commands
|
### Administrative commands
|
||||||
|
|
||||||
#### Logging in and out of PBot
|
#### Logging in and out of PBot
|
||||||
@ -230,6 +273,19 @@ Factoids, Plugins and Modules.
|
|||||||
##### [chanset](Admin.md#chanset)
|
##### [chanset](Admin.md#chanset)
|
||||||
##### [chanunset](Admin.md#chanunset)
|
##### [chanunset](Admin.md#chanunset)
|
||||||
##### [chanlist](Admin.md#chanlist)
|
##### [chanlist](Admin.md#chanlist)
|
||||||
|
##### [ignore](Admin.md#ignore)
|
||||||
|
##### [unignore](Admin.md#unignore)
|
||||||
|
##### [whitelist](Admin.md#whitelist)
|
||||||
|
##### [blacklist](Admin.md#blacklist)
|
||||||
|
##### [op](Admin.md#op)
|
||||||
|
##### [deop](Admin.md#deop)
|
||||||
|
##### [voice](Admin.md#voice)
|
||||||
|
##### [devoice](Admin.md#devoice)
|
||||||
|
##### [mode](Admin.md#mode)
|
||||||
|
##### [ban/mute](Admin.md#banmute)
|
||||||
|
##### [unban/unmute](Admin.md#unbanunmute)
|
||||||
|
##### [invite](Admin.md#invite)
|
||||||
|
##### [kick](Admin.md#kick)
|
||||||
|
|
||||||
#### Module management commands
|
#### Module management commands
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user