X-Git-Url: https://git.stderr.nl/gitweb?p=rodin%2Fchimara.git;a=blobdiff_plain;f=libchimara%2Fdoc.c;h=9014870371bfb2931fd505daefb57eea079d67b9;hp=e599ff22d3f928d331ac07ac4dc2cb80bcb9f821;hb=534ab609e1501171809c856d29fc57ed087e2855;hpb=1c04c8a0a43723e3de4a7f495b76cb26fd93e0c4

diff --git a/libchimara/doc.c b/libchimara/doc.c
index e599ff2..9014870 100644
--- a/libchimara/doc.c
+++ b/libchimara/doc.c
@@ -1037,18 +1037,26 @@
  * SECTION:glk-sound-channels
  * @short_description: Creating new sound channels and closing them
  * @include: libchimara/glk.h
+ *
+ * Sounds in Glk are played through sound channels. Sound channels are another
+ * type of opaque object, like windows, streams, and file references.
  */
 
 /**
  * SECTION:glk-playing-sounds
  * @short_description: Producing noise
  * @include: libchimara/glk.h
+ *
+ * These functions play the actual sounds through the sound channels.
  */
 
 /**
  * SECTION:glk-sound-other
  * @short_description: Miscellaneous functions for sound channels
  * @include: libchimara/glk.h
+ *
+ * This section includes functions for sound channels that don't fit anywhere
+ * else.
  */
 
 /**
@@ -1078,6 +1086,9 @@
  * SECTION:glk-accepting-hyperlinks
  * @short_description: Generating and catching hyperlink navigation events
  * @include: libchimara/glk.h
+ *
+ * When you request a hyperlink event in a window, you will receive a hyperlink
+ * event when the player clicks on a hyperlink.
  */
 
 /**
@@ -1101,6 +1112,8 @@
  * SECTION:dispatch-dispatching
  * @short_description: Dispatching the call to the Glk library
  * @include: libchimara/glk.h, libchimara/gi_dispa.h
+ *
+ * The function gidispatch_call() invokes a function from the Glk library.
  */
  
 /**