X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=tag-util.h;h=ba0d98c858d52ffd9583a8af0c290bc7dc6e0daa;hp=246de85ccb8f2a936f0adc6c50b6638607063f8d;hb=963ccabe93b0564e6979433f5be34395e9aa8ef1;hpb=e9b6e464745fdebd4c6367dfc731859fe390b531

diff --git a/tag-util.h b/tag-util.h
index 246de85c..ba0d98c8 100644
--- a/tag-util.h
+++ b/tag-util.h
@@ -36,7 +36,7 @@ typedef enum {
 typedef enum {
     TAG_PARSE_OUT_OF_MEMORY = -1,
 
-    /* Line parsed successfuly. */
+    /* Line parsed successfully. */
     TAG_PARSE_SUCCESS = 0,
 
     /* Line has a syntax error */
@@ -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, bool remove);
+
 /*
  * Create an empty list of tag operations
  *
@@ -97,14 +111,14 @@ tag_op_list_t *
 tag_op_list_create (void *ctx);
 
 /*
- * Add a tag operation (delete iff remove == TRUE) to a list.
+ * Add a tag operation (delete iff remove == true) to a list.
  * The list is expanded as necessary.
  */
 
 int
 tag_op_list_append (tag_op_list_t *list,
 		    const char *tag,
-		    notmuch_bool_t remove);
+		    bool remove);
 
 /*
  * Apply a list of tag operations, in order, to a given message.
@@ -143,7 +157,7 @@ tag_op_list_tag (const tag_op_list_t *list, size_t i);
  *   Is the i'th tag operation a remove?
  */
 
-notmuch_bool_t
+bool
 tag_op_list_isremove (const tag_op_list_t *list, size_t i);
 
 #endif