1 files changed, 47 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 6307870a4e..3258402288 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -5115,6 +5115,53 @@
            </glossdef>
        </glossentry>
+        <glossentry id='var-HOSTTOOLS'><glossterm>HOSTTOOLS</glossterm>
+            <info>
+                HOSTTOOLS[doc] = "A space-separated list (filter) of tools on the build host that should be allowed to be called from within build tasks."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    A space-separated list (filter) of tools on the build host
+                    that should be allowed to be called from within build tasks.
+                    Using this filter helps reduce the possibility of host
+                    contamination.
+                    If a tool specified in the value of
+                    <filename>HOSTTOOLS</filename> is not found on the
+                    build host, the OpenEmbedded build system produces
+                    an error and the build is not started.
+                </para>
+                <para>
+                    For additional information, see
+                    <link linkend='var-HOSTTOOLS_NONFATAL'><filename>HOSTTOOLS_NONFATAL</filename></link>.
+                </para>
+            </glossdef>
+        </glossentry>
+        <glossentry id='var-HOSTTOOLS_NONFATAL'><glossterm>HOSTTOOLS_NONFATAL</glossterm>
+            <info>
+                HOSTTOOLS_NONFATAL[doc] = "A space-separated list (filter) of tools on the build host that should be allowed to be called from within build tasks."
+            </info>
+            <glossdef>
+                <para role="glossdeffirst">
+<!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+                    A space-separated list (filter) of tools on the build host
+                    that should be allowed to be called from within build tasks.
+                    Using this filter helps reduce the possibility of host
+                    contamination.
+                    Unlike
+                    <link linkend='var-HOSTTOOLS'><filename>HOSTTOOLS</filename></link>,
+                    the OpenEmbedded build system does not produce and error
+                    if a tool specified in the value of
+                    <filename>HOSTTOOLS_NONFATAL</filename> is not found on the
+                    build host.
+                    Thus, you can use <filename>HOSTTOOLS_NONFATAL</filename>
+                    to filter optional host tools.
+                </para>
+            </glossdef>
+        </glossentry>
        <glossentry id='var-HOST_VENDOR'><glossterm>HOST_VENDOR</glossterm>
            <info>
                HOST_VENDOR[doc] = "The name of the vendor. Normally same as the TARGET_VENDOR."

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 6307870a4e..3258402288 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml
@@ -5115,6 +5115,53 @@
5115	</glossdef>	5115	</glossdef>
5116	</glossentry>	5116	</glossentry>
5117		5117
		5118	<glossentry id='var-HOSTTOOLS'><glossterm>HOSTTOOLS</glossterm>
		5119	<info>
		5120	HOSTTOOLS[doc] = "A space-separated list (filter) of tools on the build host that should be allowed to be called from within build tasks."
		5121	</info>
		5122	<glossdef>
		5123	<para role="glossdeffirst">
		5124	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		5125	A space-separated list (filter) of tools on the build host
		5126	that should be allowed to be called from within build tasks.
		5127	Using this filter helps reduce the possibility of host
		5128	contamination.
		5129	If a tool specified in the value of
		5130	<filename>HOSTTOOLS</filename> is not found on the
		5131	build host, the OpenEmbedded build system produces
		5132	an error and the build is not started.
		5133	</para>
		5134
		5135	<para>
		5136	For additional information, see
		5137	<link linkend='var-HOSTTOOLS_NONFATAL'><filename>HOSTTOOLS_NONFATAL</filename></link>.
		5138	</para>
		5139	</glossdef>
		5140	</glossentry>
		5141
		5142	<glossentry id='var-HOSTTOOLS_NONFATAL'><glossterm>HOSTTOOLS_NONFATAL</glossterm>
		5143	<info>
		5144	HOSTTOOLS_NONFATAL[doc] = "A space-separated list (filter) of tools on the build host that should be allowed to be called from within build tasks."
		5145	</info>
		5146	<glossdef>
		5147	<para role="glossdeffirst">
		5148	<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
		5149	A space-separated list (filter) of tools on the build host
		5150	that should be allowed to be called from within build tasks.
		5151	Using this filter helps reduce the possibility of host
		5152	contamination.
		5153	Unlike
		5154	<link linkend='var-HOSTTOOLS'><filename>HOSTTOOLS</filename></link>,
		5155	the OpenEmbedded build system does not produce and error
		5156	if a tool specified in the value of
		5157	<filename>HOSTTOOLS_NONFATAL</filename> is not found on the
		5158	build host.
		5159	Thus, you can use <filename>HOSTTOOLS_NONFATAL</filename>
		5160	to filter optional host tools.
		5161	</para>
		5162	</glossdef>
		5163	</glossentry>
		5164
5118	<glossentry id='var-HOST_VENDOR'><glossterm>HOST_VENDOR</glossterm>	5165	<glossentry id='var-HOST_VENDOR'><glossterm>HOST_VENDOR</glossterm>
5119	<info>	5166	<info>
5120	HOST_VENDOR[doc] = "The name of the vendor. Normally same as the TARGET_VENDOR."	5167	HOST_VENDOR[doc] = "The name of the vendor. Normally same as the TARGET_VENDOR."