From mboxrd@z Thu Jan 1 00:00:00 1970
Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org)
by finch.gentoo.org with esmtp (Exim 4.60)
(envelope-from <gentoo-commits+bounces-357694-garchives=archives.gentoo.org@lists.gentoo.org>)
id 1Qapom-0005D5-CS
for garchives@archives.gentoo.org; Sun, 26 Jun 2011 13:56:08 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id 1FCB91C011;
Sun, 26 Jun 2011 13:56:01 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
by pigeon.gentoo.org (Postfix) with ESMTP id E0EAD1C011
for <gentoo-commits@lists.gentoo.org>; Sun, 26 Jun 2011 13:56:00 +0000 (UTC)
Received: from pelican.gentoo.org (unknown [66.219.59.40])
(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id 3783D1B4028
for <gentoo-commits@lists.gentoo.org>; Sun, 26 Jun 2011 13:56:00 +0000 (UTC)
Received: from localhost.localdomain (localhost [127.0.0.1])
by pelican.gentoo.org (Postfix) with ESMTP id 5EBE18003C
for <gentoo-commits@lists.gentoo.org>; Sun, 26 Jun 2011 13:55:59 +0000 (UTC)
From: "Ulrich Mueller" <ulm@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Mueller" <ulm@gentoo.org>
Message-ID: <2f0989d0b6ee10d60593f4d800a1cf5b662f450f.ulm@gentoo>
Subject: [gentoo-commits] proj/pms:master commit in: /
X-VCS-Repository: proj/pms
X-VCS-Files: dependencies.tex
X-VCS-Directories: /
X-VCS-Committer: ulm
X-VCS-Committer-Name: Ulrich Mueller
X-VCS-Revision: 2f0989d0b6ee10d60593f4d800a1cf5b662f450f
Date: Sun, 26 Jun 2011 13:55:59 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: quoted-printable
X-Archives-Salt:
X-Archives-Hash: 69ec4b8dc61a60d9f9cea0aaab40fe19
commit: 2f0989d0b6ee10d60593f4d800a1cf5b662f450f
Author: Micha=C5=82 G=C3=B3rny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Sat Jun 11 07:32:03 2011 +0000
Commit: Ulrich Mueller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Jun 26 13:58:25 2011 +0000
URL: http://git.overlays.gentoo.org/gitweb/?p=3Dproj/pms.git;a=3Dc=
ommit;h=3D2f0989d0
Rephrase *DEPEND to state when and whether they are installed.
---
dependencies.tex | 28 +++++++++++++++++++++++-----
1 files changed, 23 insertions(+), 5 deletions(-)
diff --git a/dependencies.tex b/dependencies.tex
index 45081fe..5bdad39 100644
--- a/dependencies.tex
+++ b/dependencies.tex
@@ -3,16 +3,34 @@
=20
\section{Dependency Classes}
=20
+\begin{centertable}{Dependency classes required to be satisfied for a pa=
rticular phase function} \label{tab:phase-function-dependency-classes}
+ \begin{tabular}{ p{0.2\textwidth} p{0.7\textwidth} }
+ \toprule
+ \multicolumn{1}{c}{\textbf{Phase function}} &
+ \multicolumn{1}{c}{\textbf{Satisfied dependency classes}} \\
+ \midrule
+ \t{pkg\_pretend}, \t{pkg\_setup}, \t{pkg\_info}, \t{pkg\_nofetch} & Non=
e (ebuilds can rely only on the packages in the system set) \\
+ \t{src\_unpack}, \t{src\_prepare}, \t{src\_configure}, \t{src\_compi=
le}, \t{src\_test}, \t{src\_install} & \t{DEPEND} \\
+ \t{pkg\_preinst}, \t{pkg\_postinst}, \t{pkg\_prerm}, \t{pkg\_postrm}=
& \t{RDEPEND} (unless the particular dependency results in a circular de=
pendency, in which case it may be installed later) \\
+ \t{pkg\_config} & \t{RDEPEND}, \t{PDEPEND} \\
+ \bottomrule
+ \end{tabular}
+\end{centertable}
+
There are three classes of dependencies supported by ebuilds:
=20
\begin{compactitem}
-\item Build dependencies (\t{DEPEND}). These must be installed and usabl=
e before the ebuild
- is installed.
-\item Runtime dependencies (\t{RDEPEND}). These must be installed and us=
able before the ebuild
- is treated as usable.
-\item Post dependencies (\t{PDEPEND}). These must be installed at some p=
oint.
+\item Build dependencies (\t{DEPEND}). These must be installed and usabl=
e before any of
+ the ebuild \t{src\_*} phase functions is executed. These may not be ins=
talled at all
+ if a binary package is being merged.
+\item Runtime dependencies (\t{RDEPEND}). These must be installed and us=
able before
+ the results of an ebuild merging are treated as usable.
+\item Post dependencies (\t{PDEPEND}). These must be installed at some p=
oint before
+ the package manager finishes the batch of installs.
\end{compactitem}
=20
+Table~\ref{tab:phase-function-dependency-classes} lists dependencies whi=
ch must be satisfied before a particular phase function is executed.
+
In addition, \t{SRC\_URI}, \t{HOMEPAGE}, \t{RESTRICT}, \t{PROPERTIES}, \=
t{LICENSE} and
\t{REQUIRED\_USE} use dependency-style specifications to specify their v=
alues.
=20