diff --git a/src/header/netdb/cbindgen.toml b/src/header/netdb/cbindgen.toml
index b031875f72..be918c0426 100644
--- a/src/header/netdb/cbindgen.toml
+++ b/src/header/netdb/cbindgen.toml
@@ -1,4 +1,12 @@
+# POSIX header spec: https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/netdb.h.html
+#
+# Spec quotations relating to includes:
+# - "The <netdb.h> header shall define the uint32_t type as described in <inttypes.h>."
+# - "The <netdb.h> header shall define the socklen_t type through typedef, as described in <sys/socket.h>."
+# - "Inclusion of the <netdb.h> header may also make visible all symbols from <netinet/in.h>, <sys/socket.h>, and <inttypes.h>."
+#
 # netinet/in.h brings in sys/socket.h
+# features.h needed for deprecated annotations
 sys_includes = ["inttypes.h", "netinet/in.h", "features.h"]
 include_guard = "_RELIBC_NETDB_H"
 trailer = """