diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 444ed3db65..2d1cba7d46 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -879,6 +879,43 @@
+ BUILD_CFLAGS
+
+
+ Specifies the flags to pass to the C compiler when building
+ for the build host.
+ When building in the -native context,
+ CFLAGS
+ is set to the value of this variable by default.
+
+
+
+
+ BUILD_CPPFLAGS
+
+
+ Specifies the flags to pass to the C pre-processor and
+ eventually to both the C and C++ compilers when building
+ for the build host.
+ When building in the native context,
+ CPPFLAGS
+ is set to the value of this variable by default.
+
+
+
+
+ BUILD_CXXFLAGS
+
+
+ Specifies the flags to pass to the C++ compiler when
+ building for the build host.
+ When building in the native context,
+ CXXFLAGS
+ is set to the value of this variable by default.
+
+
+
+
BUILD_LDFLAGS
@@ -1087,6 +1124,46 @@
+ BUILDSDK_CFLAGS
+
+
+ Specifies the flags to pass to the C compiler when building
+ for the SDK.
+ When building in the nativesdk
+ context,
+ CFLAGS
+ is set to the value of this variable by default.
+
+
+
+
+ BUILDSDK_CPPFLAGS
+
+
+ Specifies the flags to pass to the C pre-processor and
+ eventually to both the C and C++ compilers when building
+ for the SDK.
+ When building in the nativesdk
+ context,
+ CPPFLAGS
+ is set to the value of this variable by default.
+
+
+
+
+ BUILDSDK_CXXFLAGS
+
+
+ Specifies the flags to pass to the C++ compiler when
+ building for the SDK.
+ When building in the nativesdk
+ context,
+ CXXFLAGS
+ is set to the value of this variable by default.
+
+
+
+
BUILDSDK_LDFLAGS
@@ -1140,12 +1217,31 @@
CFLAGS
- Flags passed to the C compiler for the target system.
- This variable evaluates to the same as
- TARGET_CFLAGS.
+ Specifies the flags to pass to the C compiler.
+ This variable is exported to an environment
+ variable and thus made visible to the software being
+ built during the compilation step.
+ Default initialization for CFLAGS
+ varies depending on what is being built:
+
+
+ TARGET_CFLAGS
+ when building for the target
+
+
+ BUILD_CFLAGS
+ when building for the build host (i.e.
+ -native)
+
+
+ BUILDSDK_CFLAGS
+ when building for an SDK (i.e.
+ nativesdk-)
+
+
For information on flags that help with creating more
secure code, see the
"Making Images More Secure"
@@ -1451,6 +1547,79 @@
+ CPPFLAGS
+
+
+ Specifies the flags to pass to the C pre-processor and the
+ C compiler.
+ This variable is exported to an environment
+ variable and thus made visible to the software being
+ built during the compilation step.
+
+
+
+ Default initialization for CPPFLAGS
+ varies depending on what is being built:
+
+
+ TARGET_CPPFLAGS
+ when building for the target
+
+
+ BUILD_CPPFLAGS
+ when building for the build host (i.e.
+ -native)
+
+
+ BUILDSDK_CPPFLAGS
+ when building for an SDK (i.e.
+ nativesdk-)
+
+
+ For information on flags that help with creating more
+ secure code, see the
+ "Making Images More Secure"
+ section in the Yocto Project Development Manual.
+
+
+
+
+ CXXFLAGS
+
+
+ Specifies the flags to pass to the C++ compiler.
+ This variable is exported to an environment
+ variable and thus made visible to the software being
+ built during the compilation step.
+
+
+
+ Default initialization for CXXFLAGS
+ varies depending on what is being built:
+
+
+ TARGET_CXXFLAGS
+ when building for the target
+
+
+ BUILD_CXXFLAGS
+ when building for the build host (i.e.
+ -native)
+
+
+ BUILDSDK_CXXFLAGS
+ when building for an SDK (i.e.
+ nativesdk)
+
+
+ For information on flags that help with creating more
+ secure code, see the
+ "Making Images More Secure"
+ section in the Yocto Project Development Manual.
+
+
+
+
D
@@ -7535,13 +7704,39 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
TARGET_CFLAGS
- Flags passed to the C compiler for the target system.
- This variable evaluates to the same as
- CFLAGS.
+ Specifies the flags to pass to the C compiler when building
+ for the target.
+ When building in the target context,
+ CFLAGS
+ is set to the value of this variable by default.
+ TARGET_CPPFLAGS
+
+
+ Specifies the flags to pass to the C pre-processor and
+ eventually to both the C and C++ compilers when building
+ for the target.
+ When building in the target context,
+ CPPFLAGS
+ is set to the value of this variable by default.
+
+
+
+
+ TARGET_CXXFLAGS
+
+
+ Specifies the flags to pass to the C++ compiler when
+ building for the target.
+ When building in the target context,
+ CXXFLAGS
+ is set to the value of this variable by default.
+
+
+ TARGET_FPU