diff --git a/doc/faq.asciidoc b/doc/faq.asciidoc index 1c06d690a..5fd36d67b 100644 --- a/doc/faq.asciidoc +++ b/doc/faq.asciidoc @@ -225,20 +225,22 @@ How do I make qutebrowser use greasemonkey scripts?:: `:greasemonkey-reload`. + Troubleshooting: to check that your script is being loaded when -`:greasemonkey-reload` runs you can start qutebrowser with the `--debug` -argument and check the messages on the program's standard output with the -`greasemonkey` facility. If there are javascript errors with your script you -may also see messages with the `js` facility. +`:greasemonkey-reload` runs you can start qutebrowser with the arguments +`--debug --logfilter greasemonkey,js` and check the messages on the +program's standard output for errors parsing or loading your script. +You may also see javascript errors if your script is expecting an environment +that we fail to provide. + Note that there are some missing features which you may run into: . Some scripts expect `GM_xmlhttpRequest` to ignore Cross Origin Resource - Sharing restrictions, this is currently not supported so scripts making + Sharing restrictions, this is currently not supported, so scripts making requests to third party sites will often fail to function correctly. -. If your backend is a QtWebEngine version 5.8, 5.9 or 5.10 regular expressions - are not supported in `@include` or `@exclude` rules. If your script uses them - you can re-write them to use glob expressions or convert them to `@match` - rules. See https://wiki.greasespot.net/Metadata_Block[the wiki] for more info. +. If your backend is a QtWebEngine version 5.8, 5.9 or 5.10 then regular + expressions are not supported in `@include` or `@exclude` rules. If your + script uses them you can re-write them to use glob expressions or convert + them to `@match` rules. + See https://wiki.greasespot.net/Metadata_Block[the wiki] for more info. . Any greasemonkey API function to do with adding UI elements is not currently supported. That means context menu extentensions and background pages.