aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAqua-sama <aqua@iserlohn-fortress.net>2018-03-20 16:49:08 +0100
committerAqua-sama <aqua@iserlohn-fortress.net>2018-03-20 16:49:08 +0100
commit03ff56c3be7f5eda19309a60dccb281c76d0187f (patch)
treed5918d7621aa147e8c3c3aaa1358ab7b9737aef7
parentAdd pause/resume/cancel buttons to download (diff)
downloadsmolbote-03ff56c3be7f5eda19309a60dccb281c76d0187f.tar.xz
Update manpage
-rw-r--r--linux/man/smolbote.7188
-rw-r--r--linux/man/smolbote.7.html131
-rw-r--r--linux/man/smolbote.7.ronn83
-rw-r--r--src/commandline.cpp3
-rw-r--r--src/commandline.h1
-rw-r--r--src/main.cpp10
6 files changed, 357 insertions, 59 deletions
diff --git a/linux/man/smolbote.7 b/linux/man/smolbote.7
index 9bf2458..e68248d 100644
--- a/linux/man/smolbote.7
+++ b/linux/man/smolbote.7
@@ -1,7 +1,7 @@
.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
-.TH "SMOLBOTE" "7" "February 2018" "" ""
+.TH "SMOLBOTE" "7" "March 2018" "" ""
.
.SH "NAME"
\fBsmolbote\fR \- yet another no\-frills browser
@@ -9,33 +9,177 @@
.SH "SYNOPSIS"
\fBpoi\fR [\fIoptions\fR\.\.\.] URL
.
+.SH "DESCRIPTION"
+smolbote is a keep\-it\-simple free software web browser\.
+.
.SH "OPTIONS"
.
-.TP
-\fB\-h\fR, \fB\-\-help\fR
-Displays this help\.
+.SS "General"
+.
+.IP "\(bu" 4
+\fB\-h\fR, \fB\-\-help\fR: Displays this help\.
+.
+.IP "\(bu" 4
+\fB\-v\fR, \fB\-\-version\fR: Displays version information\.
+.
+.IP "\(bu" 4
+\fB\-\-build\fR: Displays build information\.
+.
+.IP "" 0
+.
+.SS "Configuration"
+.
+.IP "\(bu" 4
+\fB\-c\fR, \fB\-\-config\fR: Set configuration file\.
+.
+.IP "\(bu" 4
+\fB\-\-socket\fR: Local server socket
+.
+.IP "" 0
+.
+.SS "Open URL"
+.
+.IP "\(bu" 4
+\fB\-p\fR, \fB\-\-profile\fR: Use this profile\.
+.
+.IP "\(bu" 4
+\fB\-\-in\-new\-window\fR: Open URL in new window\.
+.
+.IP "" 0
+.
+.SH "CONFIGURATION"
+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\.
+.
+.IP "\(bu" 4
+browser\.profile: Profile to be used by default, "" is off\-the\-record
+.
+.IP "" 0
+.
+.SS "Default window size"
+.
+.IP "\(bu" 4
+browser\.window\.height: 720
+.
+.IP "\(bu" 4
+browser\.window\.width: 1280
+.
+.IP "\(bu" 4
+browser\.window\.maximized: true
+.
+.IP "\(bu" 4
+browser\.window\.title: title — smolbote [profile]
+.
+.IP "" 0
+.
+.SS "Window UI"
+.
+.IP "\(bu" 4
+browser\.ui\.navtoolbarMovable: false
+.
+.IP "\(bu" 4
+browser\.ui\.tabtoolbarMovable: false
+.
+.IP "" 0
+.
+.SS "Shortcuts"
+.
+.IP "\(bu" 4
+browser\.shortcuts\.newWindow: Ctrl+N
+.
+.IP "\(bu" 4
+browser\.shortcuts\.newTab: Ctrl+T
+.
+.IP "\(bu" 4
+browser\.shortcuts\.about: F1
+.
+.IP "\(bu" 4
+browser\.shortcuts\.quit: Ctrl+Q
+.
+.IP "\(bu" 4
+browser\.shortcuts\.back: Ctrl+Left
+.
+.IP "\(bu" 4
+browser\.shortcuts\.forward: Ctrl+Right
+.
+.IP "\(bu" 4
+browser\.shortcuts\.refresh: F5
+.
+.IP "\(bu" 4
+browser\.shortcuts\.reload: Ctrl+F5
+.
+.IP "\(bu" 4
+browser\.shortcuts\.home: Ctrl+Home
+.
+.IP "\(bu" 4
+browser\.shortcuts\.tabClose: Ctrl+X
+.
+.IP "\(bu" 4
+browser\.shortcuts\.tabLeft: Ctrl+O
+.
+.IP "\(bu" 4
+browser\.shortcuts\.tabRight: Ctrl+P
+.
+.IP "\(bu" 4
+browser\.shortcuts\.toggleSearchBox: F3
+.
+.IP "\(bu" 4
+browser\.shortcuts\.focusAddress: F4
+.
+.IP "\(bu" 4
+browser\.shortcuts\.fullscreen: F11
+.
+.IP "" 0
+.
+.SS "Filter settings"
+.
+.IP "\(bu" 4
+filter\.path: ~/\.config/smolbote/hosts\.d
+.
+.IP "" 0
+.
+.SS "Plugin settings"
+.
+.IP "\(bu" 4
+plugins\.path: ~/\.config/smolbote/plugins\.d
+.
+.IP "" 0
+.
+.SS "Profile settings"
+.
+.IP "\(bu" 4
+profile\.path: ~/\.config/smolbote/profiles\.d
+.
+.IP "\(bu" 4
+profile\.search: https://duckduckgo\.com/?q=$term&ia=web
+.
+.IP "\(bu" 4
+profile\.homepage: about:blank
+.
+.IP "\(bu" 4
+profile\.newtab: about:blank
+.
+.IP "" 0
+.
+.SS "Bookmark settings"
+.
+.IP "\(bu" 4
+bookmarks\.path: ~/\.config/smolbote/bookmarks\.xbel
.
-.TP
-\fB\-v\fR, \fB\-\-version\fR
-Displays version information\.
+.IP "\(bu" 4
+bookmarks\.shortcut: Ctrl+B
.
-.TP
-\fB\-c\fR, \fB\-\-config\fR
-Set configuration file\.
+.IP "" 0
.
-.TP
-\fB\-\-default\-config\fR
-Set the default configuration file\.
+.SS "Downloads settings"
.
-.TP
-\fB\-p\fR, \fB\-\-profile\fR
-Use this profile\.
+.IP "\(bu" 4
+downloads\.path: ~/Downloads
.
-.TP
-\fB\-\-socket\fR
-Local server socket
+.IP "\(bu" 4
+downloads\.shortcut: Ctrl+D
.
-.TP
-\fB\-\-in\-new\-window\fR
-Open URL in new window
+.IP "" 0
diff --git a/linux/man/smolbote.7.html b/linux/man/smolbote.7.html
index c251436..b857c40 100644
--- a/linux/man/smolbote.7.html
+++ b/linux/man/smolbote.7.html
@@ -55,7 +55,9 @@
<div class='man-navigation' style='display:none'>
<a href="#NAME">NAME</a>
<a href="#SYNOPSIS">SYNOPSIS</a>
+ <a href="#DESCRIPTION">DESCRIPTION</a>
<a href="#OPTIONS">OPTIONS</a>
+ <a href="#CONFIGURATION">CONFIGURATION</a>
</div>
<ol class='man-decor man-head man head'>
@@ -73,23 +75,132 @@
<p><code>poi</code> [<var>options</var>...] URL</p>
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
+
+<p>smolbote is a keep-it-simple free software web browser.</p>
+
<h2 id="OPTIONS">OPTIONS</h2>
-<dl>
-<dt><code>-h</code>, <code>--help</code></dt><dd><p>Displays this help.</p></dd>
-<dt><code>-v</code>, <code>--version</code></dt><dd><p>Displays version information.</p></dd>
-<dt><code>-c</code>, <code>--config</code></dt><dd><p>Set configuration file.</p></dd>
-<dt><code>--default-config</code></dt><dd><p>Set the default configuration file.</p></dd>
-<dt><code>-p</code>, <code>--profile</code></dt><dd><p>Use this profile.</p></dd>
-<dt><code>--socket</code></dt><dd><p>Local server socket</p></dd>
-<dt><code>--in-new-window</code></dt><dd><p>Open URL in new window</p></dd>
-</dl>
+<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>
+</ul>
+
+
+<h3 id="Configuration">Configuration</h3>
+
+<ul>
+<li><code>-c</code>, <code>--config</code>: Set configuration file.</li>
+<li><code>--socket</code>: Local server socket</li>
+</ul>
+
+
+<h3 id="Open-URL">Open URL</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>
+</ul>
+
+
+<h2 id="CONFIGURATION">CONFIGURATION</h2>
+
+<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>
+
+<ul>
+<li>browser.profile: Profile to be used by default, "" is off-the-record</li>
+</ul>
+
+
+<h3 id="Default-window-size">Default window size</h3>
+
+<ul>
+<li>browser.window.height: 720</li>
+<li>browser.window.width: 1280</li>
+<li>browser.window.maximized: true</li>
+<li>browser.window.title: title — smolbote [profile]</li>
+</ul>
+
+
+<h3 id="Window-UI">Window UI</h3>
+
+<ul>
+<li>browser.ui.navtoolbarMovable: false</li>
+<li>browser.ui.tabtoolbarMovable: false</li>
+</ul>
+
+
+<h3 id="Shortcuts">Shortcuts</h3>
+
+<ul>
+<li>browser.shortcuts.newWindow: Ctrl+N</li>
+<li>browser.shortcuts.newTab: Ctrl+T</li>
+<li>browser.shortcuts.about: F1</li>
+<li><p>browser.shortcuts.quit: Ctrl+Q</p></li>
+<li><p>browser.shortcuts.back: Ctrl+Left</p></li>
+<li>browser.shortcuts.forward: Ctrl+Right</li>
+<li>browser.shortcuts.refresh: F5</li>
+<li>browser.shortcuts.reload: Ctrl+F5</li>
+<li><p>browser.shortcuts.home: Ctrl+Home</p></li>
+<li><p>browser.shortcuts.tabClose: Ctrl+X</p></li>
+<li>browser.shortcuts.tabLeft: Ctrl+O</li>
+<li><p>browser.shortcuts.tabRight: Ctrl+P</p></li>
+<li><p>browser.shortcuts.toggleSearchBox: F3</p></li>
+<li>browser.shortcuts.focusAddress: F4</li>
+<li>browser.shortcuts.fullscreen: F11</li>
+</ul>
+
+
+<h3 id="Filter-settings">Filter settings</h3>
+
+<ul>
+<li>filter.path: ~/.config/smolbote/hosts.d</li>
+</ul>
+
+
+<h3 id="Plugin-settings">Plugin settings</h3>
+
+<ul>
+<li>plugins.path: ~/.config/smolbote/plugins.d</li>
+</ul>
+
+
+<h3 id="Profile-settings">Profile settings</h3>
+
+<ul>
+<li>profile.path: ~/.config/smolbote/profiles.d</li>
+<li>profile.search: https://duckduckgo.com/?q=$term&amp;ia=web</li>
+<li>profile.homepage: about:blank</li>
+<li>profile.newtab: about:blank</li>
+</ul>
+
+
+<h3 id="Bookmark-settings">Bookmark settings</h3>
+
+<ul>
+<li>bookmarks.path: ~/.config/smolbote/bookmarks.xbel</li>
+<li>bookmarks.shortcut: Ctrl+B</li>
+</ul>
+
+
+<h3 id="Downloads-settings">Downloads settings</h3>
+
+<ul>
+<li>downloads.path: ~/Downloads</li>
+<li>downloads.shortcut: Ctrl+D</li>
+</ul>
<ol class='man-decor man-foot man foot'>
<li class='tl'></li>
- <li class='tc'>February 2018</li>
+ <li class='tc'>March 2018</li>
<li class='tr'>smolbote(7)</li>
</ol>
diff --git a/linux/man/smolbote.7.ronn b/linux/man/smolbote.7.ronn
index ece9697..c1e9aa0 100644
--- a/linux/man/smolbote.7.ronn
+++ b/linux/man/smolbote.7.ronn
@@ -5,25 +5,80 @@ smolbote(7) -- yet another no-frills browser
`poi` [<options>...] URL
+## DESCRIPTION
+
+smolbote is a keep-it-simple free software web browser.
+
## OPTIONS
-* `-h`, `--help`:
-Displays this help.
+### General
+* `-h`, `--help`: Displays this help.
+* `-v`, `--version`: Displays version information.
+* `--build`: Displays build information.
+
+### 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.
+
+## 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.
+
+* browser.profile: Profile to be used by default, "" is off-the-record
+
+### Default window size
+* browser.window.height: 720
+* browser.window.width: 1280
+* browser.window.maximized: true
+* browser.window.title: title — smolbote [profile]
+
+### Window UI
+* browser.ui.navtoolbarMovable: false
+* browser.ui.tabtoolbarMovable: false
+
+### Shortcuts
+* browser.shortcuts.newWindow: Ctrl+N
+* browser.shortcuts.newTab: Ctrl+T
+* browser.shortcuts.about: F1
+* browser.shortcuts.quit: Ctrl+Q
+
+* browser.shortcuts.back: Ctrl+Left
+* browser.shortcuts.forward: Ctrl+Right
+* browser.shortcuts.refresh: F5
+* browser.shortcuts.reload: Ctrl+F5
+* browser.shortcuts.home: Ctrl+Home
+
+* browser.shortcuts.tabClose: Ctrl+X
+* browser.shortcuts.tabLeft: Ctrl+O
+* browser.shortcuts.tabRight: Ctrl+P
-* `-v`, `--version`:
-Displays version information.
+* browser.shortcuts.toggleSearchBox: F3
+* browser.shortcuts.focusAddress: F4
+* browser.shortcuts.fullscreen: F11
-* `-c`, `--config`:
-Set configuration file.
+### Filter settings
+* filter.path: ~/.config/smolbote/hosts.d
-* `--default-config`:
-Set the default configuration file.
+### Plugin settings
+* plugins.path: ~/.config/smolbote/plugins.d
-* `-p`, `--profile`:
-Use this profile.
+### Profile settings
+* profile.path: ~/.config/smolbote/profiles.d
+* profile.search: https://duckduckgo.com/?q=$term&ia=web
+* profile.homepage: about:blank
+* profile.newtab: about:blank
-* `--socket`:
-Local server socket
+### Bookmark settings
+* bookmarks.path: ~/.config/smolbote/bookmarks.xbel
+* bookmarks.shortcut: Ctrl+B
-* `--in-new-window`:
-Open URL in new window
+### Downloads settings
+* downloads.path: ~/Downloads
+* downloads.shortcut: Ctrl+D
diff --git a/src/commandline.cpp b/src/commandline.cpp
index e7eec5d..2a0de69 100644
--- a/src/commandline.cpp
+++ b/src/commandline.cpp
@@ -50,7 +50,6 @@ CommandLine::CommandLine()
, versionOption(addVersionOption())
, buildOption("build", "Show build information.")
, configOption({ "c", "config" }, "Set configuration file.", "path", defaultUserConfigLocation())
- , defaultConfigOption("default-config", "Set the default configuration file.", "path", "")
, profileOption({ "p", "profile" }, "Use this profile.", "profile", "")
, socketOption("socket", "Local server socket", "name", socketPath())
, newWindowOption("in-new-window", "Open URL in new window")
@@ -59,7 +58,6 @@ CommandLine::CommandLine()
addOption(buildOption);
addOption(configOption);
- addOption(defaultConfigOption);
addOption(profileOption);
addOption(socketOption);
addOption(newWindowOption);
@@ -110,7 +108,6 @@ void CommandLine::printHelp(int exitCode)
printOption(versionOption);
printOption(buildOption);
printOption(configOption);
- printOption(defaultConfigOption);
printOption(profileOption);
printOption(socketOption);
printOption(newWindowOption);
diff --git a/src/commandline.h b/src/commandline.h
index d7416b7..f27041e 100644
--- a/src/commandline.h
+++ b/src/commandline.h
@@ -26,7 +26,6 @@ public:
const QCommandLineOption buildOption;
const QCommandLineOption configOption;
- const QCommandLineOption defaultConfigOption;
const QCommandLineOption profileOption;
const QCommandLineOption socketOption;
const QCommandLineOption newWindowOption;
diff --git a/src/main.cpp b/src/main.cpp
index dfaad50..102ac8e 100644
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -34,7 +34,6 @@ int main(int argc, char **argv)
#ifdef QT_DEBUG
qDebug("config=%s", qUtf8Printable(parser.value(parser.configOption)));
- qDebug("default-config=%s", qUtf8Printable(parser.value(parser.defaultConfigOption)));
qDebug("profile=%s", qUtf8Printable(parser.value(parser.profileOption)));
qDebug("socket=%s", qUtf8Printable(parser.value(parser.socketOption)));
@@ -42,14 +41,7 @@ int main(int argc, char **argv)
std::shared_ptr<Configuration> config = std::make_shared<Configuration>();
- // first load the default configuration
- if(!parser.value(parser.defaultConfigOption).isEmpty()) {
- qDebug("Reading default configuration [%s]: %s",
- qUtf8Printable(parser.value(parser.defaultConfigOption)),
- config->read(parser.value(parser.defaultConfigOption)) ? "ok" : "failed");
- }
-
- // then load in the user configuration, which will overwrite it
+ // load user configuration
if(!parser.value(parser.configOption).isEmpty()) {
qDebug("Reading configuration [%s]: %s",
qUtf8Printable(parser.value(parser.configOption)),