From 7b9847ba480c5c313e49333abde896722746b712 Mon Sep 17 00:00:00 2001
From: cperciva <cperciva@FreeBSD.org>
Date: Fri, 25 Dec 2015 10:08:42 +0000
Subject: [PATCH] Document that make's .POSIX: handling is broken.  In fact, it
 has been broken ever since it was added in November 1996.

---
 share/mk/sys.mk | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/share/mk/sys.mk b/share/mk/sys.mk
index 8fe6b68d0ac1..51f2818480d7 100644
--- a/share/mk/sys.mk
+++ b/share/mk/sys.mk
@@ -69,6 +69,10 @@ __ENV_ONLY_OPTIONS:= \
 #
 # The rules below use this macro to distinguish between Posix-compliant
 # and default behaviour.
+#
+# This functionality is currently broken, since make(1) processes sys.mk
+# before reading any other files, and consequently has no opportunity to
+# set the %POSIX macro before we read this point.
 
 .if defined(%POSIX)
 .SUFFIXES:	.o .c .y .l .a .sh .f