From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 6CF27138334 for ; Sun, 17 Mar 2019 20:31:22 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3B1D6E0824; Sun, 17 Mar 2019 20:31:21 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id EECB8E0824 for ; Sun, 17 Mar 2019 20:31:20 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 29AE8335CED for ; Sun, 17 Mar 2019 20:31:19 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 8A2FC53F for ; Sun, 17 Mar 2019 20:31:17 +0000 (UTC) From: "Zac Medico" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Zac Medico" Message-ID: <1552854470.095f2391505547eb2149dd9b808c6f9bb507142a.zmedico@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/ebuild.5 X-VCS-Directories: man/ X-VCS-Committer: zmedico X-VCS-Committer-Name: Zac Medico X-VCS-Revision: 095f2391505547eb2149dd9b808c6f9bb507142a X-VCS-Branch: master Date: Sun, 17 Mar 2019 20:31:17 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 08366b4f-b8a5-48bc-94e3-52e4ab0edb79 X-Archives-Hash: 784217e858b723663da3ed425b66b48b commit: 095f2391505547eb2149dd9b808c6f9bb507142a Author: James Le Cuirot gentoo org> AuthorDate: Sun Mar 17 13:50:26 2019 +0000 Commit: Zac Medico gentoo org> CommitDate: Sun Mar 17 20:27:50 2019 +0000 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=095f2391 man: Update has_version and best_version descriptions for EAPI 7 Closes: https://github.com/gentoo/portage/pull/412 Signed-off-by: James Le Cuirot gentoo.org> Signed-off-by: Zac Medico gentoo.org> man/ebuild.5 | 36 ++++++++++++++++++++++-------------- 1 file changed, 22 insertions(+), 14 deletions(-) diff --git a/man/ebuild.5 b/man/ebuild.5 index 5ae84eb74..85a621fa3 100644 --- a/man/ebuild.5 +++ b/man/ebuild.5 @@ -1086,20 +1086,28 @@ has a default value of ' ', or a space. It is a \fBbash\fR(1) setting. .B hasv\fR \fI\fR \fI Like \fBhas\fR, but also echoes \fIitem\fR when \fBhas\fR returns true. .TP -.B has_version\fR \fI[\-\-host\-root]\fR \fI -Check to see if \fIcategory/package\-version\fR is installed on the system. -The parameter accepts all values that are acceptable in the \fBDEPEND\fR -variable. The function returns 0 if \fIcategory/package\-version\fR is -installed, 1 otherwise. Beginning with \fBEAPI 5\fR, the -\-\-host\-root option may be used in order to cause the query -to apply to the host root instead of ${ROOT}. -.TP -.B best_version\fR \fI[\-\-host\-root]\fR \fI -This function will look up \fIpackage name\fR in the database of currently -installed programs and echo the "best version" of the package that is -currently installed. Beginning with \fBEAPI 5\fR, the -\-\-host\-root option may be used in order to cause the query -to apply to the host root instead of ${ROOT}. +.B has_version\fR \fI[\-b]\fR \fI[\-d]\fR \fI[\-r]\fR \fI[\-\-host\-root]\fR \fI +Check to see if \fIcategory/package\-version\fR is installed. The +parameter accepts all values that are acceptable in the \fBDEPEND\fR +variable. The function returns 0 if \fIcategory/package\-version\fR +is installed, 1 otherwise. The package is searched for in \fBROOT\fR +by default. + +In \fBEAPI 5\fR and \fBEAPI 6\fR, the package is searched for in the +build host if the \fI\-\-host\-root\fR option is given. + +In \fBEAPI 7\fR and later, the confusing \fI\-\-host\-root\fR option +has been replaced with \fI\-b\fR, which corresponds to a dependency +satisfied by \fBBDEPEND\fR in the build host. Similarly, the +\fI\-d\fR option corresponds to \fBDEPEND\fR in \fBSYSROOT\fR and the +\fI\-r\fR option corresponds to \fBRDEPEND\fR in \fBROOT\fR. +.TP +.B best_version\fR \fI[\-b]\fR \fI[\-d]\fR \fI[\-r]\fR \fI[\-\-host\-root]\fR \fI +This function will look up \fIpackage name\fR in the database of +currently installed packages and echo the "best version" of the +package that is found or nothing if no version is installed. The +package is searched for in \fBROOT\fR by default. It accepts the same +options as \fBhas_version\fR. Example: .nf