Update manpage

3 files changed, 139 insertions, 85 deletions

diff --git a/linux/man/smolbote.7 b/linux/man/smolbote.7
index bd865e9..e8f63bd 100644
--- a/linux/man/smolbote.7
+++ b/linux/man/smolbote.7
@@ -1,29 +1,29 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "SMOLBOTE" "7" "April 2018" "" ""
+.TH "SMOLBOTE" "7" "May 2018" "" ""
 .
 .SH "NAME"
 \fBsmolbote\fR \- yet another no\-frills browser
 .
 .SH "SYNOPSIS"
-\fBpoi\fR [\fIoptions\fR\.\.\.] URL
+\fBpoi\fR [\fIoptions\fR\.\.\.] URL(s)
 .
 .SH "DESCRIPTION"
 smolbote is a keep\-it\-simple free software web browser\.
 .
-.SH "OPTIONS"
+.SH "COMMAND\-LINE OPTIONS"
 .
 .SS "General"
 .
 .IP "\(bu" 4
-\fB\-h\fR, \fB\-\-help\fR: Displays this help\.
+\fB\-h\fR, \fB\-\-help\fR: Display this help\.
 .
 .IP "\(bu" 4
-\fB\-v\fR, \fB\-\-version\fR: Displays version information\.
+\fB\-v\fR, \fB\-\-version\fR: Display version information\.
 .
 .IP "\(bu" 4
-\fB\-\-build\fR: Displays build information\.
+\fB\-\-build\fR: Display build branch and commit\.
 .
 .IP "" 0
 .
@@ -37,13 +37,13 @@ smolbote is a keep\-it\-simple free software web browser\.
 .
 .IP "" 0
 .
-.SS "Open URL"
+.SS "Plugins"
 .
 .IP "\(bu" 4
-\fB\-p\fR, \fB\-\-profile\fR: Use this profile\.
+\fB\-\-command\fR: Run a plugin command\.
 .
 .IP "\(bu" 4
-\fB\-\-in\-new\-window\fR: Open URL in new window\.
+\fB\-\-commands\fR: List all plugin commands\.
 .
 .IP "" 0
 .
@@ -51,9 +51,17 @@ smolbote is a keep\-it\-simple free software web browser\.
 The Configuration is loaded from \fI~/\.config/smolbote/smolbote\.cfg\fR, and can be edited with the \fBpoi\-config\fR tool\.
 .
 .P
-Settings are only loaded on launch, so re\-run the browser to apply changes\.
+Settings are only loaded on launch; re\-run the browser to apply changes\.
+.
+.SS "Browser"
+.
+.IP "\(bu" 4
+browser\.stylesheet: path
+.
+.IP "" 0
 .
 .SS "Main Window"
+A main window contains one or more subwindows\.
 .
 .IP "\(bu" 4
 mainwindow\.height: 720
@@ -71,7 +79,7 @@ mainwindow\.title: smolbote
 mainwindow\.shortcuts\.newGroup: Ctrl+G
 .
 .IP "\(bu" 4
-mainwindow\.shortcuts\.newWindow: Ctrl+N (todo)
+mainwindow\.shortcuts\.newWindow: Ctrl+N
 .
 .IP "\(bu" 4
 mainwindow\.shortcuts\.about: F1
@@ -85,56 +93,61 @@ mainwindow\.shortcuts\.search: F3
 .IP "\(bu" 4
 mainwindow\.shortcuts\.tileWindows: F9
 .
+.IP "\(bu" 4
+mainwindow\.shortcuts\.cascadeWindows: F10
+.
 .IP "" 0
 .
-.SS "Navigation bar"
+.SS "Subwindow"
+A subwindow contains multiple tabs and functions similarly to a tab group\.
 .
 .IP "\(bu" 4
-navigation\.movable: false
+window\.shortcuts\.new: Ctrl+T
 .
 .IP "\(bu" 4
-navigation\.shortcuts\.back: Ctrl+Left
+window\.shortcuts\.close: Ctrl+X
 .
 .IP "\(bu" 4
-navigation\.shortcuts\.forward: Ctrl+Right
+window\.shortcuts\.left: Ctrl+O
 .
 .IP "\(bu" 4
-navigation\.shortcuts\.refresh: F5
+window\.shortcuts\.right: Ctrl+P
 .
 .IP "\(bu" 4
-navigation\.shortcuts\.home: Ctrl+Home
+window\.shortcuts\.fullscreen: F11
 .
 .IP "" 0
 .
-.SS "Address bar"
+.SS "Navigation bar"
+The navigation bar is the toolbar that holds the history, reload and home buttons, as well as the address bar\. It can be made movable through the navigation\.movable option\.
 .
 .IP "\(bu" 4
-addressbar\.shortcuts\.focus: F4
+navigation\.movable: false
 .
 .IP "\(bu" 4
-addressbar\.shortcuts\.pageMenu: F2
+navigation\.shortcuts\.back: Ctrl+Left
 .
 .IP "\(bu" 4
-addressbar\.shortcuts\.toolsMenu: F10
-.
-.IP "" 0
-.
-.SS "Window"
+navigation\.shortcuts\.forward: Ctrl+Right
 .
 .IP "\(bu" 4
-window\.shortcuts\.new: Ctrl+T
+navigation\.shortcuts\.refresh: F5
 .
 .IP "\(bu" 4
-window\.shortcuts\.close: Ctrl+X
+navigation\.shortcuts\.reload: Ctrl+F5
 .
 .IP "\(bu" 4
-window\.shortcuts\.left: Ctrl+O
+navigation\.shortcuts\.home: Ctrl+Home
+.
+.IP "" 0
+.
+.SS "Address bar"
 .
 .IP "\(bu" 4
-window\.shortcuts\.right: Ctrl+P
+addressbar\.shortcuts\.focus: F4
 .
 .IP "\(bu" 4
-window\.shortcuts\.fullscreen: F11 (todo)
+addressbar\.shortcuts\.menu: F2
 .
 .IP "" 0
 .
@@ -154,7 +167,11 @@ filter\.cookies\.path: ~/\.config/smolbote/cookies\.d
 .
 .IP "" 0
 .
-.SS "Plugins (to\-redo)"
+.SS "Plugins"
+Plugins a way of extending smolbote\'s functionality using the Qt plugin system\. They are not to be confused with NPAPI/PPAPI or WebExtension plugins\.
+.
+.P
+To enable a plugin either copy it or symlink it in the plugins\.path location\. A set of default plugins is installed in /usr/lib/smolbote\.
 .
 .IP "\(bu" 4
 plugins\.path: ~/\.config/smolbote/plugins\.d
diff --git a/linux/man/smolbote.7.html b/linux/man/smolbote.7.html
index a7c99f8..c74783f 100644
--- a/linux/man/smolbote.7.html
+++ b/linux/man/smolbote.7.html
@@ -56,7 +56,7 @@
     <a href="#NAME">NAME</a>
     <a href="#SYNOPSIS">SYNOPSIS</a>
     <a href="#DESCRIPTION">DESCRIPTION</a>
-    <a href="#OPTIONS">OPTIONS</a>
+    <a href="#COMMAND-LINE-OPTIONS">COMMAND-LINE OPTIONS</a>
     <a href="#CONFIGURATION">CONFIGURATION</a>
   </div>
 
@@ -73,20 +73,20 @@
 
 <h2 id="SYNOPSIS">SYNOPSIS</h2>
 
-<p><code>poi</code> [<var>options</var>...] URL</p>
+<p><code>poi</code> [<var>options</var>...] URL(s)</p>
 
 <h2 id="DESCRIPTION">DESCRIPTION</h2>
 
 <p>smolbote is a keep-it-simple free software web browser.</p>
 
-<h2 id="OPTIONS">OPTIONS</h2>
+<h2 id="COMMAND-LINE-OPTIONS">COMMAND-LINE OPTIONS</h2>
 
 <h3 id="General">General</h3>
 
 <ul>
-<li><code>-h</code>, <code>--help</code>: Displays this help.</li>
-<li><code>-v</code>, <code>--version</code>: Displays version information.</li>
-<li><code>--build</code>: Displays build information.</li>
+<li><code>-h</code>, <code>--help</code>: Display this help.</li>
+<li><code>-v</code>, <code>--version</code>: Display version information.</li>
+<li><code>--build</code>: Display build branch and commit.</li>
 </ul>
 
 
@@ -98,11 +98,11 @@
 </ul>
 
 
-<h3 id="Open-URL">Open URL</h3>
+<h3 id="Plugins">Plugins</h3>
 
 <ul>
-<li><code>-p</code>, <code>--profile</code>: Use this profile.</li>
-<li><code>--in-new-window</code>: Open URL in new window.</li>
+<li><code>--command</code>: Run a plugin command.</li>
+<li><code>--commands</code>: List all plugin commands.</li>
 </ul>
 
 
@@ -111,31 +111,59 @@
 <p>The Configuration is loaded from <em>~/.config/smolbote/smolbote.cfg</em>, and can be
 edited with the <code>poi-config</code> tool.</p>
 
-<p>Settings are only loaded on launch, so re-run the browser to apply changes.</p>
+<p>Settings are only loaded on launch; re-run the browser to apply changes.</p>
+
+<h3 id="Browser">Browser</h3>
+
+<ul>
+<li>browser.stylesheet: path</li>
+</ul>
+
 
 <h3 id="Main-Window">Main Window</h3>
 
+<p>A main window contains one or more subwindows.</p>
+
 <ul>
 <li>mainwindow.height: 720</li>
 <li>mainwindow.width: 1280</li>
 <li>mainwindow.maximized: true</li>
-<li><p>mainwindow.title: smolbote</p></li>
-<li><p>mainwindow.shortcuts.newGroup: Ctrl+G</p></li>
-<li><p>mainwindow.shortcuts.newWindow: Ctrl+N (todo)</p></li>
-<li><p>mainwindow.shortcuts.about: F1</p></li>
-<li><p>mainwindow.shortcuts.quit: Ctrl+Q</p></li>
-<li><p>mainwindow.shortcuts.search: F3</p></li>
+<li>mainwindow.title: smolbote</li>
+<li>mainwindow.shortcuts.newGroup: Ctrl+G</li>
+<li>mainwindow.shortcuts.newWindow: Ctrl+N</li>
+<li>mainwindow.shortcuts.about: F1</li>
+<li>mainwindow.shortcuts.quit: Ctrl+Q</li>
+<li>mainwindow.shortcuts.search: F3</li>
 <li>mainwindow.shortcuts.tileWindows: F9</li>
+<li>mainwindow.shortcuts.cascadeWindows: F10</li>
+</ul>
+
+
+<h3 id="Subwindow">Subwindow</h3>
+
+<p>A subwindow contains multiple tabs and functions similarly to a tab group.</p>
+
+<ul>
+<li>window.shortcuts.new: Ctrl+T</li>
+<li>window.shortcuts.close: Ctrl+X</li>
+<li>window.shortcuts.left: Ctrl+O</li>
+<li>window.shortcuts.right: Ctrl+P</li>
+<li>window.shortcuts.fullscreen: F11</li>
 </ul>
 
 
 <h3 id="Navigation-bar">Navigation bar</h3>
 
+<p>The navigation bar is the toolbar that holds the history, reload and home
+buttons, as well as the address bar. It can be made movable through the
+navigation.movable option.</p>
+
 <ul>
 <li>navigation.movable: false</li>
 <li>navigation.shortcuts.back: Ctrl+Left</li>
 <li>navigation.shortcuts.forward: Ctrl+Right</li>
 <li>navigation.shortcuts.refresh: F5</li>
+<li>navigation.shortcuts.reload: Ctrl+F5</li>
 <li>navigation.shortcuts.home: Ctrl+Home</li>
 </ul>
 
@@ -144,19 +172,7 @@ edited with the <code>poi-config</code> tool.</p>
 
 <ul>
 <li>addressbar.shortcuts.focus: F4</li>
-<li>addressbar.shortcuts.pageMenu: F2</li>
-<li>addressbar.shortcuts.toolsMenu: F10</li>
-</ul>
-
-
-<h3 id="Window">Window</h3>
-
-<ul>
-<li>window.shortcuts.new: Ctrl+T</li>
-<li>window.shortcuts.close: Ctrl+X</li>
-<li>window.shortcuts.left: Ctrl+O</li>
-<li>window.shortcuts.right: Ctrl+P</li>
-<li>window.shortcuts.fullscreen: F11 (todo)</li>
+<li>addressbar.shortcuts.menu: F2</li>
 </ul>
 
 
@@ -170,7 +186,13 @@ edited with the <code>poi-config</code> tool.</p>
 </ul>
 
 
-<h3 id="Plugins-to-redo-">Plugins (to-redo)</h3>
+<h3 id="Plugins">Plugins</h3>
+
+<p>Plugins a way of extending smolbote's functionality using the Qt plugin system.
+They are not to be confused with NPAPI/PPAPI or WebExtension plugins.</p>
+
+<p>To enable a plugin either copy it or symlink it in the plugins.path location. A
+set of default plugins is installed in /usr/lib/smolbote.</p>
 
 <ul>
 <li>plugins.path: ~/.config/smolbote/plugins.d</li>
@@ -207,7 +229,7 @@ edited with the <code>poi-config</code> tool.</p>
 
   <ol class='man-decor man-foot man foot'>
     <li class='tl'></li>
-    <li class='tc'>April 2018</li>
+    <li class='tc'>May 2018</li>
     <li class='tr'>smolbote(7)</li>
   </ol>
 
diff --git a/linux/man/smolbote.7.ronn b/linux/man/smolbote.7.ronn
index ba60db6..40f6d5b 100644
--- a/linux/man/smolbote.7.ronn
+++ b/linux/man/smolbote.7.ronn
@@ -3,67 +3,76 @@ smolbote(7) -- yet another no-frills browser
 
 ## SYNOPSIS
 
-`poi` [<options>...] URL
+`poi` [<options>...] URL(s)
 
 ## DESCRIPTION
 
 smolbote is a keep-it-simple free software web browser.
 
-## OPTIONS
+## COMMAND-LINE OPTIONS
 
 ### General
-* `-h`, `--help`: Displays this help.
-* `-v`, `--version`: Displays version information.
-* `--build`: Displays build information.
+* `-h`, `--help`: Display this help.
+* `-v`, `--version`: Display version information.
+* `--build`: Display build branch and commit.
 
 ### Configuration
 * `-c`, `--config`: Set configuration file.
 * `--socket`: Local server socket
 
-### Open URL
-* `-p`, `--profile`: Use this profile.
-* `--in-new-window`: Open URL in new window.
+### Plugins
+* `--command`: Run a plugin command.
+* `--commands`: List all plugin commands.
 
 ## CONFIGURATION
 
 The Configuration is loaded from _~/.config/smolbote/smolbote.cfg_, and can be
 edited with the `poi-config` tool.
 
-Settings are only loaded on launch, so re-run the browser to apply changes.
+Settings are only loaded on launch; re-run the browser to apply changes.
+
+### Browser
+* browser.stylesheet: path
 
 ### Main Window
+A main window contains one or more subwindows.
+
 * mainwindow.height: 720
 * mainwindow.width: 1280
 * mainwindow.maximized: true
 * mainwindow.title: smolbote
-
 * mainwindow.shortcuts.newGroup: Ctrl+G
-* mainwindow.shortcuts.newWindow: Ctrl+N (todo)
-
+* mainwindow.shortcuts.newWindow: Ctrl+N
 * mainwindow.shortcuts.about: F1
 * mainwindow.shortcuts.quit: Ctrl+Q
-
 * mainwindow.shortcuts.search: F3
 * mainwindow.shortcuts.tileWindows: F9
+* mainwindow.shortcuts.cascadeWindows: F10
+
+### Subwindow
+A subwindow contains multiple tabs and functions similarly to a tab group.
+
+* window.shortcuts.new: Ctrl+T
+* window.shortcuts.close: Ctrl+X
+* window.shortcuts.left: Ctrl+O
+* window.shortcuts.right: Ctrl+P
+* window.shortcuts.fullscreen: F11
 
 ### Navigation bar
+The navigation bar is the toolbar that holds the history, reload and home 
+buttons, as well as the address bar. It can be made movable through the
+navigation.movable option.
+
 * navigation.movable: false
 * navigation.shortcuts.back: Ctrl+Left
 * navigation.shortcuts.forward: Ctrl+Right
 * navigation.shortcuts.refresh: F5
+* navigation.shortcuts.reload: Ctrl+F5
 * navigation.shortcuts.home: Ctrl+Home
 
 ### Address bar
 * addressbar.shortcuts.focus: F4
-* addressbar.shortcuts.pageMenu: F2
-* addressbar.shortcuts.toolsMenu: F10
-
-### Window
-* window.shortcuts.new: Ctrl+T
-* window.shortcuts.close: Ctrl+X
-* window.shortcuts.left: Ctrl+O
-* window.shortcuts.right: Ctrl+P
-* window.shortcuts.fullscreen: F11 (todo)
+* addressbar.shortcuts.menu: F2
 
 ### Filter
 * filter.path: ~/.config/smolbote/hosts.d
@@ -71,7 +80,13 @@ Settings are only loaded on launch, so re-run the browser to apply changes.
 * filter.cookies.block.thirdParty: true
 * filter.cookies.path: ~/.config/smolbote/cookies.d
 
-### Plugins (to-redo)
+### Plugins
+Plugins a way of extending smolbote's functionality using the Qt plugin system.
+They are not to be confused with NPAPI/PPAPI or WebExtension plugins.
+
+To enable a plugin either copy it or symlink it in the plugins.path location. A
+set of default plugins is installed in /usr/lib/smolbote.
+
 * plugins.path: ~/.config/smolbote/plugins.d
 
 ### Profiles