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

[Ulrich Müller]

commit:     23a5480394d2202081f76a1bf78b3785e7f3a4c6
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:50:55 2021 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=23a54803

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 <sam <AT> gentoo.org>]
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..3b87060 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 to and connecting to services started
+within the phase. However, it is not acceptable to connect to the 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