From 138c8d016925201137cb7d345dd793fe85f8bf04 Mon Sep 17 00:00:00 2001
From: kongju <kongju@shaheway.com>
Date: Mon, 4 Dec 2023 21:15:54 +0800
Subject: [PATCH] decl.c's modify

---
 src/NetHack_3.7/src/decl.c | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/src/NetHack_3.7/src/decl.c b/src/NetHack_3.7/src/decl.c
index 9c32394..5aeeecd 100644
--- a/src/NetHack_3.7/src/decl.c
+++ b/src/NetHack_3.7/src/decl.c
@@ -498,26 +498,26 @@ const struct instance_globals_l g_init_l = {
     0U, /* last_hider */
     /* nhlan.c */
 #ifdef MAX_LAN_USERNAME
-    UNDEFINED_VALUES, /* lusername */
-    MAX_LAN_USERNAME, /* lusername_size */
+    UNDEFINED_VALUES, /* lusername */ //是一个全局变量，用于存储本地区域网络的用户名。如果定义了MAX_LAN_USERNAME宏，则将其初始化为UNDEFINED_VALUES，否则将其初始化为未定义的值。注释后面的注释表示该变量在代码中的使用位置。
+    MAX_LAN_USERNAME, /* lusername_size */ //是一个全局变量，用于存储本地区域网络用户名的大小。
 #endif /* MAX_LAN_USERNAME */
     /* nhlua.c */
-    UNDEFINED_VALUE, /* luacore */
-    DUMMY, /* lua_warnbuf[] */
+    UNDEFINED_VALUE, /* luacore */ //是一个全局变量，用于存储Lua脚本的核心。将其初始化为未定义的值。
+    DUMMY, /* lua_warnbuf[] */ //是一个数组，用于存储Lua警告信息的缓冲区。
     /* options.c */
-    FALSE, /* loot_reset_justpicked */
+    FALSE, /* loot_reset_justpicked */ //是一个全局变量，用于表示是否刚刚拾取了战利品并需要重置。将其初始化为FALSE。
     /* save.c */
-    (struct obj *) 0, /* looseball */
+    (struct obj *) 0, /* looseball */ //是全局变量，用于表示游戏中的松散物品
     (struct obj *) 0, /* loosechain */
     /* sp_lev.c */
-    NULL, /* lev_message */
-    UNDEFINED_PTR, /* lregions */
+    NULL, /* lev_message */ //是一个全局变量，用于存储地图生成时的消息。
+    UNDEFINED_PTR, /* lregions */ //一个全局变量，用于存储地图生成时的区域信息
     /* trap.c */
-    { UNDEFINED_PTR, 0, 0 }, /* launchplace */
+    { UNDEFINED_PTR, 0, 0 }, /* launchplace */ //是一个结构体变量，用于表示陷阱的发射位置。
     /* windows.c */
-    UNDEFINED_PTR, /* last_winchoice */
+    UNDEFINED_PTR, /* last_winchoice */ //是一个全局变量，用于存储上次选择的窗口选项。
     /* new */
-    DUMMY,   /* lua_ver[LUA_VER_BUFSIZ] */
+    DUMMY,   /* lua_ver[LUA_VER_BUFSIZ] */ //是一个字符数组，用于存储Lua版本信息。
     DUMMY,   /* lua_copyright[LUA_COPYRIGHT_BUFSIZ] */
     TRUE, /* havestate*/
     IVMAGIC  /* l_magic to validate that structure layout has been preserved */
@@ -960,8 +960,11 @@ const struct const_globals cg = {
 };
 
 #define ZERO(x) memset(&x, 0, sizeof(x))
+//是一个宏定义，用于将变量x的内存空间清零。使用memset函数将x的内存空间的值设置为0，大小为sizeof(x)。
 
 #define MAGICCHECK(xx) \
+//是一个宏定义，用于检查结构体变量xx的魔术值和状态。
+//如果xx的magic字段不等于IVMAGIC（预定义的魔术值），则输出错误信息并退出程序。如果xx的havestate字段不等于TRUE，则输出错误信息并退出程序。
     do {                                                                   \
         if ((xx).magic != IVMAGIC) {                                       \
             raw_printf(                                                    \