X-Git-Url: https://git.sur5r.net/?p=i3%2Fi3;a=blobdiff_plain;f=include%2Fmatch.h;h=043c3a8f114e77401a5a5df2f8792b8780e4f150;hp=6c0694efeace588462c69fec845d00ba69188261;hb=HEAD;hpb=dc790cfa32e17cf975060f6575eead9b0bc3cfdb

diff --git a/include/match.h b/include/match.h
index 6c0694ef..043c3a8f 100644
--- a/include/match.h
+++ b/include/match.h
@@ -1,7 +1,21 @@
-#ifndef _MATCH_H
-#define _MATCH_H
-
 /*
+ * vim:ts=4:sw=4:expandtab
+ *
+ * i3 - an improved dynamic tiling window manager
+ * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
+ *
+ * A "match" is a data structure which acts like a mask or expression to match
+ * certain windows or not. For example, when using commands, you can specify a
+ * command like this: [title="*Firefox*"] kill. The title member of the match
+ * data structure will then be filled and i3 will check each window using
+ * match_matches_window() to find the windows affected by this command.
+ *
+ */
+#pragma once
+
+#include <config.h>
+
+/**
  * Initializes the Match data structure. This function is necessary because the
  * members representing boolean values (like dock) need to be initialized with
  * -1 instead of 0.
@@ -34,4 +48,8 @@ bool match_matches_window(Match *match, i3Window *window);
  */
 void match_free(Match *match);
 
-#endif
+/**
+ * Interprets a ctype=cvalue pair and adds it to the given match specification.
+ *
+ */
+void match_parse_property(Match *match, const char *ctype, const char *cvalue);