aboutsummaryrefslogtreecommitdiffhomepage
path: root/notmuch-client.h
diff options
context:
space:
mode:
authorGravatar Austin Clements <amdragon@MIT.EDU>2013-10-24 11:19:02 -0400
committerGravatar David Bremner <david@tethera.net>2013-11-08 20:13:58 -0400
commita24cd45568872d49c05bdd6193876cce6f01fe80 (patch)
tree969f42e3ed3e1b0eb099ce1d019fcd338f1e2685 /notmuch-client.h
parentec630c663597cc3d6f4f98f9ec4ec17a6c7b5bbc (diff)
cli: Separate current and deprecated format version
Previously, the CLI would print a deprecation warning if a client requested any format version other than the current one. However, if we add fields that are backwards-compatible, but want clients to be able to depend on, we need to bump the version, but that doesn't make the older version deprecated. Hence, separate out the "minimum active" version and only print a warning for requests below this version number.
Diffstat (limited to 'notmuch-client.h')
-rw-r--r--notmuch-client.h6
1 files changed, 6 insertions, 0 deletions
diff --git a/notmuch-client.h b/notmuch-client.h
index 0bfa4da9..4ecb3ae9 100644
--- a/notmuch-client.h
+++ b/notmuch-client.h
@@ -142,6 +142,12 @@ chomp_newline (char *str)
/* The minimum supported structured output format version. Requests
* for format versions below this will return an error. */
#define NOTMUCH_FORMAT_MIN 1
+/* The minimum non-deprecated structured output format version.
+ * Requests for format versions below this will print a stern warning.
+ * Must be between NOTMUCH_FORMAT_MIN and NOTMUCH_FORMAT_CUR,
+ * inclusive.
+ */
+#define NOTMUCH_FORMAT_MIN_ACTIVE 1
/* The output format version requested by the caller on the command
* line. If no format version is requested, this will be set to