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 78834138010 for ; Mon, 24 Sep 2012 20:28:23 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 31B4DE0760; Mon, 24 Sep 2012 20:28:06 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id E96A3E0760 for ; Mon, 24 Sep 2012 20:28:05 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 0E3F133C9F5 for ; Mon, 24 Sep 2012 20:28:05 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id C6D47E5444 for ; Mon, 24 Sep 2012 20:28:03 +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: <1348518450.2e39f26cad22946d8ffe378c512de49cdac8d24c.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: 2e39f26cad22946d8ffe378c512de49cdac8d24c X-VCS-Branch: master Date: Mon, 24 Sep 2012 20:28:03 +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: d6809827-55f7-4044-b4dc-316b7fdd1053 X-Archives-Hash: 992e8dae2871b010795a8900b84f4dd8 commit: 2e39f26cad22946d8ffe378c512de49cdac8d24c Author: Dennis Schridde gmx net> AuthorDate: Mon Sep 24 12:16:01 2012 +0000 Commit: Zac Medico gentoo org> CommitDate: Mon Sep 24 20:27:30 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=2e39f26c Document HDEPEND in ebuild(5) --- man/ebuild.5 | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 46 insertions(+), 0 deletions(-) diff --git a/man/ebuild.5 b/man/ebuild.5 index 45819d7..ad73034 100644 --- a/man/ebuild.5 +++ b/man/ebuild.5 @@ -316,6 +316,36 @@ the user does not specify any of the previous choices. Note that if any of the packages listed are already merged, the package manager will use that to consider the dependency satisfied. +.SS "Cross-compilation" +Portage supports cross-compilation into a subdirectory specified by \fBROOT\fR. +.TP +.B Host +\fIHost\fR in this context means the platform hosting the build process, i.e. +what autotools calls CBUILD. +Its packages are contained in the root of the filesystem ("\fI/\fR"). +If \fBROOT\fR is "\fI/\fR", all dependency types will be installed there. +Otherwise, starting from experimental \fBEAPI 5-hdepend\fR, only \fBHDEPEND\fR +is installed into "\fI/\fR". +In \fBEAPI 5\fR and earlier, the behaviour is controlled by the +\fI\-\-root-deps\fR flag to \fBemerge\fR(1), defaulting to install only +\fBDEPEND\fR into the \fIhost\fR. +.TP +.B Target +\fITarget\fR refers to the platform that the package will later run on, i.e. +what autotools calls CHOST. +The directory housing this system is specified by \fBROOT\fR. +If it is different from "\fI/\fR", i.e. \fIhost\fR and \fItarget\fR are not the +same, this variable contains the path to the directory housing the \fItarget\fR +system. +Starting from experimental \fBEAPI 5-hdepend\fR, \fBDEPEND\fR and \fBRDEPEND\fR +list the \fItarget\fR dependencies, i.e. those to be installed into \fBROOT\fR. +In \fBEAPI 5\fR and earlier, the \fBemerge\fR(1) flag \fI\-\-root-deps\fR +controlled what the package manager installed there, defaulting to only +\fBRDEPEND\fR. +.PP +See section \fBVARIABLES\fR for more information about the \fBDEPEND\fR, +\fBRDEPEND\fR and \fBHDEPEND\fR variables. + .SH "VARIABLES" .TP .B Usage Notes @@ -547,6 +577,11 @@ This should contain a list of all packages that are required for the program to compile (aka \fIbuildtime\fR dependencies). These are usually libraries and headers. +Starting from experimental \fBEAPI 5-hdepend\fR, tools should go into the +\fBHDEPEND\fR variable instead, as \fBDEPEND\fR will only be installed into the +\fItarget\fR system and hence cannot be executed in a cross\-compile setting. +(See section \fBCross\-compilation\fR for more information.) + You may use the syntax described above in the \fBDependencies\fR section. .TP .B RDEPEND @@ -559,6 +594,17 @@ implicitly set. You may use the syntax described above in the \fBDependencies\fR section. .TP +.B HDEPEND +This should contain a list of all packages that are required to be executable +during compilation of this program (aka \fIhost\fR buildtime dependencies). +These are usually tools, like interpreters or (cross\-)compilers. + +This variable is new in experimental \fBEAPI 5-hdepend\fR and will be installed +into the \fIhost\fR system. +(See section \fBCross-compilation\fR for more information.) + +You may use the syntax described above in the \fBDependencies\fR section. +.TP .B PDEPEND This should contain a list of all packages that should be merged after this one (aka \fIpost\fR merge dependencies), but which may be installed by the