[gentoo-pms] Rephrasing *DEPEND

["Michał Górny" <mgorny@gentoo.org>]

[-- Attachment #1.1: Type: text/plain, Size: 231 bytes --]

After last discussion on #gentoo-portage, I'm submitting a proposal
on rephrasing *DEPEND descriptions in the PMS. The idea is to state
better when and whether these are actually installed.

-- 
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: 1643 bytes --]

From 9ccce508cb853fa11808b803ef3910fe4cf50f56 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 |   13 ++++++++-----
 1 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/dependencies.tex b/dependencies.tex
index f6318d8..ccf8282 100644
--- a/dependencies.tex
+++ b/dependencies.tex
@@ -6,11 +6,14 @@
 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. They may not be installed at all
+	if a binary package is merged.
+\item Runtime dependencies (\t{RDEPEND}). These must be installed and usable before
+	any of the files installed by the ebuild is treated as usable. They must be installed
+	before any of the ebuild \t{pkg\_*} functions are called.
+\item Post dependencies (\t{PDEPEND}). These must be installed at some point before
+	the system is rebooted after installing the ebuild.
 \end{compactitem}
 
 In addition, \t{SRC\_URI}, \t{HOMEPAGE}, \t{PROVIDE}, \t{RESTRICT}, \t{PROPERTIES}, \t{LICENSE} and
-- 
1.7.5.3


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 316 bytes --]