From b02c406cb9885287a48ecdab3d941f78d31e531c Mon Sep 17 00:00:00 2001 From: John ShaggyTwoDope Jenkins Date: Tue, 23 Dec 2014 16:05:23 -0800 Subject: [PATCH 1/7] troubleshooting added to faq --- doc/FAQ.asciidoc | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/doc/FAQ.asciidoc b/doc/FAQ.asciidoc index f52b3a5d9..221bdf443 100644 --- a/doc/FAQ.asciidoc +++ b/doc/FAQ.asciidoc @@ -75,5 +75,46 @@ Is there an adblocker?:: usage], so implementing it properly might take some time and won't be done for v0.1 if at all. +== Troubleshooting + +Configuration not saved after modifiying config.:: + When editing your config file mannually, Qutebrowser must be exited completely. + Either by issuing the command `:quit` or by pressing `ctrl+q` (`alt+F4` on windows). + +Unable to view flash content.:: + If you have flash installed for on your system, it's nesscary to enable plugins + to use the flash plugin. Using the command `:set content allow-plugins true` + in qutebrowser will enable plugins. It may be helpful to close and re-open + the browser to allow plugins to load properly. Packages for flash should + be provided for your platform. Read any help documentation with regards to + installing flash from your operating systems. Flash can also be + obtained from http://get.adobe.com/flashplayer/[Adobe]. + This can also be set manaully in your config file located in + `~/.config/qutebrowser/qutebrowser.conf` on *nix systems. Before editing be + sure to exit completely. Locate the line `allow-plugins = false` and change + to `allow-plugins = true` save the file and load your browser and enjoy flash! + +Experiencing freezing on sites like duckduckgo and youtube.:: + When visiting some pages and you experience freezing, unable to close or unable exit + the browser. This can be solved by disabling plugins, or checking if you have + a package installed called mozplugger installed on your system. On Archlinux + and Debian/Ubuntu systems the package is called mozplugger. After removing the + package, you may need to also delete a file in your home plugin dir. It's named + `~/.mozilla/plugins/mozplugger*.so`. Be sure to exit the browser completely before + removing any plugins manually. See https://github.com/The-Compiler/qutebrowser/issues/357[Issue #357] + for more details. + +Experiencing segfaults (crashes) on Debian systems.:: + For Debian it's nessacary to install the `gstreamer0.10-plugins-base` package. + Either with apt-get or a tool like synaptic. With apt-get simply run + `sudo apt-get install gstreamer0.10-plugins-base` in a terminal or search + for the package name in synaptic and install like any other package. + +My issue is not listed here.:: + If you experience any segfaults or crashes, you can report the issue on + https://github.com/The-Compiler/qutebrowser/issues[qutebrowser issues]. + Be sure to read over how to create a stacktrace to report crashes of unknown cause + by visiting here https://github.com/The-Compiler/qutebrowser/blob/master/doc/stacktrace.asciidoc[reporting segfaults]. + // We link to github rather than to the file here so it also works with the // qutebrowser :help because that doesn't render HACKING. From b0c22b98675df1bd06726ec37a6ffec9de00d277 Mon Sep 17 00:00:00 2001 From: John ShaggyTwoDope Jenkins Date: Tue, 23 Dec 2014 16:17:57 -0800 Subject: [PATCH 2/7] troubleshooting typos --- doc/FAQ.asciidoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/FAQ.asciidoc b/doc/FAQ.asciidoc index 221bdf443..5e1831f76 100644 --- a/doc/FAQ.asciidoc +++ b/doc/FAQ.asciidoc @@ -77,19 +77,19 @@ Is there an adblocker?:: == Troubleshooting -Configuration not saved after modifiying config.:: - When editing your config file mannually, Qutebrowser must be exited completely. +Configuration not saved after modifying config.:: + When editing your config file manually, Qutebrowser must be exited completely. Either by issuing the command `:quit` or by pressing `ctrl+q` (`alt+F4` on windows). Unable to view flash content.:: - If you have flash installed for on your system, it's nesscary to enable plugins + If you have flash installed for on your system, it's necessary to enable plugins to use the flash plugin. Using the command `:set content allow-plugins true` in qutebrowser will enable plugins. It may be helpful to close and re-open the browser to allow plugins to load properly. Packages for flash should be provided for your platform. Read any help documentation with regards to installing flash from your operating systems. Flash can also be obtained from http://get.adobe.com/flashplayer/[Adobe]. - This can also be set manaully in your config file located in + This can also be set manually in your config file located in `~/.config/qutebrowser/qutebrowser.conf` on *nix systems. Before editing be sure to exit completely. Locate the line `allow-plugins = false` and change to `allow-plugins = true` save the file and load your browser and enjoy flash! @@ -105,7 +105,7 @@ Experiencing freezing on sites like duckduckgo and youtube.:: for more details. Experiencing segfaults (crashes) on Debian systems.:: - For Debian it's nessacary to install the `gstreamer0.10-plugins-base` package. + For Debian it's necessary to install the `gstreamer0.10-plugins-base` package. Either with apt-get or a tool like synaptic. With apt-get simply run `sudo apt-get install gstreamer0.10-plugins-base` in a terminal or search for the package name in synaptic and install like any other package. From 5562cc25e0d81f433ff426615ee0c2d1b237f05a Mon Sep 17 00:00:00 2001 From: John ShaggyTwoDope Jenkins Date: Wed, 24 Dec 2014 19:12:54 -0800 Subject: [PATCH 3/7] minor edits --- doc/FAQ.asciidoc | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/doc/FAQ.asciidoc b/doc/FAQ.asciidoc index 5e1831f76..085cf1ac7 100644 --- a/doc/FAQ.asciidoc +++ b/doc/FAQ.asciidoc @@ -78,14 +78,13 @@ Is there an adblocker?:: == Troubleshooting Configuration not saved after modifying config.:: - When editing your config file manually, Qutebrowser must be exited completely. + When editing your config file manually, qutebrowser must be exited completely. Either by issuing the command `:quit` or by pressing `ctrl+q` (`alt+F4` on windows). Unable to view flash content.:: If you have flash installed for on your system, it's necessary to enable plugins to use the flash plugin. Using the command `:set content allow-plugins true` - in qutebrowser will enable plugins. It may be helpful to close and re-open - the browser to allow plugins to load properly. Packages for flash should + in qutebrowser will enable plugins. Packages for flash should be provided for your platform. Read any help documentation with regards to installing flash from your operating systems. Flash can also be obtained from http://get.adobe.com/flashplayer/[Adobe]. @@ -93,28 +92,29 @@ Unable to view flash content.:: `~/.config/qutebrowser/qutebrowser.conf` on *nix systems. Before editing be sure to exit completely. Locate the line `allow-plugins = false` and change to `allow-plugins = true` save the file and load your browser and enjoy flash! - + Experiencing freezing on sites like duckduckgo and youtube.:: When visiting some pages and you experience freezing, unable to close or unable exit - the browser. This can be solved by disabling plugins, or checking if you have - a package installed called mozplugger installed on your system. On Archlinux + the browser. This can be solved by disabling plugins, or checking if you have + a package installed called mozplugger on your system. On Archlinux and Debian/Ubuntu systems the package is called mozplugger. After removing the - package, you may need to also delete a file in your home plugin dir. It's named - `~/.mozilla/plugins/mozplugger*.so`. Be sure to exit the browser completely before + package, you may need to also delete a few files in your home plugin dir. They are so + named `~/.mozilla/plugins/mozplugger*.so`. Be sure to exit the browser completely before removing any plugins manually. See https://github.com/The-Compiler/qutebrowser/issues/357[Issue #357] for more details. Experiencing segfaults (crashes) on Debian systems.:: For Debian it's necessary to install the `gstreamer0.10-plugins-base` package. - Either with apt-get or a tool like synaptic. With apt-get simply run - `sudo apt-get install gstreamer0.10-plugins-base` in a terminal or search - for the package name in synaptic and install like any other package. + This is a work around for a bug in Qt, it has been fixed upstream in Qt 5.4 + More details can be found + https://bugs.webkit.org/show_bug.cgi?id=119951[here] and + https://bugs.webkit.org/show_bug.cgi?id=119951[here]. -My issue is not listed here.:: - If you experience any segfaults or crashes, you can report the issue on +My issue is not listed.:: + If you experience any segfaults or crashes, you can report the issue on https://github.com/The-Compiler/qutebrowser/issues[qutebrowser issues]. Be sure to read over how to create a stacktrace to report crashes of unknown cause - by visiting here https://github.com/The-Compiler/qutebrowser/blob/master/doc/stacktrace.asciidoc[reporting segfaults]. + by visiting https://github.com/The-Compiler/qutebrowser/blob/master/doc/stacktrace.asciidoc[reporting segfaults]. // We link to github rather than to the file here so it also works with the // qutebrowser :help because that doesn't render HACKING. From 535db9d2a250d0a9a58082a8643a07410f686012 Mon Sep 17 00:00:00 2001 From: John ShaggyTwoDope Jenkins Date: Wed, 24 Dec 2014 19:25:07 -0800 Subject: [PATCH 4/7] ctrl+q for windows --- doc/FAQ.asciidoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/FAQ.asciidoc b/doc/FAQ.asciidoc index 085cf1ac7..f61504d12 100644 --- a/doc/FAQ.asciidoc +++ b/doc/FAQ.asciidoc @@ -79,7 +79,7 @@ Is there an adblocker?:: Configuration not saved after modifying config.:: When editing your config file manually, qutebrowser must be exited completely. - Either by issuing the command `:quit` or by pressing `ctrl+q` (`alt+F4` on windows). + Either by issuing the command `:quit` or by pressing `ctrl+q`. Unable to view flash content.:: If you have flash installed for on your system, it's necessary to enable plugins From d13296fe7d901e4d93fb77d656e75749fbc88252 Mon Sep 17 00:00:00 2001 From: John ShaggyTwoDope Jenkins Date: Wed, 24 Dec 2014 19:44:32 -0800 Subject: [PATCH 5/7] workaround zzz --- doc/FAQ.asciidoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/FAQ.asciidoc b/doc/FAQ.asciidoc index f61504d12..59296c83f 100644 --- a/doc/FAQ.asciidoc +++ b/doc/FAQ.asciidoc @@ -105,7 +105,7 @@ Experiencing freezing on sites like duckduckgo and youtube.:: Experiencing segfaults (crashes) on Debian systems.:: For Debian it's necessary to install the `gstreamer0.10-plugins-base` package. - This is a work around for a bug in Qt, it has been fixed upstream in Qt 5.4 + This is a workaround for a bug in Qt, it has been fixed upstream in Qt 5.4 More details can be found https://bugs.webkit.org/show_bug.cgi?id=119951[here] and https://bugs.webkit.org/show_bug.cgi?id=119951[here]. From fd5901070d059799b6a9c49f739c3537ea3d90d3 Mon Sep 17 00:00:00 2001 From: John ShaggyTwoDope Jenkins Date: Fri, 26 Dec 2014 11:26:06 -0800 Subject: [PATCH 6/7] adjustments added debian ubuntu crash info --- doc/FAQ.asciidoc | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/doc/FAQ.asciidoc b/doc/FAQ.asciidoc index 59296c83f..f8b27701b 100644 --- a/doc/FAQ.asciidoc +++ b/doc/FAQ.asciidoc @@ -94,11 +94,11 @@ Unable to view flash content.:: to `allow-plugins = true` save the file and load your browser and enjoy flash! Experiencing freezing on sites like duckduckgo and youtube.:: - When visiting some pages and you experience freezing, unable to close or unable exit - the browser. This can be solved by disabling plugins, or checking if you have + When visiting some pages and you experience freezing and you are unable to close or + exit the browser. In some cases this can be solved by disabling plugins, or checking if you have a package installed called mozplugger on your system. On Archlinux and Debian/Ubuntu systems the package is called mozplugger. After removing the - package, you may need to also delete a few files in your home plugin dir. They are so + package, you may need to also delete a few files in your home plugin dir. They are named `~/.mozilla/plugins/mozplugger*.so`. Be sure to exit the browser completely before removing any plugins manually. See https://github.com/The-Compiler/qutebrowser/issues/357[Issue #357] for more details. @@ -107,9 +107,14 @@ Experiencing segfaults (crashes) on Debian systems.:: For Debian it's necessary to install the `gstreamer0.10-plugins-base` package. This is a workaround for a bug in Qt, it has been fixed upstream in Qt 5.4 More details can be found - https://bugs.webkit.org/show_bug.cgi?id=119951[here] and https://bugs.webkit.org/show_bug.cgi?id=119951[here]. +Segfaults on Facebook,Medium,Amazon.:: + If you are on a Debian or Ubuntu based system, you might experience some crashes + visting these sites. It's caused by a known bug in Qt. But resolved in Qt 5.4. However + Debian and Ubuntu are slow to adopt or upgrade some packages. There is currently no + way at this time to manually upgrade to Qt 5.4 without issue. + My issue is not listed.:: If you experience any segfaults or crashes, you can report the issue on https://github.com/The-Compiler/qutebrowser/issues[qutebrowser issues]. From c57f0063bcb34ada91a65bfdf383265b4f1174b4 Mon Sep 17 00:00:00 2001 From: John ShaggyTwoDope Jenkins Date: Fri, 26 Dec 2014 17:39:04 -0800 Subject: [PATCH 7/7] spaces --- doc/FAQ.asciidoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/FAQ.asciidoc b/doc/FAQ.asciidoc index f8b27701b..57856f51b 100644 --- a/doc/FAQ.asciidoc +++ b/doc/FAQ.asciidoc @@ -109,7 +109,7 @@ Experiencing segfaults (crashes) on Debian systems.:: More details can be found https://bugs.webkit.org/show_bug.cgi?id=119951[here]. -Segfaults on Facebook,Medium,Amazon.:: +Segfaults on Facebook, Medium, Amazon.:: If you are on a Debian or Ubuntu based system, you might experience some crashes visting these sites. It's caused by a known bug in Qt. But resolved in Qt 5.4. However Debian and Ubuntu are slow to adopt or upgrade some packages. There is currently no