1 |
Bug: 483244 |
2 |
--- |
3 |
eapi-differences.tex | 4 ++++ |
4 |
pkg-mgr-commands.tex | 26 +++++++++++++++++++++++--- |
5 |
2 files changed, 27 insertions(+), 3 deletions(-) |
6 |
|
7 |
diff --git a/eapi-differences.tex b/eapi-differences.tex |
8 |
index 6002785..27c1ee6 100644 |
9 |
--- a/eapi-differences.tex |
10 |
+++ b/eapi-differences.tex |
11 |
@@ -219,6 +219,9 @@ Controllable compression & \compactfeatureref{docompress} & |
12 |
\t{in\_iuse} & \compactfeatureref{in-iuse} & |
13 |
No & No & No & No & Yes \\ |
14 |
|
15 |
+\t{unpack} absolute paths & \compactfeatureref{unpack-absolute} & |
16 |
+ No & No & No & No & Yes \\ |
17 |
+ |
18 |
\t{unpack} support for \t{xz}? & \compactfeatureref{unpack-extensions} & |
19 |
No & Yes & Yes & Yes & Yes \\ |
20 |
|
21 |
@@ -341,6 +344,7 @@ EAPI 6 is EAPI 5 with the following changes: |
22 |
\item \t{eapply\_user} support, \featureref{eapply-user}. |
23 |
\item \t{econf} adds \t{-{}-docdir} and \t{-{}-htmldir}, \featureref{econf-options}. |
24 |
\item \t{in\_iuse} support, \featureref{in-iuse}. |
25 |
+\item \t{unpack} supports absolute and relative paths, \featureref{unpack-absolute}. |
26 |
\end{compactitem} |
27 |
|
28 |
\ChangeWhenAddingAnEAPI{6} |
29 |
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex |
30 |
index 6b150c7..c16745a 100644 |
31 |
--- a/pkg-mgr-commands.tex |
32 |
+++ b/pkg-mgr-commands.tex |
33 |
@@ -833,9 +833,15 @@ has returned. |
34 |
the current working directory itself) have permissions \t{a+r,u+w,go-w} and that all directories |
35 |
under the current working directory additionally have permissions \t{a+x}. |
36 |
|
37 |
- All arguments to \t{unpack} must be either a filename without path, in which case \t{unpack} |
38 |
- looks in \t{DISTDIR} for the file, or start with the string \t{./}, in which case \t{unpack} |
39 |
- uses the argument as a path relative to the working directory. |
40 |
+ Arguments to \t{unpack} are interpreted as follows: |
41 |
+ \begin{itemize} |
42 |
+ \item A filename without path (i.\,e., not containing any slash) is looked up in \t{DISTDIR}. |
43 |
+ \item An argument starting with the string \t{./} is a path relative to the working directory. |
44 |
+ \item \featurelabel{unpack-absolute} Otherwise, for EAPIs listed in |
45 |
+ table~\ref{tab:unpack-behaviour} as supporting absolute and relative paths, the argument is |
46 |
+ interpreted as a literal path (absolute, or relative to the working directory); for EAPIs |
47 |
+ listed as \e{not} supporting such paths, \t{unpack} shall abort the build process. |
48 |
+ \end{itemize} |
49 |
|
50 |
Any unrecognised file format shall be skipped silently. If unpacking a supported file format |
51 |
fails, \t{unpack} shall abort the build process. |
52 |
@@ -871,6 +877,20 @@ has returned. |
53 |
being in the system set or via dependencies. |
54 |
|
55 |
\ChangeWhenAddingAnEAPI{6} |
56 |
+ \begin{centertable}{\t{unpack} behaviour for EAPIs} |
57 |
+ \label{tab:unpack-behaviour} |
58 |
+ \begin{tabular}{ l l } |
59 |
+ \toprule |
60 |
+ \multicolumn{1}{c}{\textbf{EAPI}} & |
61 |
+ \multicolumn{1}{c}{\textbf{Supports absolute and relative paths?}} \\ |
62 |
+ \midrule |
63 |
+ 0, 1, 2, 3, 4, 5 & No \\ |
64 |
+ 6 & Yes \\ |
65 |
+ \bottomrule |
66 |
+ \end{tabular} |
67 |
+ \end{centertable} |
68 |
+ |
69 |
+ \ChangeWhenAddingAnEAPI{6} |
70 |
\begin{centertable}{\t{unpack} extensions for EAPIs} |
71 |
\label{tab:unpack-extensions-table} |
72 |
\begin{tabular}{ l l } |
73 |
-- |
74 |
2.6.1 |