X-Git-Url: https://plomlompom.com/repos/foo.html?a=blobdiff_plain;ds=sidebyside;f=src%2Fclient%2Fio.h;h=12a56c01fd38787c26621344cc16a6bb74341a46;hb=f216ec2fd2f4e826e1318691686131afcb5b0c09;hp=072a2174de0ea07077b3cc2809be2f741bdf540d;hpb=7e43b1fff89706212291384ddaa762fa30b02cb4;p=plomrogue
diff --git a/src/client/io.h b/src/client/io.h
index 072a217..12a56c0 100644
--- a/src/client/io.h
+++ b/src/client/io.h
@@ -1,4 +1,8 @@
/* src/client/io.h
+ *
+ * This file is part of PlomRogue. PlomRogue is licensed under the GPL version 3
+ * or any later version. For details on its copyright, license, and warranties,
+ * see the file NOTICE in the root directory of the PlomRogue source package.
*
* Communication of the client with the server (by reading and writing files)
* and the user (by writing to the screen and reading keypresses).
@@ -16,17 +20,20 @@
*/
extern void send(char * msg);
-/* Keep checking for user input, a changed worldstate file and the server's
- * wakefulness. Update client's world representation on worldstate file changes.
- * Manipulate the client and send commands to server based on the user input as
- * interpreted by the control.h library.
+/* Keep checking for user input, a changed worldstate file, and queue input from
+ * the server's out file. Update client's world representation on worldstate
+ * file changes. Manipulate the client and send commands to server based on the
+ * user input as interpreted by the control.h library.
*
* On each change / activity, re-draw the windows with draw_all_wins(). When the
* loop ends regularly (due to the user sending a quit command), return an
* appropriate quit message to write to stdout when the client winds down. Call
* reset_windows() on receiving a SIGWINCH. Abort on assumed server death if the
* server's out file does not get updated, even on PING requests. Re-focus map
- * view on player if world.focus_each_turn is set.
+ * view on player. 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 or
+ * further server polling happens.
*/
extern char * io_loop();