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