aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2020-03-02 11:46:32 +0100
committerUlrich Müller <ulm@gentoo.org>2020-03-02 11:46:32 +0100
commit5161bfd22b3d53941986b7c55ca7c3c06e54a470 (patch)
tree6ba82fffe380506f38d7ae42c31d47d564e20a0a /ebuild-maintenance
parentMakefile, depend.xsl: Use XSLT to generate the list of dependencies. (diff)
downloaddevmanual-5161bfd22b3d53941986b7c55ca7c3c06e54a470.tar.gz
devmanual-5161bfd22b3d53941986b7c55ca7c3c06e54a470.tar.bz2
devmanual-5161bfd22b3d53941986b7c55ca7c3c06e54a470.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>
Diffstat (limited to 'ebuild-maintenance')
-rw-r--r--ebuild-maintenance/new-ebuild/text.xml27
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>