svn commit: r287007 - head/share/mk

[Warner Losh]

Author: imp
Date: Fri Aug 21 19:51:27 2015
New Revision: 287007
URL: https://svnweb.freebsd.org/changeset/base/287007

Log:
  Document bsd.compiler.mk and the variables it defines.

Modified:
  head/share/mk/bsd.README

Modified: head/share/mk/bsd.README
==============================================================================
--- head/share/mk/bsd.README	Fri Aug 21 19:51:19 2015	(r287006)
+++ head/share/mk/bsd.README	Fri Aug 21 19:51:27 2015	(r287007)
@@ -17,6 +17,7 @@ files.  In most cases it is only interes
 bsd.lib.mk.
 
 bsd.arch.inc.mk		- includes arch-specific Makefile.$arch
+bsd.compiler.mk		- defined based on current compiler
 bsd.cpu.mk		- sets CPU/arch-related variables (included from sys.mk)
 bsd.dep.mk		- handle Makefile dependencies
 bsd.doc.mk		- building troff system documents
@@ -116,9 +117,29 @@ object.
 
 The following variables are common:
 
+CFLAGS.${COMPILER_TYPE}
+		Flags dependent on compiler added to CXXFLAGS.
+CFLAGS.${MACHINE_ARCH}
+		Architectural flags added to CFLAGS.
 CFLAGS_NO_SIMD	Add this to CFLAGS for programs that don't want any SIMD
 		instructions generated. It is setup in bsd.cpu.mk to an
 		appropriate value for the compiler and target.
+CXXFLAGS.${COMPILER_TYPE}
+		Flags dependent on compiler added to CXXFLAGS.
+CXXFLAGS.${MACHINE_ARCH}
+		Architectural flags added to CXXFLAGS.
+COMPILER_FEATURES
+		A list of features that the compiler supports. Zero or
+		more of:
+			c++11	Supports full C++ 11 standard.
+
+COMPILER_TYPE	Type of compiler, either clang or gcc, though other
+		values are possible. Don't assume != clang == gcc.
+
+COMPILER_VERSION
+		A numeric constant equal to:
+		     major * 10000 + minor * 100 + tiny
+		for the compiler's self-reported version.
 
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=