From: "Michał Górny" <mgorny@gentoo.org>
To: gentoo-pms@lists.gentoo.org
Cc: Ciaran McCreesh <ciaran.mccreesh@googlemail.com>
Subject: Re: [gentoo-pms] Rephrasing *DEPEND
Date: Sun, 12 Jun 2011 20:52:36 +0200 [thread overview]
Message-ID: <20110612205236.13bbdd4b@pomiocik.lan> (raw)
In-Reply-To: <20110611125341.185e19d9@googlemail.com>
[-- Attachment #1.1: Type: text/plain, Size: 251 bytes --]
And here goes another proposal.
This time I introduced a table to clearly state phase function <->
dependency class relationships but I guess someone with a taste should
look at it and make it look good :P.
--
Best regards,
Michał Górny
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.2: 0001-Rephrase-DEPEND-to-state-when-and-whether-they-are-i.patch --]
[-- Type: text/x-patch, Size: 2607 bytes --]
From e1bce9a316494f14d059b5afc0e1912832622334 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= <mgorny@gentoo.org>
Date: Sat, 11 Jun 2011 09:32:03 +0200
Subject: [PATCH] Rephrase *DEPEND to state when and whether they are
installed.
---
dependencies.tex | 27 ++++++++++++++++++++++-----
1 files changed, 22 insertions(+), 5 deletions(-)
diff --git a/dependencies.tex b/dependencies.tex
index f6318d8..b218579 100644
--- a/dependencies.tex
+++ b/dependencies.tex
@@ -6,13 +6,30 @@
There are three classes of dependencies supported by ebuilds:
\begin{compactitem}
-\item Build dependencies (\t{DEPEND}). These must be installed and usable before the ebuild
- is installed.
-\item Runtime dependencies (\t{RDEPEND}). These must be installed and usable before the ebuild
- is treated as usable.
-\item Post dependencies (\t{PDEPEND}). These must be installed at some point.
+\item Build dependencies (\t{DEPEND}). These must be installed and usable before any of
+ the ebuild \t{src\_*} phase functions is executed. These may not be installed at all
+ if a binary package is being merged.
+\item Runtime dependencies (\t{RDEPEND}). These must be installed and usable before
+ the results of an ebuild merging are treated as usable.
+\item Post dependencies (\t{PDEPEND}). These must be installed at some point before
+ the package manager finishes the batch of installs.
\end{compactitem}
+\begin{centertable}{Dependency classes required to be satisfied for a particular 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} & None (ebuilds can rely only on the packages in the system set) \\
+ \t{src\_unpack}, \t{src\_prepare}, \t{src\_configure}, \t{src\_compile}, \t{src\_test}, \t{src\_install} & \t{DEPEND} \\
+ \t{pkg\_preinst}, \t{pkg\_postinst}, \t{pkg\_prerm}, \t{pkg\_postrm}, \t{pkg\_config} & \t{RDEPEND} \\
+ \bottomrule
+ \end{tabular}
+\end{centertable}
+
+Table~\ref{tab:phase-function-dependency-classes} lists dependencies which must be satisfied before a particular phase function is executed.
+
In addition, \t{SRC\_URI}, \t{HOMEPAGE}, \t{PROVIDE}, \t{RESTRICT}, \t{PROPERTIES}, \t{LICENSE} and
\t{REQUIRED\_USE} use dependency-style specifications to specify their values.
--
1.7.5.3
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 316 bytes --]
next prev parent reply other threads:[~2011-06-12 18:52 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-06-11 7:32 [gentoo-pms] Rephrasing *DEPEND Michał Górny
2011-06-11 11:53 ` Ciaran McCreesh
2011-06-12 7:52 ` Michał Górny
2011-06-12 8:18 ` Ulrich Mueller
2011-06-12 9:13 ` Zac Medico
2011-06-12 13:16 ` Michał Górny
2011-06-12 14:49 ` Ulrich Mueller
2011-06-12 14:55 ` Ciaran McCreesh
2011-06-12 18:03 ` Zac Medico
2011-06-12 18:19 ` Ciaran McCreesh
2011-06-12 14:01 ` Brian Harring
2011-06-12 13:29 ` Ciaran McCreesh
2011-06-12 18:52 ` Michał Górny [this message]
2011-06-19 21:21 ` Michał Górny
2011-06-19 21:36 ` Ciaran McCreesh
2011-06-20 6:34 ` Michał Górny
2011-06-20 11:26 ` Ulrich Mueller
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20110612205236.13bbdd4b@pomiocik.lan \
--to=mgorny@gentoo.org \
--cc=ciaran.mccreesh@googlemail.com \
--cc=gentoo-pms@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox