aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2021-05-05 09:48:35 +0200
committerUlrich Müller <ulm@gentoo.org>2021-08-01 11:54:50 +0200
commit1779bc63ec5bce6e0c117b1fe90065e9d1622df0 (patch)
tree1999028d63d9e62e7b13a06f0fcb85bdf6f87586 /ebuild-writing
parentebuild-writing/common-mistakes: rewrap paragraph (diff)
downloaddevmanual-1779bc63ec5bce6e0c117b1fe90065e9d1622df0.tar.gz
devmanual-1779bc63ec5bce6e0c117b1fe90065e9d1622df0.tar.bz2
devmanual-1779bc63ec5bce6e0c117b1fe90065e9d1622df0.zip
ebuild-writing/functions/src_test: Clarify how localhost can be used
Closes: https://github.com/gentoo/devmanual/pull/227 Signed-off-by: Michał Górny <mgorny@gentoo.org> [Reword as suggested by Sam James and Florian Schmaus] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'ebuild-writing')
-rw-r--r--ebuild-writing/functions/src_test/text.xml12
1 files changed, 10 insertions, 2 deletions
diff --git a/ebuild-writing/functions/src_test/text.xml b/ebuild-writing/functions/src_test/text.xml
index 1822c33..3fa05d5 100644
--- a/ebuild-writing/functions/src_test/text.xml
+++ b/ebuild-writing/functions/src_test/text.xml
@@ -178,9 +178,17 @@ a more complete test suite.
</p>
<p>
-Local server access within the build procedure is additionally
-forbidden for the following reasons:
+It is generally considered acceptable to rely on IPv4 <c>localhost</c> being
+resolvable and available for binding. Tests should only connect to services
+that are started as part of the testsuite. It is not acceptable to connect
+to daemons run outside the test environment.
</p>
+
+<p>
+Local server access within the build procedure is forbidden for the following
+reasons:
+</p>
+
<ul>
<li>
tests must run reliably independently of whether a particular