diff options
| author |   Michał Górny <mgorny@gentoo.org> | 2019-10-06 09:59:33 +0200 |
|---|---|---|
| committer |   Göktürk Yüksek <gokturk@gentoo.org> | 2019-10-16 15:53:37 -0400 |
| commit | 3c24f9dfdfd76d2ea0ca3b7015afaa62b43cff99 (patch) | |
| tree | ef955f943078b6d42f3d0c176dcc96c8666dfa49 /general-concepts/mirrors | |
| parent | general-concepts/mirrors: Discourage RESTRICT=primaryuri (diff) | |
| download | devmanual-3c24f9dfdfd76d2ea0ca3b7015afaa62b43cff99.tar.gz devmanual-3c24f9dfdfd76d2ea0ca3b7015afaa62b43cff99.tar.bz2 devmanual-3c24f9dfdfd76d2ea0ca3b7015afaa62b43cff99.zip | |
general-concepts/mirrors: Update the method of replacing files
The modern method of replacing repackaged distfiles is to rename them
using SRC_URI arrows, not do some mirror-replacement voodoo.
Acked-by: Michael Orlitzky <mjo@gentoo.org>
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
Diffstat (limited to 'general-concepts/mirrors')
| -rw-r--r-- | general-concepts/mirrors/text.xml | 28 |
1 files changed, 18 insertions, 10 deletions
diff --git a/general-concepts/mirrors/text.xml b/general-concepts/mirrors/text.xml index 7cc6b76..24dc188 100644 --- a/general-concepts/mirrors/text.xml +++ b/general-concepts/mirrors/text.xml @@ -50,16 +50,24 @@ found. This should only be used if a license requires it. <title>Replacing Automatically Mirrored Files</title> <body> <p> -On rare occasions you may need to replace a file that is already mirrored. In this case proceed as -follows: -<ol> - <li>Put a copy of the new distfile on dev.gentoo.org into /space/distfiles-local</li> - <li>commit the new manifest to the git tree</li> - <li>wait</li> -</ol> -After a few hours a cron job on dev.gentoo.org will fetch the file and replace the version on the -mirrors. The file will be automatically removed from /space/distfiles-local after approximately two -weeks. +On rare occasions you may need to replace a file that is already mirrored. +This is usually the case when upstream remakes a release package. If this +is necessary, please use <c>SRC_URI</c> arrow to rename the file. For example: +</p> + +<codesample lang="ebuild"> +# upstream updated the distfile in place, so make it .r1 +SRC_URI="https://example.com/badupstream/${P}.tar.gz -> ${P}.r1.tar.gz" +</codesample> + +<p> +Since Gentoo mirrors operate using local distfile names, they will automatically +fetch and start distributing the new version. +</p> + +<p> +Please note that if upstream made any changes affecting the built package, +you need to also bump the ebuild's revision. </p> <p> |