X-Git-Url: https://plomlompom.com/repos/?a=blobdiff_plain;f=src%2Fserver%2Finit.h;h=6161200c0f019340369648372dc941b5d21dbb3c;hb=0ba357885daeeaf15ce8c63a1f6ae2abe5d68a0d;hp=cadacf3ad27cac50695e3bc159b3b1490ee57d75;hpb=036e0f646d4b55cc0162a8fad7f1a9559db50c50;p=plomrogue

diff --git a/src/server/init.h b/src/server/init.h
index cadacf3..6161200 100644
--- a/src/server/init.h
+++ b/src/server/init.h
@@ -1,4 +1,8 @@
 /* src/server/init.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.
  *
  * Server, world and game state initialization.
  */
@@ -6,7 +10,7 @@
 #ifndef INIT_H
 #define INIT_H
 
-#include <stdint.h> /* uint32_t */
+#include <stdint.h> /* uint8_t */
 
 
 
@@ -17,22 +21,23 @@ extern void obey_argv(int argc, char * argv[]);
 extern void setup_server_io();
 
 /* Dissolves old game world if it exists, generates a new one from world.seed.
- * Unlinks any pre-existing record file.
- *
- * Thing (action) definitions read in from server config directory are not
- * affected. The map is populated accordingly. world.turn is set to 1, as is
- * world.do_update, so that io_round() is told to update the worldstate file.
+ * The map is populated according to world.thing_types start numbers. world.turn
+ * is set to 1, as is .exists and .do_update, so that io_round() is told to
+ * update the worldstate file. Returns 0 on success, and if the world cannot be
+ * generated 1 since there is no player type or it has .n_start of 0, 2 if no
+ * "wait" thing action is defined.
  */
-extern void remake_world();
+extern uint8_t remake_world();
 
 /* Create a game world state, then enter play or replay mode.
  *
  * If replay mode is called for, try for the record file and follow its commands
  + up to the turn specified by the user, then enter manual replay. Otherwise,
  * start into play mode after having either recreated a game world state from
- * the savefile, or, if none exists, having created a new world with the
- * MAKE_WORLD command. Manual replay as well as play mode take place inside
- * io_loop().
+ * the savefile, or, if none exists, having created a new world with first
+ * following the commands from the world config file, then running the
+ * MAKE_WORLD command. Manual replay as well as manual play mode take place
+ * inside io_loop().
  */
 extern void run_game();