summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorFlorian Bruhin <me@the-compiler.org>2021-03-10 20:04:41 +0100
committerFlorian Bruhin <me@the-compiler.org>2021-03-10 20:08:10 +0100
commit6c67f927c8922f0bcf25b524dfb4a72455625f93 (patch)
treed843e1f0d3f5f13c9755dd3dd11569ec64d9b0a3 /doc
parente5bc14535395b36c129608e77793aebf3fc0afb5 (diff)
downloadqutebrowser-6c67f927c8922f0bcf25b524dfb4a72455625f93.tar.gz
qutebrowser-6c67f927c8922f0bcf25b524dfb4a72455625f93.zip
Make locale workaround configurable
See #6235
Diffstat (limited to 'doc')
-rw-r--r--doc/changelog.asciidoc6
-rw-r--r--doc/help/settings.asciidoc13
2 files changed, 19 insertions, 0 deletions
diff --git a/doc/changelog.asciidoc b/doc/changelog.asciidoc
index d57698df7..8bbaef0b1 100644
--- a/doc/changelog.asciidoc
+++ b/doc/changelog.asciidoc
@@ -97,6 +97,12 @@ Fixed
accidentally treated that as "@run-at document-idle". However, other
GreaseMonkey implementations default to "@run-at document-end" instead, which
is what qutebrowser now does, too.
+- With QtWebEngine 5.15.3 and some locales, Chromium can't start its
+ subprocesses. As a result, qutebrowser only shows a blank page and logs
+ "Network service crashed, restarting service.". This release adds a
+ `qt.workarounds.locale` setting working around the issue. It is disabled by
+ default since distributions shipping 5.15.3 will probably have a proper patch
+ for it backported very soon.
[[v2.0.2]]
v2.0.2 (2021-02-04)
diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index 392f60c49..7a5cfd47b 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -283,6 +283,7 @@
|<<qt.highdpi,qt.highdpi>>|Turn on Qt HighDPI scaling.
|<<qt.low_end_device_mode,qt.low_end_device_mode>>|When to use Chromium's low-end device mode.
|<<qt.process_model,qt.process_model>>|Which Chromium process model to use.
+|<<qt.workarounds.locale,qt.workarounds.locale>>|Work around locale parsing issues in QtWebEngine 5.15.3.
|<<qt.workarounds.remove_service_workers,qt.workarounds.remove_service_workers>>|Delete the QtWebEngine Service Worker directory on every start.
|<<scrolling.bar,scrolling.bar>>|When/how to show the scrollbar.
|<<scrolling.smooth,scrolling.smooth>>|Enable smooth scrolling for web pages.
@@ -3666,6 +3667,18 @@ Default: +pass:[process-per-site-instance]+
This setting is only available with the QtWebEngine backend.
+[[qt.workarounds.locale]]
+=== qt.workarounds.locale
+Work around locale parsing issues in QtWebEngine 5.15.3.
+With some locales, QtWebEngine 5.15.3 is unusable without this workaround. In affected scenarios, QtWebEngine will log "Network service crashed, restarting service." and only display a blank page.
+However, It is expected that distributions shipping QtWebEngine 5.15.3 follow up with a proper fix soon, so it is disabled by default.
+
+Type: <<types,Bool>>
+
+Default: +pass:[false]+
+
+This setting is only available with the QtWebEngine backend.
+
[[qt.workarounds.remove_service_workers]]
=== qt.workarounds.remove_service_workers
Delete the QtWebEngine Service Worker directory on every start.