notmuch show: Add a one-line summary of the message before the header.

[notmuch] / notmuch.h

diff --git a/notmuch.h b/notmuch.h
index a17c7020177a5cff0844db28abe30b952e919542..3f59709a579542db6eeaa1d00baa7022eff9396f 100644 (file)
--- a/notmuch.h
+++ b/notmuch.h
@@ -617,6 +617,24 @@ notmuch_message_get_thread_id (notmuch_message_t *message);
 const char *
 notmuch_message_get_filename (notmuch_message_t *message);
 
+/* Get the date of 'message' as a time_t value.
+ *
+ * For the original textual representation of the Date header from the
+ * message call notmuch_message_get_header() with a header value of
+ * "date". */
+time_t
+notmuch_message_get_date  (notmuch_message_t *message);
+
+/* Get the size in bytes of the full header section of 'message'.
+ *
+ * This is useful in conjunction with notmuch_message_get_filename
+ * for separately parsing the message header and content.
+ *
+ * Returns 0 in the case of any error.
+ */
+size_t
+notmuch_message_get_header_size (notmuch_message_t *message);
+
 /* Get the value of the specified header from 'message'.
  *
  * The value will be read from the actual message file, not from the