From d360b24b0ccdfa6e08b8198a389870278d476848 Mon Sep 17 00:00:00 2001
From: Simon Lydell <simon.lydell@gmail.com>
Date: Sun, 22 Nov 2015 18:12:42 +0100
Subject: [PATCH] Add newbie info about Ignore mode and blacklist etc

See #619.
---
 documentation/options.md               |  2 ++
 documentation/questions-and-answers.md | 38 ++++++++++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/documentation/options.md b/documentation/options.md
index 52ead67..66ed359 100644
--- a/documentation/options.md
+++ b/documentation/options.md
@@ -68,6 +68,8 @@ Note that the URLs in the list must match the current URL _entirely_ for it to
 apply. Therefore it is easiest to always use the `*` wildcard (which matches
 zero or more characters).
 
+(Set the option to `*` to make VimFx start out in Ignore mode _everywhere._)
+
 You might also want to read about the [Ignore mode `<s-f1>` command][s-f1].
 
 [s-f1]: commands.md#ignore-mode-s-f1
diff --git a/documentation/questions-and-answers.md b/documentation/questions-and-answers.md
index 7c20e7f..f891323 100644
--- a/documentation/questions-and-answers.md
+++ b/documentation/questions-and-answers.md
@@ -6,6 +6,44 @@ See the file README.md for copying conditions.
 
 # Questions & Answers
 
+## What does `<s-escape>` mean?
+
+It means that you should press Escape while holding shift. In some other
+programs it might be written as `Shift+Escape`, but not in VimFx’s [key
+notation].
+
+(`<s-escape>` is the default shortcut to exit Ignore mode.)
+
+[key notation]: shortcuts.md#key-notation
+
+## How do I disable VimFx?
+
+If you press `i` you will enter Ignore mode. VimFx’s toolbar [button] turns red
+to reflect this.
+
+As you can see in VimFx’s Keyboard Shortcuts dialog (which you can open by
+pressing `?`), Ignore mode only has two shortcuts. That means that almost all
+key presses will be ignored by VimFx, and will be handled as if VimFx wasn’t
+installed.
+
+By adding `*currentdomain.com*` to the [blacklist] option you can make VimFx
+start out in Ignore mode on currentdomain.com. (Set the option to `*` to make
+VimFx start out in Ignore mode _everywhere._)
+
+Finally, there’s nothing stopping you from hitting the “Disable” button in the
+Add-ons Manager if you want to disable VimFx completely (just like you can with
+any add-on).
+
+[button]: button.md
+[blacklist]: options.md#blacklist
+
+## How do I get out of Ignore mode?
+
+Either press [`<s-escape>`] or click VimFx’s toolbar [button].
+
+[`<s-escape>`]: #what-does-s-escape-mean
+[button]: button.md
+
 ## How do i re-map `<escape>` to blur text inputs?
 
 The default shortcut is actually `<force><escape>`! Don’t forget [`<force>`] at
-- 
2.39.3