From 6e3ccaa8a56692d8d282a99a75588c483ef6bc9a Mon Sep 17 00:00:00 2001 From: nhmall Date: Tue, 4 Jul 2023 09:53:51 -0400 Subject: [PATCH] notes about some header files The gist of this appeared previously in the commit message for b722cf99. --- DEVEL/code_features.txt | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/DEVEL/code_features.txt b/DEVEL/code_features.txt index 25859a5f1..6c7100096 100644 --- a/DEVEL/code_features.txt +++ b/DEVEL/code_features.txt @@ -101,6 +101,23 @@ engine are incompatible. Additional regular expression implementations can be written. The full interface documentation is in sys/share/posixregex.c +=========================================================== +HEADER FILE NOTES + +hack.h defines values that are available to all NetHack source files, +contains enums for use in all NetHack source files, and contains a +number of struct definitions for use in all NetHack source files. +hack.h does not contain variable declarations or variable definitions. + +decl.h and decl.c are related: decl.h contains the extern declarations +for variables that are defined in decl.c. These variables are global +and available to all NetHack source files. +decl.c variable definitions are generally laid out in much the same +order as their corresponding declarations in decl.h. + +A new header file cstd.h was added to coincide with 3.7's switch to +C99. It contains calls to some C99 standard header files. + =================== NEXT FEATURE ==========================