aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorXi Ruoyao <xry111@xry111.site>2023-02-03 01:27:40 +0800
committerXi Ruoyao <xry111@xry111.site>2023-02-03 01:33:10 +0800
commit5f8b7fe1ab81a53c79c936dee9d4713455c7b1e3 (patch)
treef16da1929ac7469eec5571895e6237f0f6760fbf
parent19f4e4d6ea6b907d625fb0da4a59e3f40750b5ce (diff)
bash: Add the explanation of test output, and document a known failure
-rw-r--r--chapter08/bash.xml13
1 files changed, 13 insertions, 0 deletions
diff --git a/chapter08/bash.xml b/chapter08/bash.xml
index 5eb49505a..a8bf2b871 100644
--- a/chapter08/bash.xml
+++ b/chapter08/bash.xml
@@ -87,6 +87,19 @@ lassign [wait] _ _ _ value
exit $value
EOF</userinput></screen>
+ <para>The test suite uses <command>diff</command> to detect the
+ difference between test script output and the expected output. Any
+ output from <command>diff</command> (prefixed with
+ <computeroutput>&lt;</computeroutput> and
+ <computeroutput>&gt;</computeroutput>) indicates a test failure, unless
+ there is a message saying the difference can be ignored.
+ <!-- Some host distros set core file size hard limit < 1000, then the
+ test "ulimit -c -S 1000" attempts to set soft limit > hard limit
+ and fail. -->
+ One test named <filename>run-builtins</filename> is known to fail on
+ some host distros with a difference on the first line of the
+ output.</para>
+
<para>Install the package:</para>
<screen><userinput remap="install">make install</userinput></screen>