ref-manual: Added variables that pass compilers and their supporting links.

Updated the CFLAGS and TARGET_CFLAGS variables. Created these new variables: BUILD_CFLAGS BUILDSDK_CFLAGS CXXFLAGS TARGET_CXXFLAGS BUILD_CXXFLAGS BUILD_SDKFLAGS CPPFLAGS TARGET_CPPFLAGS BUILD_CPPFLAGS BUILDSDK_CPPFLAGS (From yocto-docs rev: 00d1895f56f8d65944549ab216d1e0ccdceea674) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
author: Scott Rifenbark <scott.m.rifenbark@intel.com> 2014-05-22 15:46:11 +0300
committer: Richard Purdie <richard.purdie@linuxfoundation.org> 2014-05-30 16:32:15 +0100
commit: 76e6f654cded8de094264433d00ea1f3534be932 (patch)
tree: e7ea25fbd07b8671aa1f485c2e8029c15ce489ce /documentation
parent: 10719806357d4faebd883c2165a4a557978f32a4 (diff)
download: poky-76e6f654cded8de094264433d00ea1f3534be932.tar.gz
1 files changed, 201 insertions, 6 deletions
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 @@
            </glossdef>
        </glossentry>
+        <glossentry id='var-BUILD_CFLAGS'><glossterm>BUILD_CFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    Specifies the flags to pass to the C compiler when building
+                    for the build host.
+                    When building in the <filename>-native</filename> context,
+                    <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-BUILD_CPPFLAGS'><glossterm>BUILD_CPPFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    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 <filename>native</filename> context,
+                    <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-BUILD_CXXFLAGS'><glossterm>BUILD_CXXFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    Specifies the flags to pass to the C++ compiler when
+                    building for the build host.
+                    When building in the <filename>native</filename> context,
+                    <link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
        <glossentry id='var-BUILD_LDFLAGS'><glossterm>BUILD_LDFLAGS</glossterm>
            <glossdef>
                <para>
@@ -1087,6 +1124,46 @@
            </glossdef>
        </glossentry>
+        <glossentry id='var-BUILDSDK_CFLAGS'><glossterm>BUILDSDK_CFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    Specifies the flags to pass to the C compiler when building
+                    for the SDK.
+                    When building in the <filename>nativesdk</filename>
+                    context,
+                    <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-BUILDSDK_CPPFLAGS'><glossterm>BUILDSDK_CPPFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    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 <filename>nativesdk</filename>
+                    context,
+                    <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-BUILDSDK_CXXFLAGS'><glossterm>BUILDSDK_CXXFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    Specifies the flags to pass to the C++ compiler when
+                    building for the SDK.
+                    When building in the <filename>nativesdk</filename>
+                    context,
+                    <link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
        <glossentry id='var-BUILDSDK_LDFLAGS'><glossterm>BUILDSDK_LDFLAGS</glossterm>
            <glossdef>
                <para>
@@ -1140,12 +1217,31 @@
        <glossentry id='var-CFLAGS'><glossterm>CFLAGS</glossterm>
            <glossdef>
                <para>
-                    Flags passed to the C compiler for the target system.
+                    Specifies the flags to pass to the C compiler.
-                    This variable evaluates to the same as
+                    This variable is exported to an environment
-                    <filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename>.
+                    variable and thus made visible to the software being
+                    built during the compilation step.
                </para>
                <para>
+                    Default initialization for <filename>CFLAGS</filename>
+                    varies depending on what is being built:
+                    <itemizedlist>
+                        <listitem><para>
+                            <link linkend='var-TARGET_CFLAGS'><filename>TARGET_CFLAGS</filename></link>
+                            when building for the target
+                            </para></listitem>
+                        <listitem><para>
+                            <link linkend='var-BUILD_CFLAGS'><filename>BUILD_CFLAGS</filename></link>
+                            when building for the build host (i.e.
+                            <filename>-native</filename>)
+                            </para></listitem>
+                        <listitem><para>
+                            <link linkend='var-BUILDSDK_CFLAGS'><filename>BUILDSDK_CFLAGS</filename></link>
+                            when building for an SDK (i.e.
+                            <filename>nativesdk-</filename>)
+                            </para></listitem>
+                    </itemizedlist>
                    For information on flags that help with creating more
                    secure code, see the
                    "<ulink url='&YOCTO_DOCS_DEV_URL;#making-images-more-secure'>Making Images More Secure</ulink>"
@@ -1451,6 +1547,79 @@
            </glossdef>
        </glossentry>
+        <glossentry id='var-CPPFLAGS'><glossterm>CPPFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    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.
+                </para>
+                <para>
+                    Default initialization for <filename>CPPFLAGS</filename>
+                    varies depending on what is being built:
+                    <itemizedlist>
+                        <listitem><para>
+                            <link linkend='var-TARGET_CPPFLAGS'><filename>TARGET_CPPFLAGS</filename></link>
+                            when building for the target
+                            </para></listitem>
+                        <listitem><para>
+                            <link linkend='var-BUILD_CPPFLAGS'><filename>BUILD_CPPFLAGS</filename></link>
+                            when building for the build host (i.e.
+                            <filename>-native</filename>)
+                            </para></listitem>
+                        <listitem><para>
+                            <link linkend='var-BUILDSDK_CPPFLAGS'><filename>BUILDSDK_CPPFLAGS</filename></link>
+                            when building for an SDK (i.e.
+                            <filename>nativesdk-</filename>)
+                            </para></listitem>
+                    </itemizedlist>
+                    For information on flags that help with creating more
+                    secure code, see the
+                    "<ulink url='&YOCTO_DOCS_DEV_URL;#making-images-more-secure'>Making Images More Secure</ulink>"
+                    section in the Yocto Project Development Manual.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-CXXFLAGS'><glossterm>CXXFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    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.
+                </para>
+                <para>
+                    Default initialization for <filename>CXXFLAGS</filename>
+                    varies depending on what is being built:
+                    <itemizedlist>
+                        <listitem><para>
+                            <link linkend='var-TARGET_CXXFLAGS'><filename>TARGET_CXXFLAGS</filename></link>
+                            when building for the target
+                            </para></listitem>
+                        <listitem><para>
+                            <link linkend='var-BUILD_CXXFLAGS'><filename>BUILD_CXXFLAGS</filename></link>
+                            when building for the build host (i.e.
+                            <filename>-native</filename>)
+                            </para></listitem>
+                        <listitem><para>
+                            <link linkend='var-BUILDSDK_CXXFLAGS'><filename>BUILDSDK_CXXFLAGS</filename></link>
+                            when building for an SDK (i.e.
+                            <filename>nativesdk</filename>)
+                            </para></listitem>
+                    </itemizedlist>
+                    For information on flags that help with creating more
+                    secure code, see the
+                    "<ulink url='&YOCTO_DOCS_DEV_URL;#making-images-more-secure'>Making Images More Secure</ulink>"
+                    section in the Yocto Project Development Manual.
+                </para>
+            </glossdef>
+        </glossentry>
    </glossdiv>
    <glossdiv id='var-glossary-d'><title>D</title>
@@ -7535,13 +7704,39 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
        <glossentry id='var-TARGET_CFLAGS'><glossterm>TARGET_CFLAGS</glossterm>
            <glossdef>
                <para>
-                    Flags passed to the C compiler for the target system.
+                    Specifies the flags to pass to the C compiler when building
-                    This variable evaluates to the same as
+                    for the target.
-                    <filename><link linkend='var-CFLAGS'>CFLAGS</link></filename>.
+                    When building in the target context,
+                    <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-TARGET_CPPFLAGS'><glossterm>TARGET_CPPFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    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,
+                    <link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
+                    is set to the value of this variable by default.
                </para>
            </glossdef>
        </glossentry>
+        <glossentry id='var-TARGET_CXXFLAGS'><glossterm>TARGET_CXXFLAGS</glossterm>
+            <glossdef>
+                <para>
+                    Specifies the flags to pass to the C++ compiler when
+                    building for the target.
+                    When building in the target context,
+                    <link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link>
+                    is set to the value of this variable by default.
+                </para>
+            </glossdef>
+        </glossentry>
        <glossentry id='var-TARGET_FPU'><glossterm>TARGET_FPU</glossterm>
            <glossdef>
author	Scott Rifenbark <scott.m.rifenbark@intel.com>	2014-05-22 15:46:11 +0300
committer	Richard Purdie <richard.purdie@linuxfoundation.org>	2014-05-30 16:32:15 +0100
commit	76e6f654cded8de094264433d00ea1f3534be932 (patch)
tree	e7ea25fbd07b8671aa1f485c2e8029c15ce489ce /documentation
parent	10719806357d4faebd883c2165a4a557978f32a4 (diff)
download	poky-76e6f654cded8de094264433d00ea1f3534be932.tar.gz

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 @@
879	</glossdef>	879	</glossdef>
880	</glossentry>	880	</glossentry>
881		881
		882	<glossentry id='var-BUILD_CFLAGS'><glossterm>BUILD_CFLAGS</glossterm>
		883	<glossdef>
		884	<para>
		885	Specifies the flags to pass to the C compiler when building
		886	for the build host.
		887	When building in the <filename>-native</filename> context,
		888	<link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
		889	is set to the value of this variable by default.
		890	</para>
		891	</glossdef>
		892	</glossentry>
		893
		894	<glossentry id='var-BUILD_CPPFLAGS'><glossterm>BUILD_CPPFLAGS</glossterm>
		895	<glossdef>
		896	<para>
		897	Specifies the flags to pass to the C pre-processor and
		898	eventually to both the C and C++ compilers when building
		899	for the build host.
		900	When building in the <filename>native</filename> context,
		901	<link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
		902	is set to the value of this variable by default.
		903	</para>
		904	</glossdef>
		905	</glossentry>
		906
		907	<glossentry id='var-BUILD_CXXFLAGS'><glossterm>BUILD_CXXFLAGS</glossterm>
		908	<glossdef>
		909	<para>
		910	Specifies the flags to pass to the C++ compiler when
		911	building for the build host.
		912	When building in the <filename>native</filename> context,
		913	<link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link>
		914	is set to the value of this variable by default.
		915	</para>
		916	</glossdef>
		917	</glossentry>
		918
882	<glossentry id='var-BUILD_LDFLAGS'><glossterm>BUILD_LDFLAGS</glossterm>	919	<glossentry id='var-BUILD_LDFLAGS'><glossterm>BUILD_LDFLAGS</glossterm>
883	<glossdef>	920	<glossdef>
884	<para>	921	<para>
@@ -1087,6 +1124,46 @@
1087	</glossdef>	1124	</glossdef>
1088	</glossentry>	1125	</glossentry>
1089		1126
		1127	<glossentry id='var-BUILDSDK_CFLAGS'><glossterm>BUILDSDK_CFLAGS</glossterm>
		1128	<glossdef>
		1129	<para>
		1130	Specifies the flags to pass to the C compiler when building
		1131	for the SDK.
		1132	When building in the <filename>nativesdk</filename>
		1133	context,
		1134	<link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
		1135	is set to the value of this variable by default.
		1136	</para>
		1137	</glossdef>
		1138	</glossentry>
		1139
		1140	<glossentry id='var-BUILDSDK_CPPFLAGS'><glossterm>BUILDSDK_CPPFLAGS</glossterm>
		1141	<glossdef>
		1142	<para>
		1143	Specifies the flags to pass to the C pre-processor and
		1144	eventually to both the C and C++ compilers when building
		1145	for the SDK.
		1146	When building in the <filename>nativesdk</filename>
		1147	context,
		1148	<link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
		1149	is set to the value of this variable by default.
		1150	</para>
		1151	</glossdef>
		1152	</glossentry>
		1153
		1154	<glossentry id='var-BUILDSDK_CXXFLAGS'><glossterm>BUILDSDK_CXXFLAGS</glossterm>
		1155	<glossdef>
		1156	<para>
		1157	Specifies the flags to pass to the C++ compiler when
		1158	building for the SDK.
		1159	When building in the <filename>nativesdk</filename>
		1160	context,
		1161	<link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link>
		1162	is set to the value of this variable by default.
		1163	</para>
		1164	</glossdef>
		1165	</glossentry>
		1166
1090	<glossentry id='var-BUILDSDK_LDFLAGS'><glossterm>BUILDSDK_LDFLAGS</glossterm>	1167	<glossentry id='var-BUILDSDK_LDFLAGS'><glossterm>BUILDSDK_LDFLAGS</glossterm>
1091	<glossdef>	1168	<glossdef>
1092	<para>	1169	<para>
@@ -1140,12 +1217,31 @@
1140	<glossentry id='var-CFLAGS'><glossterm>CFLAGS</glossterm>	1217	<glossentry id='var-CFLAGS'><glossterm>CFLAGS</glossterm>
1141	<glossdef>	1218	<glossdef>
1142	<para>	1219	<para>
1143	Flags passed to the C compiler for the target system.	1220	Specifies the flags to pass to the C compiler.
1144	This variable evaluates to the same as	1221	This variable is exported to an environment
1145	<filename><link linkend='var-TARGET_CFLAGS'>TARGET_CFLAGS</link></filename>.	1222	variable and thus made visible to the software being
		1223	built during the compilation step.
1146	</para>	1224	</para>
1147		1225
1148	<para>	1226	<para>
		1227	Default initialization for <filename>CFLAGS</filename>
		1228	varies depending on what is being built:
		1229	<itemizedlist>
		1230	<listitem><para>
		1231	<link linkend='var-TARGET_CFLAGS'><filename>TARGET_CFLAGS</filename></link>
		1232	when building for the target
		1233	</para></listitem>
		1234	<listitem><para>
		1235	<link linkend='var-BUILD_CFLAGS'><filename>BUILD_CFLAGS</filename></link>
		1236	when building for the build host (i.e.
		1237	<filename>-native</filename>)
		1238	</para></listitem>
		1239	<listitem><para>
		1240	<link linkend='var-BUILDSDK_CFLAGS'><filename>BUILDSDK_CFLAGS</filename></link>
		1241	when building for an SDK (i.e.
		1242	<filename>nativesdk-</filename>)
		1243	</para></listitem>
		1244	</itemizedlist>
1149	For information on flags that help with creating more	1245	For information on flags that help with creating more
1150	secure code, see the	1246	secure code, see the
1151	"<ulink url='&YOCTO_DOCS_DEV_URL;#making-images-more-secure'>Making Images More Secure</ulink>"	1247	"<ulink url='&YOCTO_DOCS_DEV_URL;#making-images-more-secure'>Making Images More Secure</ulink>"
@@ -1451,6 +1547,79 @@
1451	</glossdef>	1547	</glossdef>
1452	</glossentry>	1548	</glossentry>
1453		1549
		1550	<glossentry id='var-CPPFLAGS'><glossterm>CPPFLAGS</glossterm>
		1551	<glossdef>
		1552	<para>
		1553	Specifies the flags to pass to the C pre-processor and the
		1554	C compiler.
		1555	This variable is exported to an environment
		1556	variable and thus made visible to the software being
		1557	built during the compilation step.
		1558	</para>
		1559
		1560	<para>
		1561	Default initialization for <filename>CPPFLAGS</filename>
		1562	varies depending on what is being built:
		1563	<itemizedlist>
		1564	<listitem><para>
		1565	<link linkend='var-TARGET_CPPFLAGS'><filename>TARGET_CPPFLAGS</filename></link>
		1566	when building for the target
		1567	</para></listitem>
		1568	<listitem><para>
		1569	<link linkend='var-BUILD_CPPFLAGS'><filename>BUILD_CPPFLAGS</filename></link>
		1570	when building for the build host (i.e.
		1571	<filename>-native</filename>)
		1572	</para></listitem>
		1573	<listitem><para>
		1574	<link linkend='var-BUILDSDK_CPPFLAGS'><filename>BUILDSDK_CPPFLAGS</filename></link>
		1575	when building for an SDK (i.e.
		1576	<filename>nativesdk-</filename>)
		1577	</para></listitem>
		1578	</itemizedlist>
		1579	For information on flags that help with creating more
		1580	secure code, see the
		1581	"<ulink url='&YOCTO_DOCS_DEV_URL;#making-images-more-secure'>Making Images More Secure</ulink>"
		1582	section in the Yocto Project Development Manual.
		1583	</para>
		1584	</glossdef>
		1585	</glossentry>
		1586
		1587	<glossentry id='var-CXXFLAGS'><glossterm>CXXFLAGS</glossterm>
		1588	<glossdef>
		1589	<para>
		1590	Specifies the flags to pass to the C++ compiler.
		1591	This variable is exported to an environment
		1592	variable and thus made visible to the software being
		1593	built during the compilation step.
		1594	</para>
		1595
		1596	<para>
		1597	Default initialization for <filename>CXXFLAGS</filename>
		1598	varies depending on what is being built:
		1599	<itemizedlist>
		1600	<listitem><para>
		1601	<link linkend='var-TARGET_CXXFLAGS'><filename>TARGET_CXXFLAGS</filename></link>
		1602	when building for the target
		1603	</para></listitem>
		1604	<listitem><para>
		1605	<link linkend='var-BUILD_CXXFLAGS'><filename>BUILD_CXXFLAGS</filename></link>
		1606	when building for the build host (i.e.
		1607	<filename>-native</filename>)
		1608	</para></listitem>
		1609	<listitem><para>
		1610	<link linkend='var-BUILDSDK_CXXFLAGS'><filename>BUILDSDK_CXXFLAGS</filename></link>
		1611	when building for an SDK (i.e.
		1612	<filename>nativesdk</filename>)
		1613	</para></listitem>
		1614	</itemizedlist>
		1615	For information on flags that help with creating more
		1616	secure code, see the
		1617	"<ulink url='&YOCTO_DOCS_DEV_URL;#making-images-more-secure'>Making Images More Secure</ulink>"
		1618	section in the Yocto Project Development Manual.
		1619	</para>
		1620	</glossdef>
		1621	</glossentry>
		1622
1454	</glossdiv>	1623	</glossdiv>
1455		1624
1456	<glossdiv id='var-glossary-d'><title>D</title>	1625	<glossdiv id='var-glossary-d'><title>D</title>
@@ -7535,13 +7704,39 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7535	<glossentry id='var-TARGET_CFLAGS'><glossterm>TARGET_CFLAGS</glossterm>	7704	<glossentry id='var-TARGET_CFLAGS'><glossterm>TARGET_CFLAGS</glossterm>
7536	<glossdef>	7705	<glossdef>
7537	<para>	7706	<para>
7538	Flags passed to the C compiler for the target system.	7707	Specifies the flags to pass to the C compiler when building
7539	This variable evaluates to the same as	7708	for the target.
7540	<filename><link linkend='var-CFLAGS'>CFLAGS</link></filename>.	7709	When building in the target context,
		7710	<link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
		7711	is set to the value of this variable by default.
		7712	</para>
		7713	</glossdef>
		7714	</glossentry>
		7715
		7716	<glossentry id='var-TARGET_CPPFLAGS'><glossterm>TARGET_CPPFLAGS</glossterm>
		7717	<glossdef>
		7718	<para>
		7719	Specifies the flags to pass to the C pre-processor and
		7720	eventually to both the C and C++ compilers when building
		7721	for the target.
		7722	When building in the target context,
		7723	<link linkend='var-CPPFLAGS'><filename>CPPFLAGS</filename></link>
		7724	is set to the value of this variable by default.
7541	</para>	7725	</para>
7542	</glossdef>	7726	</glossdef>
7543	</glossentry>	7727	</glossentry>
7544		7728
		7729	<glossentry id='var-TARGET_CXXFLAGS'><glossterm>TARGET_CXXFLAGS</glossterm>
		7730	<glossdef>
		7731	<para>
		7732	Specifies the flags to pass to the C++ compiler when
		7733	building for the target.
		7734	When building in the target context,
		7735	<link linkend='var-CXXFLAGS'><filename>CXXFLAGS</filename></link>
		7736	is set to the value of this variable by default.
		7737	</para>
		7738	</glossdef>
		7739	</glossentry>
7545		7740
7546	<glossentry id='var-TARGET_FPU'><glossterm>TARGET_FPU</glossterm>	7741	<glossentry id='var-TARGET_FPU'><glossterm>TARGET_FPU</glossterm>
7547	<glossdef>	7742	<glossdef>