cli: export function for illegal tag checking

[notmuch] / tag-util.h

diff --git a/tag-util.h b/tag-util.h
index 246de85ccb8f2a936f0adc6c50b6638607063f8d..8a4074ce168feb22a5d0ae93d0849b6861e171a7 100644 (file)
--- a/tag-util.h
+++ b/tag-util.h
@@ -81,12 +81,26 @@ parse_tag_line (void *ctx, char *line,
  * Output Parameters:
  *     ops     contains a list of tag operations
  *     query_str the search terms.
+ *
+ * The ops argument is not cleared.
  */
 
 tag_parse_status_t
 parse_tag_command_line (void *ctx, int argc, char **argv,
                        char **query_str, tag_op_list_t *ops);
 
+/*
+ * Test tags for some forbidden cases.
+ *
+ * Relax the checks if 'remove' is true to allow removal of previously
+ * added forbidden tags.
+ *
+ * return: NULL if OK,
+ *        explanatory message otherwise.
+ */
+const char *
+illegal_tag (const char *tag, notmuch_bool_t remove);
+
 /*
  * Create an empty list of tag operations
  *