diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index a000b2ae28..3889473b6e 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -1697,7 +1697,11 @@
textrel:
Checks for ELF binaries that contain relocations in their
.text sections, which can result in a
- performance impact at runtime.
+ performance impact at runtime.
+ See the explanation for the
+ ELF binary
+ message for more information regarding runtime performance issues.
+
unsafe-references-in-binaries:
Reports when a binary installed in
${base_libdir},
diff --git a/documentation/ref-manual/ref-qa-checks.xml b/documentation/ref-manual/ref-qa-checks.xml
index 43cb26db4c..b4657e2ced 100644
--- a/documentation/ref-manual/ref-qa-checks.xml
+++ b/documentation/ref-manual/ref-qa-checks.xml
@@ -464,6 +464,16 @@ can be found then it should be implemented. I can't find one at the moment.
.text sections.
This situation can result in a performance impact
at runtime.
+ Tip
+ If you do experience runtime performance issues,
+ you could try assigning "-fPIC/-fpic" to
+ gcc.
+
+
+
+
+ For more information on text relocations at runtime, see
+ .