bash: Add the explanation of test output, and document a known failure

This commit is contained in:
Xi Ruoyao 2023-02-03 01:27:40 +08:00
parent 19f4e4d6ea
commit 5f8b7fe1ab
No known key found for this signature in database
GPG Key ID: ACAAD20E19E710E3

View File

@ -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>