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 0EB32138247 for ; Thu, 23 Jan 2014 01:06:18 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id E8663E0BEC; Thu, 23 Jan 2014 01:06:10 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 67E78E0BEC for ; Thu, 23 Jan 2014 01:06:10 +0000 (UTC) Received: from spoonbill.gentoo.org (spoonbill.gentoo.org [81.93.255.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 96B3E33FB7A for ; Thu, 23 Jan 2014 01:06:09 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by spoonbill.gentoo.org (Postfix) with ESMTP id 57075183B3 for ; Thu, 23 Jan 2014 01:06:08 +0000 (UTC) From: "Mike Frysinger" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Mike Frysinger" Message-ID: <1390439127.669ccb584f4d39b764223ae44cb2d45ac6eb3903.vapier@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: vapier X-VCS-Committer-Name: Mike Frysinger X-VCS-Revision: 669ccb584f4d39b764223ae44cb2d45ac6eb3903 X-VCS-Branch: master Date: Thu, 23 Jan 2014 01:06:08 +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-Archives-Salt: b98cde86-01e8-4ea1-abae-144b561a99dd X-Archives-Hash: e55ad5b98d85a19f3d2d08e363052551 commit: 669ccb584f4d39b764223ae44cb2d45ac6eb3903 Author: Michael Orlitzky gentoo org> AuthorDate: Wed Jan 22 21:18:23 2014 +0000 Commit: Mike Frysinger gentoo org> CommitDate: Thu Jan 23 01:05:27 2014 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=669ccb58 ebuild(5): document the "has" function --- man/ebuild.5 | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/man/ebuild.5 b/man/ebuild.5 index 524006a..32c3ea6 100644 --- a/man/ebuild.5 +++ b/man/ebuild.5 @@ -1049,15 +1049,17 @@ of \fI\-\-without\-\fR. Beginning with \fBEAPI 4\fR, an empty \fIconfigure opt\fR argument is recognized. In \fBEAPI 3\fR and earlier, an empty \fIconfigure opt\fR argument is treated as if it weren't provided. .TP -.B hasv\fR \fI\fR \fI -If \fIitem\fR is in \fIitem list\fR, then \fIitem\fR is echoed and \fBhasv\fR -returns 0. Otherwise, nothing is echoed and 1 is returned. As indicated with -use, there is a non\-echoing version \fBhas\fR. Please use \fBhas\fR in all -places where output is to be disregarded. Never use the output for calculation. +.B has\fR \fI\fR \fI +If \fIitem\fR is in \fIitem list\fR, then \fBhas\fR returns +0. Otherwise, 1 is returned. There is another version, \fBhasv\fR, that +will conditionally echo \fIitem\fR. .br The \fIitem list\fR is delimited by the \fIIFS\fR variable. This variable has a default value of ' ', or a space. It is a \fBbash\fR(1) setting. .TP +.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