The current description of ROOT makes no sense and just confuses people.
The new description is paraphrased from PMS.
---
ebuild-writing/variables/text.xml | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/ebuild-writing/variables/text.xml
b/ebuild-writing/variables/text.xml
index ef15347..6ba6379 100644
--- a/ebuild-writing/variables/text.xml
+++ b/ebuild-writing/variables/text.xml
@@ -100,8 +100,9 @@ them.
<tr>
<ti><c>ROOT</c></ti>
<ti>
- Path to the root directory. When not using <c>${D}</c>,
- always prepend <c>${ROOT}</c> to the path.
+ The absolute path to the root directory into which the package is to be
merged.
+ Use this when refering to installed files in <c>pkg_*</c> functions.
+ Never use this in <c>src_*</c> functions.
</ti>
</tr>
<tr>
--
2.8.2
