X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=lib%2Fnotmuch.h;h=2e59865633ffa6ce7b8206ec7d14ac1202b618e9;hb=f11aaa3678ab9d02d4ea98db1164772ed637404b;hp=e96474f65861b94b30d538f5e3baebb5da4bf0c9;hpb=44a74912c78526c1942a101a8172206a32885425;p=notmuch

diff --git a/lib/notmuch.h b/lib/notmuch.h
index e96474f6..2e598656 100644
--- a/lib/notmuch.h
+++ b/lib/notmuch.h
@@ -267,6 +267,19 @@ notmuch_database_add_message (notmuch_database_t *database,
 			      const char *filename,
 			      notmuch_message_t **message);
 
+/* Remove a message from the given notmuch database.
+ *
+ * Note that the only this particular filename association is removed
+ * from the database. If the same message (as determined by the
+ * message ID) is still available via other filenames, then the
+ * message will persist in the database for those filenames. When the
+ * last filename is removed for a particular message, the database
+ * content for that message will be entirely removed.
+ */
+notmuch_status_t
+notmuch_database_remove_message (notmuch_database_t *database,
+				 const char *filename);
+
 /* Find a message with the given message_id.
  *
  * If the database contains a message with the given message_id, then