From: Christian Heller <c.heller@plomlompom.de>
Date: Fri, 14 Nov 2014 13:31:56 +0000 (+0100)
Subject: Further expansion of comments.
X-Git-Tag: tce~592
X-Git-Url: https://plomlompom.com/repos/%7B%7Bprefix%7D%7D/%22https:/validator.w3.org/%7B%7Btodo.comment%7D%7D?a=commitdiff_plain;h=2dd6403d51a46a33e29b2255ec8aa100583e4051;p=plomrogue

Further expansion of comments.
---

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();