about summary refs log tree commit diff stats
path: root/docs/profanity-plugins.1
diff options
context:
space:
mode:
Diffstat (limited to 'docs/profanity-plugins.1')
-rw-r--r--docs/profanity-plugins.193
1 files changed, 93 insertions, 0 deletions
diff --git a/docs/profanity-plugins.1 b/docs/profanity-plugins.1
new file mode 100644
index 00000000..a0f8dcd1
--- /dev/null
+++ b/docs/profanity-plugins.1
@@ -0,0 +1,93 @@
+.TH man 1 "2022-10-12" "0.13.0" "Profanity XMPP client"
+
+.SH NAME
+/plugins
+
+.SH DESCRIPTION
+Manage plugins. Passing no arguments lists installed plugins and global plugins which are available for local installation. Global directory for Python plugins is /usr/local/share/profanity/plugins and for C Plugins is /usr/local/lib64/profanity/plugins.
+
+.SH SYNOPSIS
+/plugins
+
+.LP
+/plugins install [<path>]
+
+.LP
+/plugins uninstall [<plugin>]
+
+.LP
+/plugins update [<path>]
+
+.LP
+/plugins unload [<plugin>]
+
+.LP
+/plugins load [<plugin>]
+
+.LP
+/plugins reload [<plugin>]
+
+.LP
+/plugins python_version
+
+.LP
+
+.SH ARGUMENTS
+.PP
+\fBinstall [<path>]\fR
+.RS 4
+Install a plugin, or all plugins found in a directory (recursive). And loads it/them.
+.RE
+.PP
+\fBuninstall [<plugin>]\fR
+.RS 4
+Uninstall a plugin.
+.RE
+.PP
+\fBupdate [<path>]\fR
+.RS 4
+Updates an installed plugin
+.RE
+.PP
+\fBload [<plugin>]\fR
+.RS 4
+Load a plugin that already exists in the plugin directory, passing no argument loads all found plugins. It will be loaded upon next start too unless unloaded.
+.RE
+.PP
+\fBunload [<plugin>]\fR
+.RS 4
+Unload a loaded plugin, passing no argument will unload all plugins.
+.RE
+.PP
+\fBreload [<plugin>]\fR
+.RS 4
+Reload a plugin, passing no argument will reload all plugins.
+.RE
+.PP
+\fBpython_version\fR
+.RS 4
+Show the Python interpreter version.
+.RE
+
+.SH EXAMPLES
+/plugins install
+
+.LP
+/plugins install /home/steveharris/Downloads/metal.py
+
+.LP
+/plugins update /home/steveharris/Downloads/metal.py
+
+.LP
+/plugins uninstall browser.py
+
+.LP
+/plugins load browser.py
+
+.LP
+/plugins unload say.py
+
+.LP
+/plugins reload wikipedia.py
+
+.LP