Gentoo Archives: gentoo-pms

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-pms@l.g.o
Subject: [gentoo-pms] [PATCH] WORKDIR has same scope as FILESDIR and DISTDIR.
Date: Sat, 18 Mar 2017 14:35:29
Message-Id: 22733.17812.529801.720971@a1i15.kph.uni-mainz.de
1 Ebuilds must not access the WORKDIR directory in global scope, so the
2 FILESDIR footnote applies to it, too. Rearrange the table accordingly.
3
4 Also small change of wording ("in which" -> "where") to prevent an
5 awkward page break.
6 ---
7 ebuild-env-vars.tex | 24 ++++++++++++------------
8 1 file changed, 12 insertions(+), 12 deletions(-)
9
10 diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex
11 index 262bcf9..6b6e1c9 100644
12 --- a/ebuild-env-vars.tex
13 +++ b/ebuild-env-vars.tex
14 @@ -95,6 +95,18 @@ variable.
15 Ditto &
16 Yes &
17 The full path to the directory in which the files in the \t{A} variable are stored. \\
18 +\t{WORKDIR} &
19 + Ditto &
20 + Yes &
21 + The full path to the ebuild's working directory, where all build data should be contained.%
22 + \label{env-var-WORKDIR} \\
23 +\t{S} &
24 + \t{src\_*} &
25 + Yes &
26 + The full path to the temporary build directory, used by \t{src\_compile}, \t{src\_install} etc.
27 + Defaults to \t{\$\{WORKDIR\}/\$\{P\}}. May be modified by ebuilds. If \t{S} is assigned in the
28 + global scope of an ebuild, then the restrictions of section~\ref{sec:ebuild-env-state} for
29 + global variables apply. \\
30 \t{PORTDIR} &
31 \t{src\_*} &
32 No &
33 @@ -190,18 +202,6 @@ variable.
34 was executed by the package manager. May be unset or any single word that is not any of the
35 above when the ebuild is being sourced for other (e.\,g.\ metadata or QA) purposes. Only for
36 EAPIs listed in table~\ref{tab:added-env-vars-table} as supporting \t{EBUILD\_PHASE\_FUNC}. \\
37 -\t{WORKDIR} &
38 - \t{src\_*}, global~scope &
39 - Yes &
40 - The full path to the ebuild's working directory, in which all build data should be
41 - contained. \label{env-var-WORKDIR} \\
42 -\t{S} &
43 - \t{src\_*} &
44 - Yes &
45 - The full path to the temporary build directory, used by \t{src\_compile}, \t{src\_install} etc.
46 - Defaults to \t{\$\{WORKDIR\}/\$\{P\}}. May be modified by ebuilds. If \t{S} is assigned in the
47 - global scope of an ebuild, then the restrictions of section~\ref{sec:ebuild-env-state} for
48 - global variables apply. \\
49 \t{KV} &
50 All &
51 Yes &
52 --
53 2.12.0

Replies