Document all incomplete symbols

Documentation is now fully complete!

diff --git a/libchimara/chimara-glk.c b/libchimara/chimara-glk.c
index 04d2687dbd2f912e3e1dce4f19d62666e8d1b45f..69a0a8d04f512a65ee16f46d8bbc422f30f877ea 100644 (file)
--- a/libchimara/chimara-glk.c
+++ b/libchimara/chimara-glk.c
@@ -813,7 +813,7 @@ chimara_glk_class_init(ChimaraGlkClass *klass)
                _chimara_marshal_VOID__UINT_STRING,
                G_TYPE_NONE, 2, G_TYPE_UINT, G_TYPE_STRING);
        /**
-        * ChimaraGlk::iliad-update-screen:
+        * ChimaraGlk::iliad-screen-update:
         * @self: The widget that received the signal
         * @typing: Whether to perform a typing or full screen update
         *

diff --git a/libchimara/doc.c b/libchimara/doc.c
index 3c04ce31abdf6c2ea348ff09ac02446588f4c7fe..8a6c1aea03f0e534a6bc8cf4ea28e4a5484d0349 100644 (file)
--- a/libchimara/doc.c
+++ b/libchimara/doc.c
@@ -1140,6 +1140,8 @@
  * @short_description: Converting from timestamps to date structures and back
  * @include: libchimara/glk.h
  *
+ * This section describes functions for converting timestamps to more
+ * human-readable date structures and back.
  */
 
 /**
@@ -1399,6 +1401,20 @@
  * functions and data types described in this section.
  */
 
+/**
+ * GLK_MODULE_LINE_ECHO:
+ *
+ * If this preprocessor symbol is defined, so is glk_set_echo_line_event(). If
+ * not, not.
+ */
+
+/**
+ * GLK_MODULE_LINE_TERMINATORS:
+ *
+ * If this preprocessor symbol is defined, so is
+ * glk_set_terminators_line_event(). If not, not.
+ */
+
 /**
  * winid_t:
  *
@@ -2872,9 +2888,30 @@
  * <warning><para>Margin images are not implemented yet.</para></warning>
  */
 
+/**
+ * glkdate_t:
+ * @year: The full (four-digit) year
+ * @month: The month number, ranging from 1-12, 1 is January
+ * @day: The day of the month, ranging from 1-31
+ * @weekday: The day of the week, ranging from 0-6, 0 is Sunday
+ * @hour: The hour of the day, ranging from 0-23
+ * @minute: The minute of the hour, ranging from 0-59
+ * @second: The second of the minute, ranging from 0-59; may be 60 during a leap
+ * second
+ * @microsec: The fraction of the second in microseconds, ranging from 0-999999
+ *
+ * This structure represents a human-readable date in a specific timezone.
+ */
+
 /**
  * glktimeval_t:
+ * @high_sec: The most significant 32 bits of the timestamp in seconds.
+ * @low_sec: The least significant 32 bits of the timestamp in seconds.
+ * @microsec: The fraction of the timestamp, in microseconds, ranging from
+ * 0-999999.
  *
+ * This structure represents the Unix timestamp, i.e. the number of seconds
+ * since January 1, 1970.
  */
  
 /*---------- TYPES, FUNCTIONS AND CONSTANTS FROM GI_DISPA.H ------------------*/
@@ -2892,7 +2929,19 @@
  *
  * Returns: Number of opaque object classes used by the library.
  */
- 
+
+/**
+ * gidispatch_get_class:
+ * @index: Unique integer index of the class.
+ *
+ * Returns a structure describing an opaque class that the library exports.
+ * @index can range from 0 to <inlineequation><mathphrase>N -
+ * 1</mathphrase><alt>N - 1</alt></inlineequation>, where N is the value
+ * returned by gidispatch_count_classes().
+ *
+ * Returns: A #gidispatch_intconst_t structure describing the class.
+ */
+
 /**
  * gidispatch_count_intconst:
  *

diff --git a/libchimara/garglk.h b/libchimara/garglk.h
index 9e4d68bd4708937308514a396ac17f6716b7f4bc..91c436434f7203d7885b6e6d78adea0545241fda 100644 (file)
--- a/libchimara/garglk.h
+++ b/libchimara/garglk.h
@@ -10,8 +10,7 @@
  *
  * <note><title>Chimara</title><para>
  *   Currently, in Chimara, the functions are defined, but a few of them
- *   (garglk_set_line_terminators(),
- *   garglk_unput_string(), and garglk_unput_string_uni()) are not implemented.
+ *   (garglk_unput_string() and garglk_unput_string_uni()) are not implemented.
  *   You can call them, but they will have no effect except to print a warning
  *   to the console.
  * </para></note>