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