GitHub/pbot
3
0
Fork 0
mirror of https://github.com/pragma-/pbot.git synced 2024-11-25 05:19:29 +01:00
Code Issues Projects Releases Wiki Activity

doc: improvements

Browse Source
This commit is contained in:
Pragmatic Software 2020-02-14 23:35:34 -08:00
parent 58a3303173
commit 614d45a938
2 changed files with 22 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/Commands.md
View File

@ -8,6 +8,7 @@
* [Chaining](#chaining)
* [Variables](#variables)
* [Inline invocation](#inline-invocation)
* [Background processing](#background-processing)
* [Types of commands](#types-of-commands)
* [Built-in commands](#built-in-commands)
* [Creating new built-in commands](#creating-new-built-in-commands)
@ -43,7 +44,6 @@
* [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)
@ -66,6 +66,9 @@
* [Command metadata](#command-metadata)
* [cmdset](Admin.md#cmdset)
* [cmdunset](Admin.md#cmdunset)
* [Process management](#process-management)
* [ps](Admin.md#ps)
* [kill](Admin.md#kill)
* [Registry commands](#registry-commands)
* [regset](Registry.md#regset)
* [regunset](Registry.md#regunset)
@ -166,6 +169,18 @@ is addressed to a nick, the output will also be addressed to them.
<PBot> newuser13: PBot version 2696 2020-01-04
<PBot> newuser13: To learn all about me, see https://github.com/pragma-/pbot/tree/master/doc
### Background processing
Any command can be flagged to be executed as a background process. For example, suppose you
make a Plugin that has a command that may potentially take a long time to complete, which could
cause PBot to be non-responsive...
Not a problem! You can use the [`cmdset`](doc/Admin.md#cmdset) command to set the `background-process` [command metadata](doc/Admin.md#command-metadata-list)
and the command will now run as a background process, allowing PBot to carry on with its duties.
The familiar [`ps`](doc/Admin.md#ps) and [`kill`](doc/Admin.md#kill) commands can be used to list and kill the background processes.
You can also [`cmdset`](doc/Admin.md#cmdset) the `process-timeout` [command metadata](doc/Admin.md#command-metadata-list) to set the timeout, in seconds, before the command is automatically killed. Otherwise the `processmanager.default_timeout` [registry value](doc/Registry.md) will be used.
## Types of commands
There are several ways of adding new commands to PBot. We'll go over them here.
@ -329,7 +344,6 @@ to have the command remember your location.
##### [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)
@ -358,8 +372,11 @@ to have the command remember your location.
##### [cmdset](Admin.md#cmdset)
##### [cmdunset](Admin.md#cmdunset)
#### Registry commands
#### Process management
##### [ps](Admin.md#ps)
##### [kill](Admin.md#kill)
#### Registry commands
##### [regset](Registry.md#regset)
##### [regunset](Registry.md#regunset)
##### [regchange](Registry.md#regchange)

2
doc/README.md
View File

@ -40,6 +40,7 @@
* [Chaining](Commands.md#chaining)
* [Variables](Commands.md#variables)
* [Inline invocation](Commands.md#inline-invocation)
* [Background processing](Commands.md#background-processing)
* [Types of commands](Commands.md#types-of-commands)
* [Built-in commands](Commands.md#built-in-commands)
* [Creating new built-in commands](Commands.md#creating-new-built-in-commands)
@ -62,6 +63,7 @@
* [Module management commands](Commands.md#module-management-commands)
* [Plugin management commands](Commands.md#plugin-management-commands)
* [Command metadata](Commands.md#command-metadata)
* [Process management](Commands.md#process-management)
* [Registry commands](Commands.md#registry-commands)
* [Miscellaneous admin commands](Commands.md#miscellaneous-admin-commands)
* [Factoid commands](Commands.md#factoid-commands)