GdkWindowX11: Only start a frame when we emit damage

[~andy/gtk] / gdk / gdkcolor.h

diff --git a/gdk/gdkcolor.h b/gdk/gdkcolor.h
index 97da01bf06239621b93ba2a49df604df17e5e435..74310f3716c51c50c60abcfd7af466f0713bdfab 100644 (file)
--- a/gdk/gdkcolor.h
+++ b/gdk/gdkcolor.h
@@ -12,9 +12,7 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
  */
 
 /*
@@ -24,21 +22,31 @@
  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  */
 
+#ifndef __GDK_COLOR_H__
+#define __GDK_COLOR_H__
+
 #if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
 #error "Only <gdk/gdk.h> can be included directly."
 #endif
 
-#ifndef __GDK_COLOR_H__
-#define __GDK_COLOR_H__
-
 #include <cairo.h>
 #include <gdk/gdktypes.h>
 
 G_BEGIN_DECLS
 
-/* The color type.
- *   A color consists of red, green and blue values in the
- *    range 0-65535 and a pixel value. The pixel value is unused.
+
+/**
+ * GdkColor:
+ * @pixel: For allocated colors, the pixel value used to
+ *     draw this color on the screen. Not used anymore.
+ * @red: The red component of the color. This is
+ *     a value between 0 and 65535, with 65535 indicating
+ *     full intensity
+ * @green: The green component of the color
+ * @blue: The blue component of the color
+ *
+ * The #GdkColor structure is used to describe a color,
+ * similar to the XColor struct used in the X11 drawing API.
  */
 struct _GdkColor
 {
@@ -48,18 +56,20 @@ struct _GdkColor
   guint16 blue;
 };
 
-#define GDK_TYPE_COLOR                 (gdk_color_get_type ())
+#define GDK_TYPE_COLOR (gdk_color_get_type ())
+
+GType     gdk_color_get_type (void) G_GNUC_CONST;
 
 GdkColor *gdk_color_copy      (const GdkColor *color);
 void      gdk_color_free      (GdkColor       *color);
-gboolean  gdk_color_parse     (const gchar    *spec,
-                              GdkColor       *color);
-guint     gdk_color_hash      (const GdkColor *colora);
+
+guint     gdk_color_hash      (const GdkColor *color);
 gboolean  gdk_color_equal     (const GdkColor *colora,
-                              const GdkColor *colorb);
-gchar *   gdk_color_to_string (const GdkColor *color);
+                               const GdkColor *colorb);
 
-GType     gdk_color_get_type (void) G_GNUC_CONST;
+gboolean  gdk_color_parse     (const gchar    *spec,
+                               GdkColor       *color);
+gchar *   gdk_color_to_string (const GdkColor *color);
 
 
 G_END_DECLS