| 1 |
The feature of using 'simple filename' to fetch from mirrors |
| 2 |
is ill-defined (which mirrors?). The Portage implementation works only |
| 3 |
if GENTOO_MIRRORS are explicitly set. It's not used in any ebuilds. |
| 4 |
Let's remove it retroactively from the specification. |
| 5 |
|
| 6 |
Bug: https://bugs.gentoo.org/695814 |
| 7 |
Signed-off-by: Michał Górny <mgorny@g.o> |
| 8 |
--- |
| 9 |
appendices.tex | 7 +++++++ |
| 10 |
ebuild-vars.tex | 6 ++---- |
| 11 |
2 files changed, 9 insertions(+), 4 deletions(-) |
| 12 |
|
| 13 |
diff --git a/appendices.tex b/appendices.tex |
| 14 |
index ee537f7..90ad336 100644 |
| 15 |
--- a/appendices.tex |
| 16 |
+++ b/appendices.tex |
| 17 |
@@ -110,6 +110,13 @@ all-of, any-of, exactly-one-of, at-most-one-of and use-conditional groups with z |
| 18 |
However, such empty groups were neither supported by all package managers nor used in ebuilds. |
| 19 |
They were dropped from the specification in October 2017. |
| 20 |
|
| 21 |
+\subsection{Simple filename in SRC\_URI} |
| 22 |
+The SRC\_URI format (see section~\ref{sec:src-uri-behaviour}) originally permitted using a simple |
| 23 |
+filename instead of a full URI to indicate a~file that can be fetched from mirrors only. |
| 24 |
+However, the Portage implementation worked only if the user had configured mirrors explicitly, |
| 25 |
+and it was not used in ebuilds. This feature has been dropped in December 2019, limiting simple |
| 26 |
+filename usage to fetch-restricted packages. |
| 27 |
+ |
| 28 |
% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en : |
| 29 |
|
| 30 |
%%% Local Variables: |
| 31 |
diff --git a/ebuild-vars.tex b/ebuild-vars.tex |
| 32 |
index 2f81db7..86ab2c1 100644 |
| 33 |
--- a/ebuild-vars.tex |
| 34 |
+++ b/ebuild-vars.tex |
| 35 |
@@ -159,11 +159,9 @@ managers may also consult mirrors for their files. |
| 36 |
The special \t{mirror://} protocol must be supported. See section~\ref{sec:thirdpartymirrors} for |
| 37 |
mirror details. |
| 38 |
|
| 39 |
-If a simple filename rather than a full URI is provided, the package manager can only use mirrors |
| 40 |
-to download the file. |
| 41 |
- |
| 42 |
The \t{RESTRICT} metadata key can be used to impose additional restrictions upon downloading---see |
| 43 |
-section~\ref{sec:restrict} for details. |
| 44 |
+section~\ref{sec:restrict} for details. If a fetch restriction is used, a simple filename can |
| 45 |
+be used in lieu of full URI. |
| 46 |
|
| 47 |
\featurelabel{src-uri-arrows} In EAPIs listed in table~\ref{tab:uri-arrows-table} as supporting |
| 48 |
arrows, if an arrow is used, the filename used when saving to \t{DISTDIR} shall instead be the name |
| 49 |
-- |
| 50 |
2.24.1 |
Archives