X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=libchimara%2Fgarglk.h;h=91c436434f7203d7885b6e6d78adea0545241fda;hb=refs%2Fheads%2Fgtk3;hp=73968141424af11e09d4e1bf573dc1d45fe741d8;hpb=7aabd2ee56aa3de0eafd57e149f632617c8c8ee1;p=projects%2Fchimara%2Fchimara.git

diff --git a/libchimara/garglk.h b/libchimara/garglk.h
index 7396814..91c4364 100644
--- a/libchimara/garglk.h
+++ b/libchimara/garglk.h
@@ -9,8 +9,10 @@
  * macro is defined, then so are all the Gargoyle extensions. If not, not.
  *
  * <note><title>Chimara</title><para>
- *   Currently, in Chimara, the functions are defined, but most of them are
- *   not implemented. That is, you can call them, but they do nothing.
+ *   Currently, in Chimara, the functions are defined, but a few of them
+ *   (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>
  */
 #define GARGLK 1
@@ -20,25 +22,36 @@ extern char* garglk_fileref_get_name(frefid_t fref);
 extern void garglk_set_program_name(const char *name);
 extern void garglk_set_program_info(const char *info);
 extern void garglk_set_story_name(const char *name);
-
+extern void garglk_set_story_title(const char *title);
 /*
  This function is not implemented even in Gargoyle. Looks like it was planned, 
  but never added.
 extern void garglk_set_config(const char *name);
 */
 
-/* JM: functions added to support Z-machine features that aren't in the Glk standard */
-
-extern void garglk_set_line_terminators(winid_t win, const glui32 *keycodes, glui32 numkeycodes);
-
 /* garglk_unput_string - removes the specified string from the end of the output buffer, if
  * indeed it is there. */
 extern void garglk_unput_string(char *str);
 extern void garglk_unput_string_uni(glui32 *str);
 
-/* TODO document */
+/**
+ * zcolor_Transparent:
+ *
+ * Z-machine color constant representing no color, i.e. transparency.
+ *
+ * <warning><para>Passing this constant to garglk_set_zcolors() or
+ * garglk_set_zcolors_stream() is not currently implemented.</para></warning>
+ */
 #define zcolor_Transparent   (-4)
-/* TODO document */
+/**
+ * zcolor_Cursor:
+ *
+ * Z-machine color constant representing the color at the current position of
+ * the cursor.
+ *
+ * <warning><para>Passing this constant to garglk_set_zcolors() or
+ * garglk_set_zcolors_stream() is not currently implemented.</para></warning>
+ */
 #define zcolor_Cursor        (-3)
 /**
  * zcolor_Current:
@@ -67,12 +80,22 @@ extern void garglk_set_reversevideo_stream(strid_t str, glui32 reverse);
  * %keycode_Erase to represent <emphasis>only</emphasis> the 
  * <keycap>Delete</keycap> key. In character input, <keycap>Delete</keycap> is
  * still reported as %keycode_Delete, but the two are distinguished in 
- * garglk_set_line_terminators().
+ * glk_set_terminators_line_event().
  */
 #define keycode_Erase    (0xffffef7f)
-/* TODO document */
+/**
+ * keycode_MouseWheelUp:
+ *
+ * This key code represents the mouse wheel scrolling up in a window. It is
+ * never used in Chimara.
+ */
 #define keycode_MouseWheelUp        (0xffffeffe)
-/* TODO document */
+/**
+ * keycode_MouseWheelDown:
+ *
+ * This key code represents the mouse wheel scrolling down in a window. It is
+ * never used in Chimara.
+ */
 #define keycode_MouseWheelDown      (0xffffefff)
 
 #endif /* __GARGLK_H__ */