From 6dd50c6ccaa131451cea90912e8abeb779fd3cb5 Mon Sep 17 00:00:00 2001
From: Benjamin Otte <otte@redhat.com>
Date: Thu, 29 Dec 2011 00:28:56 +0100
Subject: [PATCH] css: Add some docs to GtkCssLookup

In particular, document which parts of the CSS value querying we're
doing here.
---
 gtk/gtkcsslookup.c | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/gtk/gtkcsslookup.c b/gtk/gtkcsslookup.c
index a1e4247283..5badd7b403 100644
--- a/gtk/gtkcsslookup.c
+++ b/gtk/gtkcsslookup.c
@@ -68,6 +68,16 @@ _gtk_css_lookup_is_missing (const GtkCssLookup *lookup,
   return lookup->values[id] == NULL;
 }
 
+/**
+ * _gtk_css_lookup_set:
+ * @lookup: the lookup
+ * @id: id of the property to set, see _gtk_style_property_get_id()
+ * @value: the "cascading value" to use
+ *
+ * Sets the @value for a given @id. No value may have been set for @id
+ * before. See _gtk_css_lookup_is_missing(). This function is used to
+ * set the "winning declaration" of a lookup.
+ **/
 void
 _gtk_css_lookup_set (GtkCssLookup *lookup,
                      guint         id,
@@ -81,6 +91,18 @@ _gtk_css_lookup_set (GtkCssLookup *lookup,
   lookup->values[id] = value;
 }
 
+/**
+ * _gtk_css_lookup_resolve:
+ * @lookup: the lookup
+ *
+ * Resolves the current lookup into a styleproperties object. This is done
+ * by converting from the "winning declaration" to the "computed value".
+ *
+ * XXX: This bypasses the notion of "specified value". If this ever becomes
+ * an issue, go fix it.
+ *
+ * Returns: a new #GtkStyleProperties
+ **/
 GtkStyleProperties *
 _gtk_css_lookup_resolve (GtkCssLookup *lookup)
 {