ref-manual: Updates to ELF binary QA warning - review changes

Applied some review edits from Paul.

Fixes [YOCTO #7630]

(From yocto-docs rev: 064fa763686f5ddaccba4a7201757f2a6fc8636c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 12 insertions, 5 deletions

diff --git a/documentation/ref-manual/ref-qa-checks.xml b/documentation/ref-manual/ref-qa-checks.xml
index b4657e2ced..54cd4336eb 100644
--- a/documentation/ref-manual/ref-qa-checks.xml
+++ b/documentation/ref-manual/ref-qa-checks.xml
@@ -464,11 +464,18 @@ can be found then it should be implemented.  I can't find one at the moment.
                     <filename>.text</filename> sections.
                     This situation can result in a performance impact
                     at runtime.
-                    <note><title>Tip</title>
-                       If you do experience runtime performance issues,
-                       you could try assigning "-fPIC/-fpic" to
-                       <filename>gcc</filename>.
-                    </note>
+                </para>
+
+                <para>
+                    Typically, the way to solve this performance issue is to
+                    add "-fPIC" to the compiler command-line options.
+                    For example, given software that reads
+                    <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
+                    when you build it, you can add the following to your
+                    recipe:
+                    <literallayout class='monospaced'>
+     CFLAGS_append = " -fPIC "
+                    </literallayout>
                 </para>
 
                 <para>