Merge pull request #1009 from newsboat/feature/faq-answer-browser-error-code

Add FAQ item about browser errors in 2.18

1 files changed, 25 insertions, 0 deletions

diff --git a/doc/faq.asciidoc b/doc/faq.asciidoc
index 0213ec5f..0e0d760a 100644
--- a/doc/faq.asciidoc
+++ b/doc/faq.asciidoc
@@ -78,3 +78,28 @@ Finally, if you understand what a "MITM attack" is, and are certain that it
 can't happen in your setup, check out <<newsboat#_first_steps,a list of
 Newsboat's configuration options>> for ways to entirely disable SSL
 verification.
+
+== Newsboat 2.18 complains that "Browser returned error code <some number>"
+
+That Newsboat version misinterprets the browser's exit code. Please upgrade to
+Newsboat 2.19 or newer.
+
+If upgrading is not an option, wrap the browser in a script to hide its exit
+code from Newsboat:
+
+1. Put this in `~/bin/newsboat-browser.sh`:
++
+    #/bin/sh
+    /usr/bin/firefox "$@"
+    exit 0
++
+Replace `/usr/bin/firefox` with the path to your browser. The last line is the
+important bit.
+
+2. Make it executable:
++
+    $ chmod +x ~/bin/newsboat-browser.sh
+
+3. Add the following to your Newsboat's config:
++
+    browser "~/bin/newsboat-browser.sh"