| 1 |
commit: 5161bfd22b3d53941986b7c55ca7c3c06e54a470 |
| 2 |
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Mon Mar 2 10:46:32 2020 +0000 |
| 4 |
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Mon Mar 2 10:46:32 2020 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=5161bfd2 |
| 7 |
|
| 8 |
ebuild-maintenance/new-ebuild: Update "What (not) to put in the tree". |
| 9 |
|
| 10 |
Closes: https://bugs.gentoo.org/585218 |
| 11 |
Reported-by: Jonas Stein <jstein <AT> gentoo.org> |
| 12 |
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> |
| 13 |
|
| 14 |
ebuild-maintenance/new-ebuild/text.xml | 27 +++++++++++++-------------- |
| 15 |
1 file changed, 13 insertions(+), 14 deletions(-) |
| 16 |
|
| 17 |
diff --git a/ebuild-maintenance/new-ebuild/text.xml b/ebuild-maintenance/new-ebuild/text.xml |
| 18 |
index 332b527..ad7f74c 100644 |
| 19 |
--- a/ebuild-maintenance/new-ebuild/text.xml |
| 20 |
+++ b/ebuild-maintenance/new-ebuild/text.xml |
| 21 |
@@ -20,20 +20,19 @@ select all possible fields, then submit the query. For you lazy people, click |
| 22 |
</p> |
| 23 |
|
| 24 |
<p> |
| 25 |
-In general, the Gentoo repository should only be used for storing |
| 26 |
-<c>.ebuild</c> files, as well as any relatively small companion |
| 27 |
-files, such as patches or sample configuration files. These types of |
| 28 |
-files should be placed in the <c>mycat/mypkg/files</c> directory |
| 29 |
-to keep the main <c>mycat/mypkg</c> directory uncluttered. |
| 30 |
-Exceptions to this rule are for larger patch files (we recommend this |
| 31 |
-for patches above 20KB) which should be distributed as tarballs via the |
| 32 |
-<uri link="::general-concepts/mirrors/#Suitable Download Hosts">Gentoo |
| 33 |
-mirror system</uri> so that people do not waste excessive amounts of |
| 34 |
-bandwidth and hard drive space. Also, you should not add binary |
| 35 |
-(non-ASCII) files to the git tree. Also, speaking of merging changes, |
| 36 |
-any patches you add to Portage should generally <e>not</e> be |
| 37 |
-compressed. This will allow git to merge changes and correctly inform |
| 38 |
-developers of conflicts. |
| 39 |
+The Gentoo repository should only be used for storing <c>.ebuild</c> files, |
| 40 |
+as well as any small companion files, such as patches or sample configuration |
| 41 |
+files. These files should have a size of at most 20 KiB and must be placed |
| 42 |
+in the <c>mycat/mypkg/files</c> directory, which can be referenced as |
| 43 |
+<c>${FILESDIR}</c> from within ebuilds. Larger patch files should be placed |
| 44 |
+in your developer space on <c>dev.gentoo.org</c> instead, in order to minimize |
| 45 |
+the repository size. |
| 46 |
+</p> |
| 47 |
+ |
| 48 |
+<p> |
| 49 |
+The files in the repository should be uncompressed plain text files, i.e., |
| 50 |
+no binaries. This will allow the version control system to merge changes and |
| 51 |
+correctly inform developers of conflicts. |
| 52 |
</p> |
| 53 |
|
| 54 |
<p> |
Archives