From 018617b8ba53ab437e8e006f6218a3d7af219d09 Mon Sep 17 00:00:00 2001
From: Matt Macy <mmacy@FreeBSD.org>
Date: Tue, 3 Jul 2018 18:39:43 +0000
Subject: [PATCH] explain the purpose of genoffset_test

---
 sys/conf/kern.post.mk | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/sys/conf/kern.post.mk b/sys/conf/kern.post.mk
index 8fb4d925ce8b..7c48642b7fdf 100644
--- a/sys/conf/kern.post.mk
+++ b/sys/conf/kern.post.mk
@@ -194,6 +194,9 @@ genoffset.o: $S/kern/genoffset.c
 genoffset_test.c: $S/kern/genoffset.c
 	cp $S/kern/genoffset.c genoffset_test.c
 
+# genoffset_test.o is not actually used for anything - the point of compiling it
+# is to exercise the CTASSERT that checks that the offsets in the offset.inc
+# _lite struct(s) match those in the original(s). 
 genoffset_test.o: genoffset_test.c offset.inc
 	${CC} -c ${CFLAGS:N-flto:N-fno-common} -DOFFSET_TEST genoffset_test.c