From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id BDF2D13824A for ; Sun, 8 May 2016 17:42:24 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7C92821C0E1; Sun, 8 May 2016 17:42:16 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 944D821C093 for ; Sun, 8 May 2016 17:42:15 +0000 (UTC) Received: from naomi.gilbertsystems.net (d192-24-229-26.try.wideopenwest.com [24.192.26.229]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: floppym) by smtp.gentoo.org (Postfix) with ESMTPSA id AD43B3406F2 for ; Sun, 8 May 2016 17:42:14 +0000 (UTC) From: Mike Gilbert To: gentoo-dev@lists.gentoo.org Subject: [gentoo-dev] [PATCH] ebuild-writing/variables: better describe ROOT Date: Sun, 8 May 2016 13:42:10 -0400 Message-Id: <1462729330-24788-1-git-send-email-floppym@gentoo.org> X-Mailer: git-send-email 2.8.2 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Archives-Salt: 906043e4-90c0-4fcb-9d18-cc3e101c80c9 X-Archives-Hash: 8901669dd375ca0fdb610efef0ddfe6f 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. ROOT - Path to the root directory. When not using ${D}, - always prepend ${ROOT} 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 pkg_* functions. + Never use this in src_* functions. -- 2.8.2