aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJoonas Niilola <juippis@gentoo.org>2021-09-28 15:40:45 +0300
committerJoonas Niilola <juippis@gentoo.org>2021-10-10 13:18:29 +0300
commita7574212eac4741e41f07bf443273d08feff50c6 (patch)
treee86448d19965044073996e23a48c531d75bfed7a /general-concepts/mirrors/text.xml
parentgeneral-concepts/copyright-policy: Small touchups (diff)
downloaddevmanual-a7574212eac4741e41f07bf443273d08feff50c6.tar.gz
devmanual-a7574212eac4741e41f07bf443273d08feff50c6.tar.bz2
devmanual-a7574212eac4741e41f07bf443273d08feff50c6.zip
general-concepts/mirrors: update info about mirror://gentoo
- add a clearer note about chmod'ing your distfile, - make it very clear that d.g.o:/space/distfiles-local is not accessible anymore, and show the current way of hosting your own distfiles, - wrap the document source at 80 chars. Signed-off-by: Joonas Niilola <juippis@gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/253
Diffstat (limited to 'general-concepts/mirrors/text.xml')
-rw-r--r--general-concepts/mirrors/text.xml36
1 files changed, 13 insertions, 23 deletions
diff --git a/general-concepts/mirrors/text.xml b/general-concepts/mirrors/text.xml
index 61b8618..c39c385 100644
--- a/general-concepts/mirrors/text.xml
+++ b/general-concepts/mirrors/text.xml
@@ -42,8 +42,8 @@ This should not be used in new ebuilds.
<p>
There is also <c>RESTRICT="fetch"</c>, which prevents Portage from trying to
fetch anything manually. The <uri link="::ebuild-writing/functions/pkg_nofetch">
-pkg_nofetch</uri> function will be called if any <c>SRC_URI</c> components cannot be
-found. This should only be used if a license requires it.
+pkg_nofetch</uri> function will be called if any <c>SRC_URI</c> components
+cannot be found. This should only be used if a license requires it.
</p>
</body>
</subsection>
@@ -100,15 +100,16 @@ devspace.
</p>
<p>
-Previous policy was to use <c>mirror://gentoo</c> directly, but this is now deprecated, as that
-wouldn't allow to have long-term availability and traceability of the source files, which might be a
-requirement of the license.
+Previous policy was to use <c>mirror://gentoo</c> directly, but this is now
+prohibited, as that wouldn't allow to have long-term availability and
+traceability of the source files, which might be a requirement of the license.
</p>
<p>
-When you upload the file to <c>dev.gentoo.org:~/public_html</c>, you must ensure that it, and its
-parent directories, are world-readable. An example <c>SRC_URI</c> referencing
-a distfile mirrored this way is as follows:
+When you upload the distfile to <c>dev.gentoo.org:~/public_html</c>, ensure that
+your file and its parent directories have the correct permissions, so they're
+accessible. An example <c>SRC_URI</c> referencing a distfile mirrored this way
+is as follows:
</p>
<codesample lang="ebuild">
@@ -119,25 +120,14 @@ SRC_URI="https://dev.gentoo.org/~myname/distfiles/${P}.tar.gz"
where <c>myname</c> refers to the username of the developer.
</p>
-</body>
-</subsection>
-</section>
-
-<section>
-<title>Gentoo Mirrors</title>
-
-<body>
<p>
-To manually upload a file to <c>mirror://gentoo</c>, <c>scp</c> it to
-<c>dev.gentoo.org:/space/distfiles-local</c>. The file should appear
-on the mirrors within four hours (note that this is <e>less
-frequent</e> than <uri link="::general-concepts/git-to-rsync"/>).
-
If the upstream download location for a package uses a non-standard TCP port
-(anything other than 21, 80 or 443), you <e>must</e> manually mirror the files. Not
-doing so can cause all kinds of problems with strict firewalls.
+(anything other than 21, 80 or 443), you <e>must</e> manually mirror the files.
+Not doing so can cause all kinds of problems with strict firewalls.
</p>
+
</body>
+</subsection>
</section>
<section>