commit: e4a6e552a4b2386893fca4d2834e0a38f89a5802 Author: Michael Orlitzky <mjo <AT> gentoo <DOT> org> AuthorDate: Mon Nov 6 13:08:11 2017 +0000 Commit: Brian Evans <grknight <AT> gentoo <DOT> org> CommitDate: Tue Mar 19 17:02:04 2019 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e4a6e552
ebuild-writing/variables: weaken the warning against third-party mirrors. The warning against using third-party mirrors used to say that "the mere existence of a third-party mirror list is not a good enough reason to use it." That goes against a few existing uses of the feature in the ::gentoo repository, so the wording is too strong. This revision changes the warning, leaving the decision up to the maintainer after alerting him to the potential maintenance burden. Closes: https://bugs.gentoo.org/635646 Suggested-by: Michael Palimaka <kensington <AT> gentoo.org> Signed-off-by: Michael Orlitzky <mjo <AT> gentoo.org> Signed-off-by: Brian Evans <grknight <AT> gentoo.org> ebuild-writing/variables/text.xml | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/ebuild-writing/variables/text.xml b/ebuild-writing/variables/text.xml index d3255bd..4e4c76c 100644 --- a/ebuild-writing/variables/text.xml +++ b/ebuild-writing/variables/text.xml @@ -448,13 +448,15 @@ example http://download.example.org/ ftp://ftp.example.org/ SRC_URI="mirror://example/${PN}/${P}.tar.gz" </codesample> <warning> - If the sources for a package are not mirror-restricted or - fetch-restricted, then there is little benefit to using this - feature: the sources will be <uri + If the sources for a package are neither mirror-restricted nor + fetch-restricted, then they will be <uri link="::general-concepts/mirrors">mirrored onto Gentoo - infrastructure</uri> anyway. In other words, the mere existence - of a third-party mirror list is not a good enough reason to use - it. + infrastructure</uri> automatically; in that case, there is + little benefit to using this feature. There is a maintenance + burden associated with using a third-party mirror list: it must + be updated when new mirrors are born and when old mirrors + die. Please consider that when deciding whether or not to use + this feature. </warning> </body> </subsection>
