X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;ds=sidebyside;f=excluding.mdwn;h=785d477a69f2a88103cec058e82e481ef4970bd4;hb=b29a6ed73fcb558763b7b646f690ebb4a239c872;hp=9d8a5dd648000e22758920bdc42c434036250aa6;hpb=4eec3beb80ff596ced2be515c64185c01903fb45;p=notmuch-wiki
diff --git a/excluding.mdwn b/excluding.mdwn
index 9d8a5dd..785d477 100644
--- a/excluding.mdwn
+++ b/excluding.mdwn
@@ -1,3 +1,4 @@
+[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
# Message exclusion and deletion
An important principle of notmuch is that it does not modify your mail
@@ -8,14 +9,14 @@ notmuch does not support, nor ever will, the deleting of messages,
notmuch has a couple of nice features that allow users to handle
excluding unwanted messages in a sensible way.
-## **message exclusion**
Notmuch has the ability to exclude message with certain tags from
search results. A common usage is to exclude "deleted" or "spam"
messages so that they don't clutter your search results. To enable
excludes, use the config utility:
- $ notmuch config set search.exclude_tags deleted spam
+ $ notmuch config set search.exclude_tags deleted spam
This will cause messages with the "deleted" or "spam" tags to be
excluded from search results.
@@ -23,7 +24,7 @@ excluded from search results.
It is still possible to find messages with excluded tags, though, by
manually including the excluded tag in your search:
- $ notmuch search from:foo and tag:spam
+ $ notmuch search from:foo and tag:spam
This will find messages from "foo" with the tag "spam", even though
"spam" is an excluded tag.
@@ -33,9 +34,9 @@ This will find messages from "foo" with the tag "spam", even though
Notmuch makes it very easy to access the underlying mail files
associated with specific search terms using the "file" output format
of notmuch search. To find all message files associated with the tag
-"foo" rung:
+"foo" run:
- $ notmuch search --output=files tag:foo
+ $ notmuch search --output=files tag:foo
This will output the paths to all message files with "tag:foo", one
per line.
@@ -43,35 +44,38 @@ per line.
This is useful in a number of different ways. For instance, it could
be used to train a spam filter:
- $ notmuch search --output=files tag:spam | sa-learn -f -
+ $ notmuch search --output=files tag:spam | sa-learn -f -
It can also be used to purge mail files from disk:
- $ notmuch search --output=files tag:deleted | xargs -l rm
+ $ notmuch search --format=text0 --output=files tag:deleted | xargs -0 --no-run-if-empty rm
Make sure you run "notmuch new" after the last command so the database
becomes aware that the files have been removed and can remove the
corresponding entries from the index.
-## **putting it all together**
So if you want to add message deletion to your work flow, here's a
procedure:
* Add exclusion for messages with the "deleted" tag:
- $ notmuch config set search.exclude_tags deleted
+ $ notmuch config set search.exclude_tags deleted
-* Add a key binding to your favorite ui to add a "deleted" tag to
- messages that you want to delete. In [[emacs|emacstips]] that might
- be:
-
- (define-key notmuch-show-mode-map "d"
- (lambda ()
- (interactive)
- (notmuch-show-tag "+deleted")))
+* In emacs MUA use keybinding `k d` to add a "deleted" tag to messages
+ that you want to delete.
* And, finally, if you _really_ want the messages purged from disk,
you can delete them manually with:
- $ notmuch search --output=files tag:deleted | xargs -l rm
+ $ notmuch search --output=files tag:deleted | xargs -l rm
+
+## **killing threads**
+
+In a [[hook|manpages/notmuch-hooks-5]]
+
+ notmuch tag +muted $(notmuch search --output=threads tag:muted)"
+
+New messages in the thread get the muted tag. Make muted an excluded tag.
+To kill a thread, tag it with muted, run notmuch new.