| 1 |
commit: a7574212eac4741e41f07bf443273d08feff50c6 |
| 2 |
Author: Joonas Niilola <juippis <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Tue Sep 28 12:40:45 2021 +0000 |
| 4 |
Commit: Joonas Niilola <juippis <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Sun Oct 10 10:18:29 2021 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=a7574212 |
| 7 |
|
| 8 |
general-concepts/mirrors: update info about mirror://gentoo |
| 9 |
|
| 10 |
- add a clearer note about chmod'ing your distfile, |
| 11 |
- make it very clear that d.g.o:/space/distfiles-local is not |
| 12 |
accessible anymore, and show the current way of hosting your own |
| 13 |
distfiles, |
| 14 |
- wrap the document source at 80 chars. |
| 15 |
|
| 16 |
Signed-off-by: Joonas Niilola <juippis <AT> gentoo.org> |
| 17 |
Closes: https://github.com/gentoo/devmanual/pull/253 |
| 18 |
|
| 19 |
general-concepts/mirrors/text.xml | 36 +++++++++++++----------------------- |
| 20 |
1 file changed, 13 insertions(+), 23 deletions(-) |
| 21 |
|
| 22 |
diff --git a/general-concepts/mirrors/text.xml b/general-concepts/mirrors/text.xml |
| 23 |
index 61b8618..c39c385 100644 |
| 24 |
--- a/general-concepts/mirrors/text.xml |
| 25 |
+++ b/general-concepts/mirrors/text.xml |
| 26 |
@@ -42,8 +42,8 @@ This should not be used in new ebuilds. |
| 27 |
<p> |
| 28 |
There is also <c>RESTRICT="fetch"</c>, which prevents Portage from trying to |
| 29 |
fetch anything manually. The <uri link="::ebuild-writing/functions/pkg_nofetch"> |
| 30 |
-pkg_nofetch</uri> function will be called if any <c>SRC_URI</c> components cannot be |
| 31 |
-found. This should only be used if a license requires it. |
| 32 |
+pkg_nofetch</uri> function will be called if any <c>SRC_URI</c> components |
| 33 |
+cannot be found. This should only be used if a license requires it. |
| 34 |
</p> |
| 35 |
</body> |
| 36 |
</subsection> |
| 37 |
@@ -100,15 +100,16 @@ devspace. |
| 38 |
</p> |
| 39 |
|
| 40 |
<p> |
| 41 |
-Previous policy was to use <c>mirror://gentoo</c> directly, but this is now deprecated, as that |
| 42 |
-wouldn't allow to have long-term availability and traceability of the source files, which might be a |
| 43 |
-requirement of the license. |
| 44 |
+Previous policy was to use <c>mirror://gentoo</c> directly, but this is now |
| 45 |
+prohibited, as that wouldn't allow to have long-term availability and |
| 46 |
+traceability of the source files, which might be a requirement of the license. |
| 47 |
</p> |
| 48 |
|
| 49 |
<p> |
| 50 |
-When you upload the file to <c>dev.gentoo.org:~/public_html</c>, you must ensure that it, and its |
| 51 |
-parent directories, are world-readable. An example <c>SRC_URI</c> referencing |
| 52 |
-a distfile mirrored this way is as follows: |
| 53 |
+When you upload the distfile to <c>dev.gentoo.org:~/public_html</c>, ensure that |
| 54 |
+your file and its parent directories have the correct permissions, so they're |
| 55 |
+accessible. An example <c>SRC_URI</c> referencing a distfile mirrored this way |
| 56 |
+is as follows: |
| 57 |
</p> |
| 58 |
|
| 59 |
<codesample lang="ebuild"> |
| 60 |
@@ -119,25 +120,14 @@ SRC_URI="https://dev.gentoo.org/~myname/distfiles/${P}.tar.gz" |
| 61 |
where <c>myname</c> refers to the username of the developer. |
| 62 |
</p> |
| 63 |
|
| 64 |
-</body> |
| 65 |
-</subsection> |
| 66 |
-</section> |
| 67 |
- |
| 68 |
-<section> |
| 69 |
-<title>Gentoo Mirrors</title> |
| 70 |
- |
| 71 |
-<body> |
| 72 |
<p> |
| 73 |
-To manually upload a file to <c>mirror://gentoo</c>, <c>scp</c> it to |
| 74 |
-<c>dev.gentoo.org:/space/distfiles-local</c>. The file should appear |
| 75 |
-on the mirrors within four hours (note that this is <e>less |
| 76 |
-frequent</e> than <uri link="::general-concepts/git-to-rsync"/>). |
| 77 |
- |
| 78 |
If the upstream download location for a package uses a non-standard TCP port |
| 79 |
-(anything other than 21, 80 or 443), you <e>must</e> manually mirror the files. Not |
| 80 |
-doing so can cause all kinds of problems with strict firewalls. |
| 81 |
+(anything other than 21, 80 or 443), you <e>must</e> manually mirror the files. |
| 82 |
+Not doing so can cause all kinds of problems with strict firewalls. |
| 83 |
</p> |
| 84 |
+ |
| 85 |
</body> |
| 86 |
+</subsection> |
| 87 |
</section> |
| 88 |
|
| 89 |
<section> |
Archives