Updates config.py to newer version

1 files changed, 277 insertions, 58 deletions

diff --git a/config.dot/qutebrowser/config.py.link b/config.dot/qutebrowser/config.py.link
index 1a56821..caaebf5 100644
--- a/config.dot/qutebrowser/config.py.link
+++ b/config.dot/qutebrowser/config.py.link
@@ -10,7 +10,7 @@
 ## Aliases for commands. The keys of the given dictionary are the
 ## aliases, while the values are the commands they map to.
 ## Type: Dict
-# c.aliases = {'w': 'session-save', 'q': 'quit', 'wq': 'quit --save'}
+# c.aliases = {'w': 'session-save', 'q': 'close', 'qa': 'quit', 'wq': 'quit --save', 'wqa': 'quit --save'}
 
 ## Time interval (in milliseconds) between auto-saves of
 ## config/cookies/etc.
@@ -42,7 +42,7 @@
 ## when a key is bound (via `bindings.default` or `bindings.commands`),
 ## the mapping is ignored.
 ## Type: Dict
-# c.bindings.key_mappings = {'<Enter>': '<Return>', '<Shift-Enter>': '<Return>', '<Ctrl-M>': '<Return>', '<Ctrl-6>': '<Ctrl-^>', '<Shift-Return>': '<Return>', '<Ctrl-Enter>': '<Ctrl-Return>', '<Ctrl-[>': '<Escape>', '<Ctrl-J>': '<Return>'}
+# c.bindings.key_mappings = {'<Ctrl-[>': '<Escape>', '<Ctrl-6>': '<Ctrl-^>', '<Ctrl-M>': '<Return>', '<Ctrl-J>': '<Return>', '<Shift-Return>': '<Return>', '<Enter>': '<Return>', '<Shift-Enter>': '<Return>', '<Ctrl-Enter>': '<Ctrl-Return>'}
 
 ## Background color of the completion widget category headers.
 ## Type: QssColor
@@ -86,7 +86,7 @@
 # c.colors.completion.item.selected.fg = 'black'
 
 ## Foreground color of the matched text in the completion.
-## Type: QssColor
+## Type: QtColor
 # c.colors.completion.match.fg = '#ff4444'
 
 ## Background color of the completion widget for odd rows.
@@ -227,12 +227,12 @@
 ## Background color of the statusbar in caret mode.
 ## Type: QssColor
 # c.colors.statusbar.caret.bg = 'purple'
-c.colors.statusbar.normal.bg = '#1c1c1c'
-c.colors.tabs.even.bg = '#1c1c1c'
-c.colors.tabs.odd.bg = '#1c1c1c'
+c.colors.statusbar.normal.bg   = '#1c1c1c'
+c.colors.tabs.even.bg          = '#1c1c1c'
+c.colors.tabs.odd.bg           = '#1c1c1c'
 c.colors.tabs.selected.even.bg = '#444444'
-c.colors.tabs.selected.odd.bg = '#444444'
-c.fonts.messages.warning = '10pt monospace'
+c.colors.tabs.selected.odd.bg  = '#444444'
+c.fonts.messages.warning       = '10pt monospace'
 
 ## Foreground color of the statusbar in caret mode.
 ## Type: QssColor
@@ -405,6 +405,15 @@ c.fonts.messages.warning = '10pt monospace'
 ## Type: Int
 # c.completion.min_chars = 1
 
+## Which categories to show (in which order) in the :open completion.
+## Type: FlagList
+## Valid values:
+##   - searchengines
+##   - quickmarks
+##   - bookmarks
+##   - history
+# c.completion.open_categories = ['searchengines', 'quickmarks', 'bookmarks', 'history']
+
 ## Move on to the next part when there's only one possible completion
 ## left.
 ## Type: Bool
@@ -439,10 +448,18 @@ c.fonts.messages.warning = '10pt monospace'
 ## Type: Bool
 # c.completion.use_best_match = False
 
+## A list of patterns which should not be shown in the history. This only
+## affects the completion. Matching URLs are still saved in the history
+## (and visible on the qute://history page), but hidden in the
+## completion. Changing this setting will cause the completion history to
+## be regenerated on the next start, which will take a short while.
+## Type: List of UrlPattern
+# c.completion.web_history.exclude = []
+
 ## Number of URLs to show in the web history. 0: no history / -1:
 ## unlimited
 ## Type: Int
-# c.completion.web_history_max_items = -1
+# c.completion.web_history.max_items = -1
 
 ## Require a confirmation before quitting the application.
 ## Type: ConfirmQuit
@@ -453,6 +470,11 @@ c.fonts.messages.warning = '10pt monospace'
 ##   - never: Never show a confirmation.
 # c.confirm_quit = ['never']
 
+## Automatically start playing `<video>` elements. Note: On Qt < 5.11,
+## this option needs a restart and does not support URL patterns.
+## Type: Bool
+# c.content.autoplay = True
+
 ## Enable support for the HTML 5 web application cache feature. An
 ## application cache acts like an HTTP cache in some sense. For documents
 ## that use the application cache via JavaScript, the loader engine will
@@ -475,14 +497,19 @@ c.fonts.messages.warning = '10pt monospace'
 ## Type: Int
 # c.content.cache.size = None
 
+## Allow websites to read canvas elements. Note this is needed for some
+## websites to work properly.
+## Type: Bool
+# c.content.canvas_reading = True
+
 ## Which cookies to accept.
 ## Type: String
 ## Valid values:
 ##   - all: Accept all cookies.
-##   - no-3rdparty: Accept cookies from the same origin only.
-##   - no-unknown-3rdparty: Accept cookies from the same origin only, unless a cookie is already set for the domain.
+##   - no-3rdparty: Accept cookies from the same origin only. This is known to break some sites, such as GMail.
+##   - no-unknown-3rdparty: Accept cookies from the same origin only, unless a cookie is already set for the domain. On QtWebEngine, this is the same as no-3rdparty.
 ##   - never: Don't accept cookies at all.
-# c.content.cookies.accept = 'no-3rdparty'
+# c.content.cookies.accept = 'all'
 
 ## Store cookies. Note this option needs a restart with QtWebEngine on Qt
 ## < 5.9.
@@ -494,12 +521,14 @@ c.fonts.messages.warning = '10pt monospace'
 ## Type: String
 # c.content.default_encoding = 'iso-8859-1'
 
-## Enable extra tools for Web developers. This needs to be enabled for
-## `:inspector` to work and also adds an _Inspect_ entry to the context
-## menu. For QtWebEngine, see `--enable-webengine-inspector` in
-## `qutebrowser --help` instead.
-## Type: Bool
-# c.content.developer_extras = False
+## Allow websites to share screen content. On Qt < 5.10, a dialog box is
+## always displayed, even if this is set to "true".
+## Type: BoolAsk
+## Valid values:
+##   - true
+##   - false
+##   - ask
+# c.content.desktop_capture = 'ask'
 
 ## Try to pre-fetch DNS entries to speed up browsing.
 ## Type: Bool
@@ -518,7 +547,8 @@ c.fonts.messages.warning = '10pt monospace'
 ##   - ask
 # c.content.geolocation = 'ask'
 
-## Value to send in the `Accept-Language` header.
+## Value to send in the `Accept-Language` header. Note that the value
+## read from JavaScript is always the global value.
 ## Type: String
 # c.content.headers.accept_language = 'en-US,en'
 c.content.headers.accept_language = 'en-US,en;q=0.5'
@@ -535,18 +565,19 @@ c.content.headers.custom = {"accept": "text/html, */*; q=0.01"}
 # c.content.headers.do_not_track = True
 
 ## When to send the Referer header. The Referer header tells websites
-## from which website you were coming from when visting them.
+## from which website you were coming from when visiting them. No restart
+## is needed with QtWebKit.
 ## Type: String
 ## Valid values:
 ##   - always: Always send the Referer.
 ##   - never: Never send the Referer. This is not recommended, as some sites may break.
-##   - same-domain: Only send the Referer for the same domain. This will still protect your privacy, but shouldn't break any sites.
+##   - same-domain: Only send the Referer for the same domain. This will still protect your privacy, but shouldn't break any sites. With QtWebEngine, the referer will still be sent for other domains, but with stripped path information.
 # c.content.headers.referer = 'same-domain'
 
-## User agent to send. Unset to send the default.
+## User agent to send. Unset to send the default. Note that the value
+## read from JavaScript is always the global value.
 ## Type: String
 # c.content.headers.user_agent = None
-c.content.headers.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0'
 
 ## Enable host blocking.
 ## Type: Bool
@@ -555,15 +586,22 @@ c.content.headers.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/2
 ## List of URLs of lists which contain hosts to block.  The file can be
 ## in one of the following formats:  - An `/etc/hosts`-like file - One
 ## host per line - A zip-file of any of the above, with either only one
-## file, or a file   named `hosts` (with any extension).
+## file, or a file   named `hosts` (with any extension).  It's also
+## possible to add a local file or directory via a `file://` URL. In case
+## of a directory, all files in the directory are read as adblock lists.
+## The file `~/.config/qutebrowser/blocked-hosts` is always read if it
+## exists.
 ## Type: List of Url
-# c.content.host_blocking.lists = ['https://www.malwaredomainlist.com/hostslist/hosts.txt', 'http://someonewhocares.org/hosts/hosts', 'http://winhelp2002.mvps.org/hosts.zip', 'http://malwaredomains.lehigh.edu/files/justdomains.zip', 'https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&mimetype=plaintext']
-
-## List of domains that should always be loaded, despite being ad-
-## blocked. Domains may contain * and ? wildcards and are otherwise
-## required to exactly match the requested domain. Local domains are
-## always exempt from hostblocking.
-## Type: List of String
+# c.content.host_blocking.lists = ['https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts']
+
+## A list of patterns that should always be loaded, despite being ad-
+## blocked. Note this whitelists blocked hosts, not first-party URLs. As
+## an example, if `example.org` loads an ad from `ads.example.org`, the
+## whitelisted host should be `ads.example.org`. If you want to disable
+## the adblocker on a given page, use the `content.host_blocking.enabled`
+## setting with a URL pattern instead. Local domains are always exempt
+## from hostblocking.
+## Type: List of UrlPattern
 # c.content.host_blocking.whitelist = ['piwik.org']
 
 ## Enable hyperlink auditing (`<a ping>`).
@@ -601,7 +639,7 @@ c.content.headers.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/2
 ## logged, the corresponding dictionary value selects the qutebrowser
 ## logger to use. On QtWebKit, the "unknown" setting is always used.
 ## Type: Dict
-# c.content.javascript.log = {'info': 'debug', 'unknown': 'debug', 'warning': 'debug', 'error': 'debug'}
+# c.content.javascript.log = {'unknown': 'debug', 'info': 'debug', 'warning': 'debug', 'error': 'debug'}
 
 ## Use the standard JavaScript modal dialog for `alert()` and
 ## `confirm()`.
@@ -632,6 +670,20 @@ c.content.headers.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/2
 ##   - ask
 # c.content.media_capture = 'ask'
 
+## Allow websites to lock your mouse pointer.
+## Type: BoolAsk
+## Valid values:
+##   - true
+##   - false
+##   - ask
+# c.content.mouse_lock = 'ask'
+
+## Automatically mute tabs. Note that if the `:tab-mute` command is used,
+## the mute status for the affected tab is now controlled manually, and
+## this setting doesn't have any effect.
+## Type: Bool
+# c.content.mute = False
+
 ## Netrc-file for HTTP authentication. If unset, `~/.netrc` is used.
 ## Type: File
 # c.content.netrc_file = None
@@ -650,6 +702,15 @@ c.content.headers.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/2
 ## Type: Bool
 # c.content.pdfjs = False
 
+## Allow websites to request persistent storage quota via
+## `navigator.webkitPersistentStorage.requestQuota`.
+## Type: BoolAsk
+## Valid values:
+##   - true
+##   - false
+##   - ask
+# c.content.persistent_storage = 'ask'
+
 ## Enable plugins in Web pages.
 ## Type: Bool
 # c.content.plugins = False
@@ -675,6 +736,15 @@ c.content.headers.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/2
 ## Type: Bool
 # c.content.proxy_dns_requests = True
 
+## Allow websites to register protocol handlers via
+## `navigator.registerProtocolHandler`.
+## Type: BoolAsk
+## Valid values:
+##   - true
+##   - false
+##   - ask
+# c.content.register_protocol_handler = 'ask'
+
 ## Validate SSL handshakes.
 ## Type: BoolAsk
 ## Valid values:
@@ -689,8 +759,19 @@ c.content.headers.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/2
 
 ## Enable WebGL.
 ## Type: Bool
+# c.content.webgl = True
 c.content.webgl = False
 
+## Which interfaces to expose via WebRTC. On Qt 5.10, this option doesn't
+## work because of a Qt bug.
+## Type: String
+## Valid values:
+##   - all-interfaces: WebRTC has the right to enumerate all interfaces and bind them to discover public interfaces.
+##   - default-public-and-private-interfaces: WebRTC should only use the default route used by http. This also exposes the associated default private address. Default route is the route chosen by the OS on a multi-homed endpoint.
+##   - default-public-interface-only: WebRTC should only use the default route used by http. This doesn't expose any local addresses.
+##   - disable-non-proxied-udp: WebRTC should only use TCP to contact peers or servers unless the proxy server supports UDP. This doesn't expose any local addresses either.
+# c.content.webrtc_ip_handling_policy = 'all-interfaces'
+
 ## Limit fullscreen to the browser window (does not expand to fill the
 ## screen).
 ## Type: Bool
@@ -698,9 +779,9 @@ c.content.webgl = False
 
 ## Monitor load requests for cross-site scripting attempts. Suspicious
 ## scripts will be blocked and reported in the inspector's JavaScript
-## console. Enabling this feature might have an impact on performance.
+## console.
 ## Type: Bool
-# c.content.xss_auditing = False
+# c.content.xss_auditing = True
 
 ## Directory to save downloads to. If unset, a sensible OS-specific
 ## default is used.
@@ -912,6 +993,11 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ## Type: Bool
 # c.hints.scatter = True
 
+## CSS selectors used to determine which elements on a page should have
+## hints.
+## Type: Dict
+# c.hints.selectors = {'all': ['a', 'area', 'textarea', 'select', 'input:not([type="hidden"])', 'button', 'frame', 'iframe', 'img', 'link', 'summary', '[onclick]', '[onmousedown]', '[role="link"]', '[role="option"]', '[role="button"]', '[ng-click]', '[ngClick]', '[data-ng-click]', '[x-ng-click]', '[tabindex]'], 'links': ['a[href]', 'area[href]', 'link[href]', '[role="link"][href]'], 'images': ['img'], 'media': ['audio', 'img', 'video'], 'url': ['[src]', '[href]'], 'inputs': ['input[type="text"]', 'input[type="date"]', 'input[type="datetime-local"]', 'input[type="email"]', 'input[type="month"]', 'input[type="number"]', 'input[type="password"]', 'input[type="search"]', 'input[type="tel"]', 'input[type="time"]', 'input[type="url"]', 'input[type="week"]', 'input:not([type])', 'textarea']}
+
 ## Make characters in hint strings uppercase.
 ## Type: Bool
 # c.hints.uppercase = False
@@ -923,6 +1009,10 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ## Type: Int
 # c.history_gap_interval = 30
 
+## Allow Escape to quit the crash reporter.
+## Type: Bool
+# c.input.escape_quits_reporter = True
+
 ## Which unbound keys to forward to the webview in normal mode.
 ## Type: String
 ## Valid values:
@@ -931,6 +1021,10 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ##   - none: Don't forward any keys.
 # c.input.forward_unbound_keys = 'auto'
 
+## Enter insert mode if an editable element is clicked.
+## Type: Bool
+# c.input.insert_mode.auto_enter = True
+
 ## Leave insert mode if a non-editable element is clicked.
 ## Type: Bool
 # c.input.insert_mode.auto_leave = True
@@ -940,6 +1034,12 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ## Type: Bool
 # c.input.insert_mode.auto_load = False
 
+## Leave insert mode when starting a new page load. Patterns may be
+## unreliable on this setting, and they may match the url you are
+## navigating to, or the URL you are navigating from.
+## Type: Bool
+# c.input.insert_mode.leave_on_load = True
+
 ## Switch to insert mode when clicking flash and other plugins.
 ## Type: Bool
 # c.input.insert_mode.plugins = False
@@ -1033,9 +1133,15 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 # c.qt.force_platform = None
 
 ## Force software rendering for QtWebEngine. This is needed for
-## QtWebEngine to work with Nouveau drivers.
-## Type: Bool
-# c.qt.force_software_rendering = False
+## QtWebEngine to work with Nouveau drivers and can be useful in other
+## scenarios related to graphic issues.
+## Type: String
+## Valid values:
+##   - software-opengl: Tell LibGL to use a software implementation of GL (`LIBGL_ALWAYS_SOFTWARE` / `QT_XCB_FORCE_SOFTWARE_OPENGL`)
+##   - qt-quick: Tell Qt Quick to use a software renderer instead of OpenGL. (`QT_QUICK_BACKEND=software`)
+##   - chromium: Tell Chromium to disable GPU support and use Skia software rendering instead. (`--disable-gpu`)
+##   - none: Don't force software rendering.
+# c.qt.force_software_rendering = 'none'
 
 ## Turn on Qt HighDPI scaling. This is equivalent to setting
 ## QT_AUTO_SCREEN_SCALE_FACTOR=1 in the environment. It's off by default
@@ -1044,9 +1150,34 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ## Type: Bool
 # c.qt.highdpi = False
 
-## Show a scrollbar.
-## Type: Bool
-# c.scrolling.bar = False
+## When to use Chromium's low-end device mode. This improves the RAM
+## usage of renderer processes, at the expense of performance.
+## Type: String
+## Valid values:
+##   - always: Always use low-end device mode.
+##   - auto: Decide automatically (uses low-end mode with < 1 GB available RAM).
+##   - never: Never use low-end device mode.
+# c.qt.low_end_device_mode = 'auto'
+
+## Which Chromium process model to use. Alternative process models use
+## less resources, but decrease security and robustness. See the
+## following pages for more details:    -
+## https://www.chromium.org/developers/design-documents/process-models
+## - https://doc.qt.io/qt-5/qtwebengine-features.html#process-models
+## Type: String
+## Valid values:
+##   - process-per-site-instance: Pages from separate sites are put into separate processes and separate visits to the same site are also isolated.
+##   - process-per-site: Pages from separate sites are put into separate processes. Unlike Process per Site Instance, all visits to the same site will share an OS process. The benefit of this model is reduced memory consumption, because more web pages will share processes. The drawbacks include reduced security, robustness, and responsiveness.
+##   - single-process: Run all tabs in a single process. This should be used for debugging purposes only, and it disables `:open --private`.
+# c.qt.process_model = 'process-per-site-instance'
+
+## When to show the scrollbar.
+## Type: String
+## Valid values:
+##   - always: Always show the scrollbar.
+##   - never: Never show the scrollbar.
+##   - when-searching: Show the scrollbar when searching for text in the webpage. With the QtWebKit backend, this is equal to `never`.
+# c.scrolling.bar = 'when-searching'
 
 ## Enable smooth scrolling for web pages. Note smooth scrolling does not
 ## work with the `:scroll-px` command.
@@ -1054,7 +1185,7 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 # c.scrolling.smooth = False
 
 ## When to find text on a page case-insensitively.
-## Type: String
+## Type: IgnoreCase
 ## Valid values:
 ##   - always: Search case-insensitively.
 ##   - never: Search case-sensitively.
@@ -1131,7 +1262,7 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 
 ## Padding (in pixels) for the statusbar.
 ## Type: Padding
-# c.statusbar.padding = {'left': 0, 'bottom': 1, 'top': 1, 'right': 0}
+# c.statusbar.padding = {'top': 1, 'bottom': 1, 'left': 0, 'right': 0}
 
 ## Position of the status bar.
 ## Type: VerticalPosition
@@ -1140,6 +1271,18 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ##   - bottom
 # c.statusbar.position = 'bottom'
 
+## List of widgets displayed in the statusbar.
+## Type: List of String
+## Valid values:
+##   - url: Current page URL.
+##   - scroll: Percentage of the current page position like `10%`.
+##   - scroll_raw: Raw percentage of the current page position like `10`.
+##   - history: Display an arrow when possible to go back/forward in history.
+##   - tabs: Current active tab, e.g. `2`.
+##   - keypress: Display pressed keys when composing a vi command.
+##   - progress: Progress bar for the current page loading.
+# c.statusbar.widgets = ['keypress', 'url', 'scroll', 'history', 'tabs', 'progress']
+
 ## Open new tabs (middleclick/ctrl+click) in the background.
 ## Type: Bool
 # c.tabs.background = False
@@ -1166,13 +1309,17 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ## Type: Float
 # c.tabs.favicons.scale = 1.0
 
-## Show favicons in the tab bar.
-## Type: Bool
-# c.tabs.favicons.show = True
+## When to show favicons in the tab bar.
+## Type: String
+## Valid values:
+##   - always: Always show favicons.
+##   - never: Always hide favicons.
+##   - pinned: Show favicons only on pinned tabs.
+# c.tabs.favicons.show = 'always'
 
 ## Padding (in pixels) for tab indicators.
 ## Type: Padding
-# c.tabs.indicator.padding = {'left': 0, 'bottom': 2, 'top': 2, 'right': 4}
+# c.tabs.indicator.padding = {'top': 2, 'bottom': 2, 'left': 0, 'right': 4}
 
 ## Width (in pixels) of the progress indicator (0 to disable).
 ## Type: Int
@@ -1188,11 +1335,35 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ##   - close: Close the window.
 # c.tabs.last_close = 'ignore'
 
+## Maximum width (in pixels) of tabs (-1 for no maximum). This setting
+## only applies when tabs are horizontal. This setting does not apply to
+## pinned tabs, unless `tabs.pinned.shrink` is False. This setting may
+## not apply properly if max_width is smaller than the minimum size of
+## tab contents, or smaller than tabs.min_width.
+## Type: Int
+# c.tabs.max_width = -1
+
+## Minimum width (in pixels) of tabs (-1 for the default minimum size
+## behavior). This setting only applies when tabs are horizontal. This
+## setting does not apply to pinned tabs, unless `tabs.pinned.shrink` is
+## False.
+## Type: Int
+# c.tabs.min_width = -1
+
+## When switching tabs, what input mode is applied.
+## Type: String
+## Valid values:
+##   - persist: Retain the current mode.
+##   - restore: Restore previously saved mode.
+##   - normal: Always revert to normal mode.
+# c.tabs.mode_on_change = 'normal'
+
 ## Switch between tabs using the mouse wheel.
 ## Type: Bool
 # c.tabs.mousewheel_switching = True
 
-## Position of new tabs opened from another tab.
+## Position of new tabs opened from another tab. See
+## `tabs.new_position.stacking` for controlling stacking behavior.
 ## Type: NewTabPosition
 ## Valid values:
 ##   - prev: Before the current tab.
@@ -1201,7 +1372,14 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ##   - last: At the end.
 # c.tabs.new_position.related = 'next'
 
-## Position of new tabs which aren't opened from another tab.
+## Stack related tabs on top of each other when opened consecutively.
+## Only applies for `next` and `prev` values of
+## `tabs.new_position.related` and `tabs.new_position.unrelated`.
+## Type: Bool
+# c.tabs.new_position.stacking = True
+
+## Position of new tabs which are not opened from another tab. See
+## `tabs.new_position.stacking` for controlling stacking behavior.
 ## Type: NewTabPosition
 ## Valid values:
 ##   - prev: Before the current tab.
@@ -1212,11 +1390,11 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 
 ## Padding (in pixels) around text for tabs.
 ## Type: Padding
-# c.tabs.padding = {'left': 5, 'bottom': 0, 'top': 0, 'right': 5}
+# c.tabs.padding = {'top': 0, 'bottom': 0, 'left': 5, 'right': 5}
 
-## Stay in insert/passthrough mode when switching tabs.
+## Force pinned tabs to stay at fixed URL.
 ## Type: Bool
-# c.tabs.persist_mode_on_change = False
+# c.tabs.pinned.frozen = True
 
 ## Shrink pinned tabs down to their contents.
 ## Type: Bool
@@ -1274,9 +1452,10 @@ c.fonts.monospace = '"Inconsolata for Powerline", "xos4 Terminus", Terminus, Mon
 ## `{host}`: Host of the current web page. * `{backend}`: Either
 ## ''webkit'' or ''webengine'' * `{private}`: Indicates when private mode
 ## is enabled. * `{current_url}`: URL of the current web page. *
-## `{protocol}`: Protocol (http/https/...) of the current web page.
+## `{protocol}`: Protocol (http/https/...) of the current web page. *
+## `{audio}`: Indicator for audio/mute status.
 ## Type: FormatString
-# c.tabs.title.format = '{index}: {title}'
+# c.tabs.title.format = '{audio}{index}: {title}'
 
 ## Format to use for the tab title for pinned tabs. The same placeholders
 ## like for `tabs.title.format` are defined.
@@ -1311,11 +1490,17 @@ c.url.default_page = 'about:blank'
 ## Type: FlagList
 ## Valid values:
 ##   - host
+##   - port
 ##   - path
 ##   - query
 ##   - anchor
 # c.url.incdec_segments = ['path', 'query']
 
+## Open base URL of the searchengine if a searchengine shortcut is
+## invoked without parameters.
+## Type: Bool
+# c.url.open_base_url = False
+
 ## Search engines which can be used via the address bar. Maps a search
 ## engine name (such as `DEFAULT`, or `ddg`) to a URL with a `{}`
 ## placeholder. The placeholder will be replaced by the search term, use
@@ -1335,9 +1520,10 @@ c.url.default_page = 'about:blank'
 ## Type: List of String
 # c.url.yank_ignored_parameters = ['ref', 'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']
 
-## Hide the window decoration when using wayland.
+## Hide the window decoration.  This setting requires a restart on
+## Wayland.
 ## Type: Bool
-# c.window.hide_wayland_decoration = False
+# c.window.hide_decoration = False
 
 ## Format to use for the window title. The same placeholders like for
 ## `tabs.title.format` are defined.
@@ -1389,6 +1575,7 @@ c.url.default_page = 'about:blank'
 # config.bind('<Alt-7>', 'tab-focus 7')
 # config.bind('<Alt-8>', 'tab-focus 8')
 # config.bind('<Alt-9>', 'tab-focus -1')
+# config.bind('<Alt-m>', 'tab-mute')
 # config.bind('<Ctrl-A>', 'navigate increment')
 # config.bind('<Ctrl-Alt-p>', 'print')
 # config.bind('<Ctrl-B>', 'scroll-page 0 -1')
@@ -1402,6 +1589,7 @@ c.url.default_page = 'about:blank'
 # config.bind('<Ctrl-Return>', 'follow-selected -t')
 # config.bind('<Ctrl-Shift-N>', 'open -p')
 # config.bind('<Ctrl-Shift-T>', 'undo')
+# config.bind('<Ctrl-Shift-Tab>', 'nop')
 # config.bind('<Ctrl-Shift-W>', 'close')
 # config.bind('<Ctrl-T>', 'open -t')
 # config.bind('<Ctrl-Tab>', 'tab-focus last')
@@ -1456,6 +1644,7 @@ c.url.default_page = 'about:blank'
 # config.bind('g0', 'tab-focus 1')
 # config.bind('gB', 'set-cmd-text -s :bookmark-load -t')
 # config.bind('gC', 'tab-clone')
+# config.bind('gD', 'tab-give')
 # config.bind('gO', 'set-cmd-text :open -t -r {url:pretty}')
 # config.bind('gU', 'navigate up -t')
 # config.bind('g^', 'tab-focus 1')
@@ -1464,6 +1653,7 @@ c.url.default_page = 'about:blank'
 # config.bind('gd', 'download')
 # config.bind('gf', 'view-source')
 # config.bind('gg', 'scroll-to-perc 0')
+# config.bind('gi', 'hint inputs --first')
 # config.bind('gl', 'tab-move -')
 # config.bind('gm', 'tab-move')
 # config.bind('go', 'set-cmd-text :open {url:pretty}')
@@ -1486,8 +1676,26 @@ c.url.default_page = 'about:blank'
 # config.bind('sk', 'set-cmd-text -s :bind')
 # config.bind('sl', 'set-cmd-text -s :set -t')
 # config.bind('ss', 'set-cmd-text -s :set')
+# config.bind('tIH', 'config-cycle -p -u *://*.{url:host}/* content.images ;; reload')
+# config.bind('tIh', 'config-cycle -p -u *://{url:host}/* content.images ;; reload')
+# config.bind('tIu', 'config-cycle -p -u {url} content.images ;; reload')
+# config.bind('tPH', 'config-cycle -p -u *://*.{url:host}/* content.plugins ;; reload')
+# config.bind('tPh', 'config-cycle -p -u *://{url:host}/* content.plugins ;; reload')
+# config.bind('tPu', 'config-cycle -p -u {url} content.plugins ;; reload')
+# config.bind('tSH', 'config-cycle -p -u *://*.{url:host}/* content.javascript.enabled ;; reload')
+# config.bind('tSh', 'config-cycle -p -u *://{url:host}/* content.javascript.enabled ;; reload')
+# config.bind('tSu', 'config-cycle -p -u {url} content.javascript.enabled ;; reload')
 # config.bind('th', 'back -t')
+# config.bind('tiH', 'config-cycle -p -t -u *://*.{url:host}/* content.images ;; reload')
+# config.bind('tih', 'config-cycle -p -t -u *://{url:host}/* content.images ;; reload')
+# config.bind('tiu', 'config-cycle -p -t -u {url} content.images ;; reload')
 # config.bind('tl', 'forward -t')
+# config.bind('tpH', 'config-cycle -p -t -u *://*.{url:host}/* content.plugins ;; reload')
+# config.bind('tph', 'config-cycle -p -t -u *://{url:host}/* content.plugins ;; reload')
+# config.bind('tpu', 'config-cycle -p -t -u {url} content.plugins ;; reload')
+# config.bind('tsH', 'config-cycle -p -t -u *://*.{url:host}/* content.javascript.enabled ;; reload')
+# config.bind('tsh', 'config-cycle -p -t -u *://{url:host}/* content.javascript.enabled ;; reload')
+# config.bind('tsu', 'config-cycle -p -t -u {url} content.javascript.enabled ;; reload')
 # config.bind('u', 'undo')
 # config.bind('v', 'enter-mode caret')
 # config.bind('wB', 'set-cmd-text -s :bookmark-load -w')
@@ -1503,10 +1711,12 @@ c.url.default_page = 'about:blank'
 # config.bind('xO', 'set-cmd-text :open -b -r {url:pretty}')
 # config.bind('xo', 'set-cmd-text -s :open -b')
 # config.bind('yD', 'yank domain -s')
+# config.bind('yM', 'yank markdown -s')
 # config.bind('yP', 'yank pretty-url -s')
 # config.bind('yT', 'yank title -s')
 # config.bind('yY', 'yank -s')
 # config.bind('yd', 'yank domain')
+# config.bind('ym', 'yank markdown')
 # config.bind('yp', 'yank pretty-url')
 # config.bind('yt', 'yank title')
 # config.bind('yy', 'yank')
@@ -1587,13 +1797,15 @@ config.bind('q', 'quit --save')
 # config.bind('<Shift-Ins>', 'insert-text {primary}', mode='insert')
 
 ## Bindings for passthrough mode
-# config.bind('<Ctrl-V>', 'leave-mode', mode='passthrough')
+# config.bind('<Shift-Escape>', 'leave-mode', mode='passthrough')
 
 ## Bindings for prompt mode
 # config.bind('<Alt-B>', 'rl-backward-word', mode='prompt')
 # config.bind('<Alt-Backspace>', 'rl-backward-kill-word', mode='prompt')
 # config.bind('<Alt-D>', 'rl-kill-word', mode='prompt')
 # config.bind('<Alt-F>', 'rl-forward-word', mode='prompt')
+# config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='prompt')
+# config.bind('<Alt-Y>', 'prompt-yank', mode='prompt')
 # config.bind('<Ctrl-?>', 'rl-delete-char', mode='prompt')
 # config.bind('<Ctrl-A>', 'rl-beginning-of-line', mode='prompt')
 # config.bind('<Ctrl-B>', 'rl-backward-char', mode='prompt')
@@ -1601,6 +1813,7 @@ config.bind('q', 'quit --save')
 # config.bind('<Ctrl-F>', 'rl-forward-char', mode='prompt')
 # config.bind('<Ctrl-H>', 'rl-backward-delete-char', mode='prompt')
 # config.bind('<Ctrl-K>', 'rl-kill-line', mode='prompt')
+# config.bind('<Ctrl-P>', 'prompt-open-download --pdfjs', mode='prompt')
 # config.bind('<Ctrl-U>', 'rl-unix-line-discard', mode='prompt')
 # config.bind('<Ctrl-W>', 'rl-unix-word-rubout', mode='prompt')
 # config.bind('<Ctrl-X>', 'prompt-open-download', mode='prompt')
@@ -1611,8 +1824,14 @@ config.bind('q', 'quit --save')
 # config.bind('<Shift-Tab>', 'prompt-item-focus prev', mode='prompt')
 # config.bind('<Tab>', 'prompt-item-focus next', mode='prompt')
 # config.bind('<Up>', 'prompt-item-focus prev', mode='prompt')
-# config.bind('n', 'prompt-accept no', mode='prompt')
-# config.bind('y', 'prompt-accept yes', mode='prompt')
 
 ## Bindings for register mode
 # config.bind('<Escape>', 'leave-mode', mode='register')
+
+## Bindings for yesno mode
+# config.bind('<Alt-Shift-Y>', 'prompt-yank --sel', mode='yesno')
+# config.bind('<Alt-Y>', 'prompt-yank', mode='yesno')
+# config.bind('<Escape>', 'leave-mode', mode='yesno')
+# config.bind('<Return>', 'prompt-accept', mode='yesno')
+# config.bind('n', 'prompt-accept no', mode='yesno')
+# config.bind('y', 'prompt-accept yes', mode='yesno')