fixup! Greasemonkey: add FAQ entry.

Change the wording and the `--debug` suggestion.

Add comma after "this is currently not supported", I was tempted to add
a semicolon before it to but I resisted.

Added a "then" after QtWebEngine version list, not a comma.
This commit is contained in:
Jimmy 2018-03-14 20:19:51 +13:00
parent 2563ecf6d8
commit e5edc0f940

View File

@ -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.