Further expansion of comments.

diff --git a/src/client/io.h b/src/client/io.h
index 1e47404bab8a323f8c90f0d8951ee94c6b626569..36d04c6fb7633785538d6d0d6761265b7ef27d8f 100644 (file)
--- a/src/client/io.h
+++ b/src/client/io.h
@@ -33,7 +33,7 @@ extern void send(char * msg);
  * view on player if world.focus_each_turn is set. Messages from the out file
  * are put together on the queue first, from which only complete (\n-delimited)
  * messages are read. Queues of messages are worked through completely / emptied
- * before any re-drawing happens.
+ * before any re-drawing or further server polling happens.
  */
 extern char * io_loop();
 

diff --git a/src/server/io.h b/src/server/io.h
index 009052bd8c508b957bafca66175aa6d15d69b9f7..9dffd258cf8180010d63828f364f15a0fdcb51cf 100644 (file)
--- a/src/server/io.h
+++ b/src/server/io.h
@@ -17,6 +17,8 @@
  * if queue is empty and world.do_update is set, update world state file (and
  * unset world.do_update) and write a single dot line to server out file, then
  * read server in file for the next load of bytes to put onto the input queue.
+ * (Queueing ensures only complete messages are interpreted, and io_loop()'s
+ * server tests only happening in a multi-second interval.)
  */
 extern char * io_round();