mirror/gcc
2
0
Fork 0
mirror of git://gcc.gnu.org/git/gcc.git synced 2025-01-25 07:54:01 +08:00
Code Issues Packages Projects Releases Wiki Activity

test.html: Fix markup.

Browse Source 
2003-05-21  Jonathan Wakely  <redi@gcc.gnu.org>

	* docs/html/test.html: Fix markup.

From-SVN: r67060
This commit is contained in:
Jonathan Wakely 2003-05-21 13:15:18 +01:00
parent 6aeed3e155
commit baf64b4ec1
2 changed files with 40 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
libstdc++-v3/ChangeLog
View File

@ -1,3 +1,7 @@
2003-05-21 Jonathan Wakely <redi@gcc.gnu.org>
* docs/html/test.html: Fix markup.
2003-05-21 Danny Smith <dannysmith@users.sourceforge.net> 2003-05-21 Danny Smith <dannysmith@users.sourceforge.net>
* libmath/stubs.c (hypot, hypotf, hypotl): Don't divide by * libmath/stubs.c (hypot, hypotf, hypotl): Don't divide by

59
libstdc++-v3/docs/html/test.html
View File

@ -50,7 +50,7 @@
the C++ standard, and each containing test files or the C++ standard, and each containing test files or
subdirectories of test files that test for that particular part subdirectories of test files that test for that particular part
of the standard. of the standard.
<p> </p>
<pre> <pre>
17_intro 17_intro
@ -97,7 +97,7 @@ data Sample text files for testing input and output.
was named accordingly. For instance, to test items related to was named accordingly. For instance, to test items related to
<code> 21.3.6.1 - basic_string::find [lib.string::find]</code> <code> 21.3.6.1 - basic_string::find [lib.string::find]</code>
in the standard, the following was used: in the standard, the following was used:
<p> </p>
<pre> <pre>
21_strings/find.cc 21_strings/find.cc
</pre> </pre>
@ -142,11 +142,11 @@ data Sample text files for testing input and output.
This test case expects some kind of interactive input in order This test case expects some kind of interactive input in order
to finish or pass. At the moment, the interactive tests are not to finish or pass. At the moment, the interactive tests are not
run by default. Instead, they are run by hand, like: run by default. Instead, they are run by hand, like:
</p>
<pre> <pre>
g++ 27_io/objects/char/3_xin.cc g++ 27_io/objects/char/3_xin.cc
cat 27_io/objects/char/3_xin.in | a.out cat 27_io/objects/char/3_xin.in | a.out
</pre> </pre>
</p>
</li> </li>
<li> <li>
<em>.in</em> <em>.in</em>
@ -320,17 +320,17 @@ cat 27_io/objects/char/3_xin.in | a.out
# compile). # compile).
# #
# dg-error regexp comment [{ target/xfail selector } [{.|0|linenum}]] # dg-error regexp comment [{ target/xfail selector } [{.|0|linenum}]]
# indicate an error message <regexp> is expected on this line # indicate an error message &lt;regexp&gt; is expected on this line
# (the test fails if it doesn't occur) # (the test fails if it doesn't occur)
# Linenum=0 for general tool messages (eg: -V arg missing). # Linenum=0 for general tool messages (eg: -V arg missing).
# "." means the current line. # "." means the current line.
# #
# dg-warning regexp comment [{ target/xfail selector } [{.|0|linenum}]] # dg-warning regexp comment [{ target/xfail selector } [{.|0|linenum}]]
# indicate a warning message <regexp> is expected on this line # indicate a warning message &lt;regexp&gt; is expected on this line
# (the test fails if it doesn't occur) # (the test fails if it doesn't occur)
# #
# dg-bogus regexp comment [{ target/xfail selector } [{.|0|linenum}]] # dg-bogus regexp comment [{ target/xfail selector } [{.|0|linenum}]]
# indicate a bogus error message <regexp> use to occur here # indicate a bogus error message &lt;regexp&gt; use to occur here
# (the test fails if it does occur) # (the test fails if it does occur)
# #
# dg-build regexp comment [{ target/xfail selector }] # dg-build regexp comment [{ target/xfail selector }]
@ -344,7 +344,7 @@ cat 27_io/objects/char/3_xin.in | a.out
# (this should only be used sparingly and temporarily) # (this should only be used sparingly and temporarily)
# #
# dg-output regexp [{ target selector }] # dg-output regexp [{ target selector }]
# indicate the expected output of the program is <regexp> # indicate the expected output of the program is &lt;regexp&gt;
# (there may be multiple occurrences of this, they are concatenated) # (there may be multiple occurrences of this, they are concatenated)
# #
# dg-final { tcl code } # dg-final { tcl code }
@ -394,11 +394,11 @@ Example 4: Testing for compilation errors on line 41
<p>You can check the status of the build without installing it <p>You can check the status of the build without installing it
using the dejagnu harness, much like the rest of the gcc tools.</p> using the dejagnu harness, much like the rest of the gcc tools.</p>
<p> <pre> make check</pre>
<pre> make check</pre> in the <em>libbuilddir</em> directory.</p> <p>in the <em>libbuilddir</em> directory.</p>
<p>or</p> <p>or</p>
<p><pre> make check-target-libstdc++-v3</pre> in the <pre> make check-target-libstdc++-v3</pre>
<em>gccbuilddir</em> directory.</p> <p>in the <em>gccbuilddir</em> directory.</p>
<p> <p>
These commands are equivalent and will create a 'testsuite' These commands are equivalent and will create a 'testsuite'
@ -476,7 +476,7 @@ make check-target-libstdc++-v3 RUNTESTFLAGS="--target_board=arm-sim"
<p> In addition, there are some testing options that are mostly of <p> In addition, there are some testing options that are mostly of
interest to library maintainers and system integrators. As such, interest to library maintainers and system integrators. As such,
these tests may not work on all cpu and host combinations, and must these tests may not work on all cpu and host combinations, and must
be executed in the <em>libbuilddir</em> directory.</p> These options be executed in the <em>libbuilddir</em> directory. These options
include, but are not necessarily limited to, the following: include, but are not necessarily limited to, the following:
</p> </p>
@ -530,25 +530,38 @@ Diffing of expected output to standard streams needs to be finished off.
<p> <p>
The V3 testing framework supports, or will eventually support, The V3 testing framework supports, or will eventually support,
additional keywords for the purpose of easing the job of writing additional keywords for the purpose of easing the job of writing
test cases. All V3-keywords are of the form @xxx@. Currently plans test cases. All V3-keywords are of the form <code>@xxx@</code>.
for supported keywords include: Currently plans for supported keywords include:
</p> </p>
@require@ <files> <dl>
The existence of <files> is essential for the test to complete <dt> <code> @require@ &lt;files&gt; </code> </dt>
<dd>
<p>
The existence of &lt;files&gt; is essential for the test to complete
successfully. For example, a test case foo.C using bar.baz as successfully. For example, a test case foo.C using bar.baz as
input file could say input file could say
// @require@ bar.baz </p>
<pre>
// @require@ bar.baz</pre>
<p>
The special variable % stands for the rootname, e.g. the The special variable % stands for the rootname, e.g. the
file-name without its `.C' extension. Example of use (taken file-name without its `.C' extension. Example of use (taken
verbatim from 27_io/filebuf.cc) verbatim from 27_io/filebuf.cc)
// @require@ %-*.tst %-*.txt </p>
<pre>
@diff@ <first-list> <second-list> // @require@ %-*.tst %-*.txt</pre>
</dd>
<dt> <code> @diff@ &lt;first-list&gt; &lt;second-list&gt; </code> </dt>
<dd>
<p>
After the test case compiles and ran successfully, diff After the test case compiles and ran successfully, diff
<first-list> against <second-list>, these lists should have the &lt;first-list&gt; against &lt;second-list&gt;, these lists should
same length. The test fails if diff returns non-zero a pair of have the same length. The test fails if diff returns non-zero a
files. pair of files.
</p>
</dd>
</dl>
<!-- ####################################################### --> <!-- ####################################################### -->