X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=faq.mdwn;h=8f370e0e161386f502f2f26fbfbde96f3239c344;hp=652d33015b4afe427bec0784d36a43c6a3b1b306;hb=1a3ebd2306ac5ab74bb50ce94408f80739f23c23;hpb=7b273f786ab0355044cbc4cb059ad918abbb2a35

diff --git a/faq.mdwn b/faq.mdwn
index 652d330..8f370e0 100644
--- a/faq.mdwn
+++ b/faq.mdwn
@@ -12,18 +12,29 @@ 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
+    $ 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 tag:deleted
+    $ 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?
 
@@ -125,17 +136,22 @@ messages in threads that have at least one message with the muted tag:
 
         THREAD_TAGS="muted"
         for tag in "$THREAD_TAGS"; do
-                notmuch tag +$tag $(notmuch search --output=threads tag:$tag)
+                notmuch tag +$tag thread:{tag:$tag}
         done
 
-You can add other tags to `THREAD_TAGS` as needed. Note that this is one way
-only; you need to explicitly remove the tag from all the messages in a thread to
-stop it from propagating again.
+You can add other tags to `THREAD_TAGS` as needed. Note that this is
+one way only; you need to explicitly remove the tag from all the
+messages in a thread to stop it from propagating again. See
+[notmuch-search-terms](https://notmuchmail.org/doc/latest/man7/notmuch-search-terms.html)
+for discussion of `thread:{}` queries.
 
 
 ## How can I extract a git patchset for an email thread?
 
-See [notmuch-extract-patch](https://github.com/aaptel/notmuch-extract-patch).
+See
+[notmuch-extract-patch](https://github.com/aaptel/notmuch-extract-patch). See
+also notmuch-extract-patch in
+[mailscripts](https://git.spwhitton.name/mailscripts/).
 
 ## T150-tagging.sh is failing with Xapian 1.4.6