[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/src_test/

["Ulrich Müller" <ulm@gentoo.org>]

commit:     1779bc63ec5bce6e0c117b1fe90065e9d1622df0
Author:     Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Wed May  5 07:48:35 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Aug  1 09:54:50 2021 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1779bc63

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 <AT> gentoo.org>
[Reword as suggested by Sam James and Florian Schmaus]
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 ebuild-writing/functions/src_test/text.xml | 12 ++++++++++--
 1 file 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