From 2dd6403d51a46a33e29b2255ec8aa100583e4051 Mon Sep 17 00:00:00 2001
From: Christian Heller <c.heller@plomlompom.de>
Date: Fri, 14 Nov 2014 14:31:56 +0100
Subject: [PATCH] Further expansion of comments.

---
 src/client/io.h | 2 +-
 src/server/io.h | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/client/io.h b/src/client/io.h
index 1e47404..36d04c6 100644
--- 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 009052b..9dffd25 100644
--- 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();
 
-- 
2.30.2