commit:     217e63be1592ae258ac4761c634414036252e60c
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Mon Feb 16 19:06:08 2015 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Nov  8 19:29:20 2015 +0000
URL:        https://gitweb.gentoo.org/proj/pms.git/commit/?id=217e63be

EAPI 6: unpack supports absolute and relative paths.

Bug: 483244

 eapi-differences.tex |  4 ++++
 pkg-mgr-commands.tex | 26 +++++++++++++++++++++++---
 2 files changed, 27 insertions(+), 3 deletions(-)

diff --git a/eapi-differences.tex b/eapi-differences.tex
index 630fd86..4106754 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -215,6 +215,9 @@ Controllable compression & \compactfeatureref{docompress} &
 \t{in\_iuse} & \compactfeatureref{in-iuse} &
     No & No & No & No & Yes \\
 
+\t{unpack} absolute paths & \compactfeatureref{unpack-absolute} &
+    No & No & No & No & Yes \\
+
 \t{unpack} support for \t{xz}? & \compactfeatureref{unpack-extensions} &
     No & Yes & Yes & Yes & Yes \\
 
@@ -336,6 +339,7 @@ EAPI 6 is EAPI 5 with the following changes:
 \item \t{eapply\_user} support, \featureref{eapply-user}.
 \item \t{econf} adds \t{-{}-docdir} and \t{-{}-htmldir}, 
\featureref{econf-options}.
 \item \t{in\_iuse} support, \featureref{in-iuse}.
+\item \t{unpack} supports absolute and relative paths, 
\featureref{unpack-absolute}.
 \end{compactitem}
 
 \ChangeWhenAddingAnEAPI{6}

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index e951d3b..c7ffcb3 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -844,9 +844,15 @@ has returned.
     the current working directory itself) have permissions \t{a+r,u+w,go-w} 
and that all directories
     under the current working directory additionally have permissions \t{a+x}.
 
-    All arguments to \t{unpack} must be either a filename without path, in 
which case \t{unpack}
-    looks in \t{DISTDIR} for the file, or start with the string \t{./}, in 
which case \t{unpack}
-    uses the argument as a path relative to the working directory.
+    Arguments to \t{unpack} are interpreted as follows:
+    \begin{itemize}
+    \item A filename without path (i.\,e., not containing any slash) is looked 
up in \t{DISTDIR}.
+    \item An argument starting with the string \t{./} is a path relative to 
the working directory.
+    \item \featurelabel{unpack-absolute} Otherwise, for EAPIs listed in
+        table~\ref{tab:unpack-behaviour} as supporting absolute and relative 
paths, the argument is
+        interpreted as a literal path (absolute, or relative to the working 
directory); for EAPIs
+        listed as \e{not} supporting such paths, \t{unpack} shall abort the 
build process.
+    \end{itemize}
 
     Any unrecognised file format shall be skipped silently. If unpacking a 
supported file format
     fails, \t{unpack} shall abort the build process.
@@ -882,6 +888,20 @@ has returned.
     being in the system set or via dependencies.
 
     \ChangeWhenAddingAnEAPI{6}
+    \begin{centertable}{\t{unpack} behaviour for EAPIs}
+        \label{tab:unpack-behaviour}
+        \begin{tabular}{ll}
+          \toprule
+          \multicolumn{1}{c}{\textbf{EAPI}} &
+          \multicolumn{1}{c}{\textbf{Supports absolute and relative paths?}} \\
+          \midrule
+          0, 1, 2, 3, 4, 5  & No  \\
+          6                 & Yes \\
+          \bottomrule
+        \end{tabular}
+    \end{centertable}
+
+    \ChangeWhenAddingAnEAPI{6}
     \begin{centertable}{\t{unpack} extensions for EAPIs}
         \label{tab:unpack-extensions-table}
         \begin{tabular}{ll}

Reply via email to