-character used to represent the object visually on the map, the fourth value is
-the number of hitpoints the object starts with (items are dead and start with
-zero hitpoints, anything else moves), the fifth is the string that names the
-object in the game log.
+ASCII character used to represent the object visually on the map, the fourth
+value is the number of hitpoints the object starts with (items are dead and
+start with zero hitpoints, anything else moves), the fifth is the string that
+names the object in the game log. Finally, the same delimiter as for the map
+object action definitions file follows. Note that the only valid item use so
+far, consuming "magic meat" to gain hitpoints, is so far hard-coded (this should
+change in the future).
+
+All source files are thoroughly documented to explain more details of
+plomrogue's internals. The ./roguelike-server executable can be run with a -v
+option for helpful debugging info (mostly: what messages the client sends to the
+server). Server and client communicate via files in the ./server/ directory
+(generated when the server is first run). The ./server/in fifo receives commands
+for the server as null-terminated strings. The ./server/out file contains a
+serialized representation of the game world's data as it is to be available to
+the player / the player's client.