Re: [gentoo-dev] [PATCH] ebuild-writing/variables: better describe ROOT

[Mike Gilbert <floppym@gentoo.org>]

On Sat, May 14, 2016 at 5:35 PM, Göktürk Yüksek <gokturk@binghamton.edu> wrote:
> Mike Gilbert:
>> 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>
>>
>
> Sorry for the late reply. There is actually a bug for this issue [0].
> I'll rebase the patch attached to the bug on top of yours if you have
> no technical objections to the content.
>
> [0] https://bugs.gentoo.org/show_bug.cgi?id=144332

The expanded explanation seems useful indeed.