diff options
| author |   Ulrich Müller <ulm@gentoo.org> | 2020-03-02 11:46:32 +0100 |
|---|---|---|
| committer | Ulrich Müller <ulm@gentoo.org> | 2020-03-02 11:46:32 +0100 |
| commit | 5161bfd22b3d53941986b7c55ca7c3c06e54a470 (patch) | |
| tree | 6ba82fffe380506f38d7ae42c31d47d564e20a0a | |
| parent | Makefile, depend.xsl: Use XSLT to generate the list of dependencies. (diff) | |
| download | devmanual-5161bfd2.tar.gz devmanual-5161bfd2.tar.bz2 devmanual-5161bfd2.zip | |
ebuild-maintenance/new-ebuild: Update "What (not) to put in the tree".
Closes: https://bugs.gentoo.org/585218
Reported-by: Jonas Stein <jstein@gentoo.org>
Signed-off-by: Ulrich Müller <ulm@gentoo.org>
| -rw-r--r-- | ebuild-maintenance/new-ebuild/text.xml | 27 |
1 files 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> |