aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAqua-sama <aqua@iserlohn-fortress.net>2018-05-18 13:52:10 +0200
committerAqua-sama <aqua@iserlohn-fortress.net>2018-05-18 13:52:10 +0200
commit13c36c432bcad740950d905629d0285c1037ed36 (patch)
treebc07704d20f960a4919d7ef9db42cba121368737
parentPlugin command-line parameters (diff)
downloadsmolbote-13c36c432bcad740950d905629d0285c1037ed36.tar.xz
Update manpage
-rw-r--r--QUICKSTART.md1
-rw-r--r--README.md2
-rw-r--r--lib/configuration/configuration.cpp4
-rw-r--r--linux/man/smolbote.779
-rw-r--r--linux/man/smolbote.7.html84
-rw-r--r--linux/man/smolbote.7.ronn61
-rw-r--r--src/main.cpp10
7 files changed, 150 insertions, 91 deletions
diff --git a/QUICKSTART.md b/QUICKSTART.md
index fcb292f..61191e0 100644
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@@ -14,6 +14,7 @@ Configuration is saved in:
- Ctrl + O - previous tab
- Ctrl + P - next tab
- Ctrl + X - close tab
+- Ctrl + W - close subwindow
See the [manual page][manpage] for more options.
diff --git a/README.md b/README.md
index 99e93d4..caed187 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
_It's yet another no-frills browser, poi!_
### What is this and why should I care?
-The aim is to create a [keep-it-simple][kiss-principle] free software web browser.
+smolbote is a [keep-it-simple][kiss-principle] free software web browser.
* do one thing and do it well
* just work out of the box
diff --git a/lib/configuration/configuration.cpp b/lib/configuration/configuration.cpp
index f2ec417..f09378e 100644
--- a/lib/configuration/configuration.cpp
+++ b/lib/configuration/configuration.cpp
@@ -50,8 +50,8 @@ Configuration::Configuration()
("config,c", po::value<std::string>()->default_value(defaultUserConfigLocation()), "Set the configuration file.")
("socket,s", po::value<std::string>()->default_value(defaultSocketPath()), "Local server socket")
- ("command", po::value<std::string>(), "Run a plugin command")
- ("commands", "List all plugin commands")
+ ("command", po::value<std::string>(), "Run a plugin command.")
+ ("commands", "List all plugin commands.")
("url", po::value<std::vector<std::string>>(), "URLs")
;
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
diff --git a/src/main.cpp b/src/main.cpp
index d578d24..89f3005 100644
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -27,10 +27,14 @@ int main(int argc, char **argv)
if(config->exists("help")) {
std::cout << "smolbote " << SMOLBOTE_VERSION << ": yet another no-frills browser" << std::endl;
- std::cout << "Usage: " << argv[0] << " [options] URL(s)" << std::endl;
+ std::cout << "Usage: " << argv[0] << " [options] URL(s)" << std::endl << std::endl;
- std::cout << std::endl << "Command-line Options: " << std::endl << config->commandlineOptions() << std::endl;
- std::cout << std::endl << "Configuration Options: " << std::endl << config->configurationOptions() << std::endl;
+ std::cout << "Command-line Options: " << std::endl << config->commandlineOptions() << std::endl;
+ std::cout << "Configuration Options: " << std::endl << config->configurationOptions() << std::endl;
+
+#ifdef Q_OS_LINUX
+ std::cout << std::endl << "For more information refer to the manual page smolbote.7" << std::endl;
+#endif
return 0;
}