X-Git-Url: https://plomlompom.com/repos/?a=blobdiff_plain;ds=sidebyside;f=src%2Fmap_objects.h;h=fd7a8191739ccb9d8d69214972e06007d4b455b4;hb=e9ee94eeb27e1121f8383cb6fc3775f18261df75;hp=2bd1bec775dafb89dae35060479374bb95fc381f;hpb=8f60274cc94ea4b2d3a0bb71169e50b0d06ae629;p=plomrogue

diff --git a/src/map_objects.h b/src/map_objects.h
index 2bd1bec..fd7a819 100644
--- a/src/map_objects.h
+++ b/src/map_objects.h
@@ -21,44 +21,43 @@ struct MapObj
     uint8_t type;                /* ID of appropriate map object definition */
     uint8_t lifepoints;          /* 0: object is inanimate; >0: hitpoints */
     struct yx_uint16 pos;        /* coordinate on map */
-    uint8_t command;             /* command map object tries to realize now*/
-    uint8_t arg;                 /* optional field for command argument */
+    uint8_t command;             /* map object's current action */
+    uint8_t arg;                 /* optional field for .command argument */
     uint8_t progress;            /* turns already passed to realize .command */
 };
 
 struct MapObjDef
 {
     struct MapObjDef * next;
-    uint8_t id;         /* unique identifier of map object type */
-    uint8_t corpse_id;  /* id of type to change into upon destruction */
+    uint8_t id;         /* map object definition identifier / sets .type */
+    uint8_t corpse_id;  /* type to change map object into upon destruction */
     char char_on_map;   /* map object symbol to appear on map */
-    char * name;        /* string to describe object in game log*/
-    uint8_t lifepoints; /* default value for map object lifepoints member */
+    char * name;        /* string to describe object in game log */
+    uint8_t lifepoints; /* default start value for map object's .lifepoints */
 };
 
 
 
-/* Initialize map object defnitions chain from file at path "filename". */
+/* Initialize map object definitions chain from file at path "filename". */
 extern void init_map_object_defs(char * filename);
 
 /* Free map object definitions chain starting at "mod_start". */
 extern void free_map_object_defs(struct MapObjDef * mod_start);
 
-/* Add new object(s) ("n": how many?) of "type" to map on random position(s).
- * New animate objects are never placed in the same square with other animated
- * ones.
- */
-extern void add_map_object(uint8_t type);
-extern void add_map_objects(uint8_t type, uint8_t n);
-
 /* Write map objects chain to "file". */
 extern void write_map_objects(FILE * file);
 
-/* Read from "file" map objects chain; use "line" as char array for fgets() and
- * expect strings of max. "linemax" length.
+/* Read map objects chain from "file"; use "line" as char array for fgets() and
+ * expect line strings of max. "linemax" length to be read by it.
  */
 extern void read_map_objects(FILE * file, char * line, int linemax);
 
+/* Add object(s) ("n": how many?) of "type" to map on random position(s). New
+ * animate objects are never placed in the same square with other animate ones.
+ */
+extern void add_map_object(uint8_t type);
+extern void add_map_objects(uint8_t type, uint8_t n);
+
 /* Free map objects in map object chain starting at "mo_start. */
 extern void free_map_objects(struct MapObj * mo_start);