Update doc comments.

eek/eek-key.h

@@ -40,6 +40,12 @@ G_BEGIN_DECLS
 typedef struct _EekKeyClass EekKeyClass;
 typedef struct _EekKeyPrivate EekKeyPrivate;
 
+/**
+ * EekKey:
+ *
+ * The #EekKey structure contains only private data and should only be
+ * accessed using the provided API.
+ */
 struct _EekKey
 {
     /*< private >*/
@@ -64,6 +70,7 @@ struct _EekKey
  * @released: class handler for #EekKey::released signal
  * @locked: class handler for #EekKey::locked signal
  * @unlocked: class handler for #EekKey::unlocked signal
+ * @cancelled: class handler for #EekKey::cancelled signal
  * @is_pressed: virtual function for getting whether the key is pressed
  * @is_locked: virtual function for getting whether the key is locked
  */

eek/eek-keyboard.c

@@ -949,8 +949,8 @@ eek_keyboard_get_alt_gr_mask (EekKeyboard *keyboard)
  * @keyboard: an #EekKeyboard
  *
  * Get pressed keys.
- * Returns: (transfer container) (element-type EekModifierKey): A list
- * of pressed keys.
+ * Returns: (transfer container) (element-type EekKey): A list of
+ * pressed keys.
  */
 GList *
 eek_keyboard_get_pressed_keys (EekKeyboard *keyboard)

eek/eek-keyboard.h

@@ -106,7 +106,16 @@ struct _EekKeyboardClass
     gpointer pdummy[21];
 };
 
+/**
+ * EekModifierKey:
+ * @modifiers: an #EekModifierType which @key triggers
+ * @key: an #EekKey
+ *
+ * Entry which associates modifier mask to a key.  This is returned by
+ * eek_keyboard_get_locked_keys().
+ */
 struct _EekModifierKey {
+    /*< public >*/
     EekModifierType modifiers;
     EekKey *key;
 };

eek/eek-keysym.h

@@ -47,6 +47,12 @@ G_BEGIN_DECLS
 typedef struct _EekKeysymClass EekKeysymClass;
 typedef struct _EekKeysymPrivate EekKeysymPrivate;
 
+/**
+ * EekKeysym:
+ *
+ * The #EekKeysym structure contains only private data and should only
+ * be accessed using the provided API.
+ */
 struct _EekKeysym {
     /*< private >*/
     EekSymbol parent;
@@ -65,7 +71,7 @@ guint      eek_keysym_get_xkeysym       (EekKeysym      *keysym);
 
 EekKeysym *eek_keysym_new_from_name     (const gchar    *name);
 EekKeysym *eek_keysym_new_with_modifier (guint           xkeysym,
-                                         EekModifierType modifier);
+                                         EekModifierType modifier_mask);
 
 G_END_DECLS
 

eek/eek-section.h

@@ -41,6 +41,12 @@ G_BEGIN_DECLS
 typedef struct _EekSectionClass EekSectionClass;
 typedef struct _EekSectionPrivate EekSectionPrivate;
 
+/**
+ * EekSection:
+ *
+ * The #EekSection structure contains only private data and should
+ * only be accessed using the provided API.
+ */
 struct _EekSection
 {
     /*< private >*/
@@ -63,6 +69,7 @@ struct _EekSection
  * @key_released: class handler for #EekSection::key-released signal
  * @key_locked: class handler for #EekSection::key-locked signal
  * @key_unlocked: class handler for #EekSection::key-unlocked signal
+ * @key_cancelled: class handler for #EekSection::key-cancelled signal
  */
 struct _EekSectionClass
 {

eek/eek-serializable.c

@@ -20,11 +20,11 @@
 
 /**
  * SECTION:eek-serializable
- * @short_description: Interface implemented by #EekElement to
- * serialize it to #GVariant
+ * @short_description: Interface which provides object serialization
+ * into #GVariant
  *
  * The #EekSerializableIface interface defines serialize/deserialize
- * method of #EekElement.
+ * method.
  */
 
 #ifdef HAVE_CONFIG_H

eek/eek-symbol-matrix.h

@@ -34,6 +34,7 @@ G_BEGIN_DECLS
  */
 struct _EekSymbolMatrix
 {
+    /*< public >*/
     gint num_groups;
     gint num_levels;
     EekSymbol **data;

eek/eek-symbol.h

@@ -102,9 +102,9 @@ void                  eek_symbol_set_category  (EekSymbol        *symbol,
                                                 EekSymbolCategory category);
 EekSymbolCategory     eek_symbol_get_category  (EekSymbol        *symbol);
 EekModifierType       eek_symbol_get_modifier_mask
-                                               (EekSymbol        *keysym);
+                                               (EekSymbol        *symbol);
 void                  eek_symbol_set_modifier_mask
-                                               (EekSymbol        *keysym,
+                                               (EekSymbol        *symbol,
                                                 EekModifierType   mask);
 gboolean              eek_symbol_is_modifier   (EekSymbol        *symbol);
 void                  eek_symbol_set_icon_name (EekSymbol        *symbol,

eek/eek-types.c

@@ -20,7 +20,8 @@
 
 /**
  * SECTION:eek-types
- * @short_description: Miscellaneous types
+ * @title: Miscellaneous Types
+ * @short_description: Miscellaneous types used in Libeek
  */
 
 #ifdef HAVE_CONFIG_H

eek/eek-types.h

@@ -159,6 +159,7 @@ typedef struct _EekColor EekColor;
 typedef struct _EekPoint EekPoint;
 struct _EekPoint
 {
+    /*< public >*/
     gdouble x;
     gdouble y;
 };
@@ -180,6 +181,7 @@ void      eek_point_rotate   (EekPoint       *point,
  */
 struct _EekBounds
 {
+    /*< public >*/
     gdouble x;
     gdouble y;
     gdouble width;
@@ -206,6 +208,7 @@ eek_bounds_long_side (EekBounds *bounds)
  */
 struct _EekOutline
 {
+    /*< public >*/
     gdouble corner_radius;
     EekPoint *points;
     gint num_points;
@@ -226,6 +229,7 @@ void        eek_outline_free     (EekOutline       *outline);
  */
 struct _EekColor
 {
+    /*< public >*/
     gdouble red;
     gdouble green;
     gdouble blue;

eek/eek-xml.c

@@ -18,6 +18,7 @@
 
 /**
  * SECTION: eek-xml
+ * @title: XML Conversion Utilities
  * @short_description: #EekKeyboard to XML conversion utilities
  */
 

eek/eek.c

@@ -1,5 +1,40 @@
+/* 
+ * Copyright (C) 2011 Daiki Ueno <ueno@unixuser.org>
+ * Copyright (C) 2011 Red Hat, Inc.
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public License
+ * as published by the Free Software Foundation; either version 2 of
+ * the License, or (at your option) any later version.
+ * 
+ * This library is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * 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., 51 Franklin Street, Fifth Floor, Boston, MA
+ * 02110-1301 USA
+ */
+
+/**
+ * SECTION:eek
+ * @title: Library Initialization
+ */
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif  /* HAVE_CONFIG_H */
+
 #include "eek.h"
 
+/**
+ * eek_init:
+ *
+ * Initialize the Libeek library.  This must be called before using
+ * functions provided by Libeek.
+ */
 void
 eek_init (void)
 {