makesyscalls: deprecate cpp other than includes

Warn that C preprocessor directives in the config file are deprecated.
They are unsound and support has a number of potential pitfalls.  They
should be replaced by compile-time generation of files plus an overlay
framework to allow things like per-arch variation.

Sponsored by:	DARPA, AFRL

sys/kern/syscalls.master

@@ -111,6 +111,7 @@
 ; limited set of output files.  Before the first syscalls, #include lines will
 ; be copied and %%ABI_HEADERS%% expanded.  Between system call entries,
 ; all lines beginning with # will be copied.  Caveat Emptor.
+; WARNING: this functionality is deprecated.
 
 #include <sys/param.h>
 #include <sys/sysent.h>

sys/tools/syscalls/core/freebsd-syscall.lua

@@ -50,6 +50,7 @@ function FreeBSDSyscall:parseSysfile()
 	local incs = ""
 	local prolog = ""
 	local first = true
+	local cpp_warned = false
 	local s
 	for line in fh:lines() do
 		line = line:gsub(commentExpr, "") -- Strip any comments.
@@ -82,6 +83,11 @@ function FreeBSDSyscall:parseSysfile()
 				incs = incs .. h .. "\n"
 			end
 		elseif line:match("^#") then
+			if not cpp_warned then
+				util.warn("use of non-include cpp " ..
+				    "directives is deprecated")
+				cpp_warned = true
+			end
 			prolog = prolog .. line .. "\n"
 		else
 			s = syscall:new()