| 1 |
commit: 1779bc63ec5bce6e0c117b1fe90065e9d1622df0 |
| 2 |
Author: Michał Górny <mgorny <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Wed May 5 07:48:35 2021 +0000 |
| 4 |
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Sun Aug 1 09:54:50 2021 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1779bc63 |
| 7 |
|
| 8 |
ebuild-writing/functions/src_test: Clarify how localhost can be used |
| 9 |
|
| 10 |
Closes: https://github.com/gentoo/devmanual/pull/227 |
| 11 |
Signed-off-by: Michał Górny <mgorny <AT> gentoo.org> |
| 12 |
[Reword as suggested by Sam James and Florian Schmaus] |
| 13 |
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> |
| 14 |
|
| 15 |
ebuild-writing/functions/src_test/text.xml | 12 ++++++++++-- |
| 16 |
1 file changed, 10 insertions(+), 2 deletions(-) |
| 17 |
|
| 18 |
diff --git a/ebuild-writing/functions/src_test/text.xml b/ebuild-writing/functions/src_test/text.xml |
| 19 |
index 1822c33..3fa05d5 100644 |
| 20 |
--- a/ebuild-writing/functions/src_test/text.xml |
| 21 |
+++ b/ebuild-writing/functions/src_test/text.xml |
| 22 |
@@ -178,9 +178,17 @@ a more complete test suite. |
| 23 |
</p> |
| 24 |
|
| 25 |
<p> |
| 26 |
-Local server access within the build procedure is additionally |
| 27 |
-forbidden for the following reasons: |
| 28 |
+It is generally considered acceptable to rely on IPv4 <c>localhost</c> being |
| 29 |
+resolvable and available for binding. Tests should only connect to services |
| 30 |
+that are started as part of the testsuite. It is not acceptable to connect |
| 31 |
+to daemons run outside the test environment. |
| 32 |
</p> |
| 33 |
+ |
| 34 |
+<p> |
| 35 |
+Local server access within the build procedure is forbidden for the following |
| 36 |
+reasons: |
| 37 |
+</p> |
| 38 |
+ |
| 39 |
<ul> |
| 40 |
<li> |
| 41 |
tests must run reliably independently of whether a particular |
Archives