2 files changed, 20 insertions, 1 deletions

diff --git a/documentation/ref-manual/ref-qa-checks.xml b/documentation/ref-manual/ref-qa-checks.xml
index 78badc2d6b..e17fc2c216 100644
--- a/documentation/ref-manual/ref-qa-checks.xml
+++ b/documentation/ref-manual/ref-qa-checks.xml
@@ -305,7 +305,7 @@
                 is being passed to the linker command.
                 A common workaround for this situation is to pass in
                 <filename>LDFLAGS</filename> using
-                <filename>TARGET_CC_ARCH</filename>
+                <link linkend='var-TARGET_CC_ARCH'><filename>TARGET_CC_ARCH</filename></link>
                 within the recipe as follows:
                 <literallayout class='monospaced'>
      TARGET_CC_ARCH += "${LDFLAGS}"
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 2d1cba7d46..1d491cc1fe 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7701,6 +7701,25 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </glossdef>
         </glossentry>
 
+        <glossentry id='var-TARGET_CC_ARCH'><glossterm>TARGET_CC_ARCH</glossterm>
+            <glossdef>
+                <para>
+                    Specifies architecture-specific C compiler flags for the
+                    target system.
+                    <filename>TARGET_CC_ARCH</filename> is initialized from
+                    <filename>TUNE_CCARGS</filename> by default.
+                    <note>
+                        It is a common workaround to append
+                        <link linkend='var-LDFLAGS'><filename>LDFLAGS</filename></link>
+                        to <filename>TUNE_CC_ARCH</filename> in recipes
+                        that build software for the target that would not
+                        otherwise respect the exported
+                        <filename>LDFLAGS</filename> variable.
+                    </note>
+                </para>
+            </glossdef>
+        </glossentry>
+
         <glossentry id='var-TARGET_CFLAGS'><glossterm>TARGET_CFLAGS</glossterm>
             <glossdef>
                 <para>