From 28ab34921c2b282ceabeb56fc145f73a624f4b37 Mon Sep 17 00:00:00 2001
From: auronandace <auronandace@googlemail.com>
Date: Tue, 10 Mar 2026 10:04:56 +0000
Subject: [PATCH] verify header includes for sys_stat

---
 src/header/sys_stat/cbindgen.toml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/header/sys_stat/cbindgen.toml b/src/header/sys_stat/cbindgen.toml
index 51cba69644..1d4cd899ea 100644
--- a/src/header/sys_stat/cbindgen.toml
+++ b/src/header/sys_stat/cbindgen.toml
@@ -1,3 +1,9 @@
+# POSIX header spec: https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/sys_stat.h.html
+#
+# Spec quotations relating to includes:
+# - "The <sys/stat.h> header shall define the blkcnt_t, blksize_t, dev_t, ino_t, mode_t, nlink_t, uid_t, gid_t, off_t, and time_t types as described in <sys/types.h>."
+# - "The <sys/stat.h> header shall define the timespec structure as described in <time.h>. Times shall be given in seconds since the Epoch."
+# - "Inclusion of the <sys/stat.h> header may make visible all symbols from the <time.h> header."
 sys_includes = ["sys/types.h"]
 include_guard = "_SYS_STAT_H"
 after_includes = """