update exclude faq entry

[notmuch-wiki] / faq.mdwn

diff --git a/faq.mdwn b/faq.mdwn
index 8e2ad5258bdf84e89bcc396bc840752892d3e7fc..8f370e0e161386f502f2f26fbfbde96f3239c344 100644 (file)
--- a/faq.mdwn
+++ b/faq.mdwn
@@ -12,19 +12,30 @@ with the same message (i.e. the files have identical Message-ID). A
 `folder:` search will match the folder of any of the files. The
 `--output=files` option outputs all the files of all matching messages.
 
-## How come this query does not list all the emails on the file system? `notmuch search --output=files -- folder:inbox`
+## How come my query does not list all the emails on the file system?
 
-You may have emails that only have some of the excluded tags.
+You may have emails that have some of the [exclude
+tags](https://notmuchmail.org/doc/latest/man1/notmuch-search.html#cmdoption-search-exclude)
 
-Notmuch can be configured to exclude some tags while searching. You can list excluded tags with
+Notmuch can be configured to exclude some tags while searching. You
+can list excluded tags with
 
     $ notmuch config get search.exclude_tags
     deleted
 
-To verify this is the reason of the discrepancy, add the excluded tags explicitly to your query.
+To verify this is the reason of the discrepancy, add the excluded tags
+explicitly to your query. If the problematic query is
+
+    $ notmuch search --output=files -- folder:inbox
+
+Try
 
     $ notmuch search --output=files -- folder:inbox tag:deleted
 
+You can also temporarily turn of the excluded tags feature with `--exclude`.
+
+    $ notmuch search --output=files --exclude=false -- folder:inbox
+
 ## Shouldn't notmuch support inline PGP?
 
 [Why it might not be a good idea](https://dkg.fifthhorseman.net/notes/inline-pgp-harmful/)