[gentoo-pms] [PATCH 1/2] Define the FILESDIR variable in global scope.

[Ulrich Müller]

This is needed for assigning PATCHES in EAPI 6.

Also add a note that ebuilds must not access the actual directory
in global scope. The situation is similar to WORKDIR which is also
defined in global scope (for assigning S) but with the dir not being
available there.
---
 ebuild-env-vars.tex | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex
index 32cbde3..ba947e2 100644
--- a/ebuild-env-vars.tex
+++ b/ebuild-env-vars.tex
@@ -84,12 +84,14 @@ variable.
     of each element of the \t{SRC\_URI} ebuild metadata variable. Only for EAPIs listed in
     table~\ref{tab:removed-env-vars-table} as supporting \t{AA}. \\
 \t{FILESDIR} &
-    \t{src\_*}\footnote{Not necessarily present when installing from a binary package} &
+    \t{src\_*}, global~scope%
+    \footnote{Not necessarily present when installing from a binary package} &
     No &
-    The full path to the package's files directory, used for small support files or
-    patches. See section~\ref{sec:package-dirs}. May or may not exist; if a repository provides no
-    support files for the package in question then an ebuild must be prepared for the situation
-    where \t{FILESDIR} points to a non-existent directory. \\
+    The full path to the package's files directory, used for small support files or patches.
+    See section~\ref{sec:package-dirs}. Ebuilds must not access the directory in global scope.
+    May or may not exist; if a repository provides no support files for the package in question
+    then an ebuild must be prepared for the situation where \t{FILESDIR} points to a non-existent
+    directory. \\
 \t{PORTDIR} &
     Ditto &
     No &
-- 
2.8.3