[PATCH v2 2/4] ld: Document mixing IR and non-IR objects for -r

[H.J. Lu]

	* ld.texi: Document mixing IR and non-IR relocatable files for
	"ld -r".

Signed-off-by: H.J. Lu <hjl.tools@gmail.com>
---
 ld/ld.texi | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/ld/ld.texi b/ld/ld.texi
index da714a20855..496dd5e5f83 100644
--- a/ld/ld.texi
+++ b/ld/ld.texi
@@ -1126,6 +1126,16 @@ relocations.  Different output formats can have further restrictions; for
 example some @code{a.out}-based formats do not support partial linking
 with input files in other formats at all.
 
+On ELF platforms, when input files contain both IR and non-IR relocatable
+files, a .gnu_object_only section will be created to contain a relocatable
+object file, as if @samp{-r} is applied to all non-IR relocatable input
+files.  Linker will extract it as input when creating executable or shared
+library.
+
+Note that since @samp{-r} groups some sections from different input files
+together, there may be negative impacts on code size and locality in final
+executable or shared library.
+
 This option does the same thing as @samp{-i}.
 
 @kindex -R @var{file}
-- 
2.47.1