Commit 500cdcb0 by Janis Johnson Committed by Janis Johnson

gccint.texi (menu): Add Testsuites as a chapter.

	* doc/gccint.texi (menu): Add Testsuites as a chapter.
	* doc/sourcebuild.texi (Testsuites): Move up a level to be a
	new chapter.
	(Test Idioms, Test Directives, Ada Tests, C Tests, libgcj Tests,
	LTO Testing, gcov Testing, profopt Testing, compat Testing,
	Torture Tests): Change from subsection to section.

From-SVN: r157167
parent 38f86aba
2010-03-02 Janis Johnson <janis187@us.ibm.com>
* doc/gccint.texi (menu): Add Testsuites as a chapter.
* doc/sourcebuild.texi (Testsuites): Move up a level to be a
new chapter.
(Test Idioms, Test Directives, Ada Tests, C Tests, libgcj Tests,
LTO Testing, gcov Testing, profopt Testing, compat Testing,
Torture Tests): Change from subsection to section.
2010-03-02 Jakub Jelinek <jakub@redhat.com> 2010-03-02 Jakub Jelinek <jakub@redhat.com>
Steven Bosscher <steven@gcc.gnu.org> Steven Bosscher <steven@gcc.gnu.org>
......
...@@ -106,6 +106,7 @@ Additional tutorial information is linked to from ...@@ -106,6 +106,7 @@ Additional tutorial information is linked to from
* Libgcc:: Low-level runtime library used by GCC. * Libgcc:: Low-level runtime library used by GCC.
* Languages:: Languages for which GCC front ends are written. * Languages:: Languages for which GCC front ends are written.
* Source Tree:: GCC source tree structure and build system. * Source Tree:: GCC source tree structure and build system.
* Testsuites:: GCC testsuites.
* Options:: Option specification files. * Options:: Option specification files.
* Passes:: Order of passes, what they do, and what each file is for. * Passes:: Order of passes, what they do, and what each file is for.
* Trees:: The source representation used by the C and C++ front ends. * Trees:: The source representation used by the C and C++ front ends.
......
...@@ -15,7 +15,6 @@ which it is presumed that you are familiar. ...@@ -15,7 +15,6 @@ which it is presumed that you are familiar.
* Configure Terms:: Configuration terminology and history. * Configure Terms:: Configuration terminology and history.
* Top Level:: The top level source directory. * Top Level:: The top level source directory.
* gcc Directory:: The @file{gcc} subdirectory. * gcc Directory:: The @file{gcc} subdirectory.
* Testsuites:: The GCC testsuites.
@end menu @end menu
@include configterms.texi @include configterms.texi
...@@ -813,7 +812,7 @@ a maintainer when support is added. ...@@ -813,7 +812,7 @@ a maintainer when support is added.
@end itemize @end itemize
@node Testsuites @node Testsuites
@section Testsuites @chapter Testsuites
GCC contains several testsuites to help maintain compiler quality. GCC contains several testsuites to help maintain compiler quality.
Most of the runtime libraries and language front ends in GCC have Most of the runtime libraries and language front ends in GCC have
...@@ -834,7 +833,7 @@ here; FIXME: document the others. ...@@ -834,7 +833,7 @@ here; FIXME: document the others.
@end menu @end menu
@node Test Idioms @node Test Idioms
@subsection Idioms Used in Testsuite Code @section Idioms Used in Testsuite Code
In general, C testcases have a trailing @file{-@var{n}.c}, starting In general, C testcases have a trailing @file{-@var{n}.c}, starting
with @file{-1.c}, in case other testcases with similar names are added with @file{-1.c}, in case other testcases with similar names are added
...@@ -913,7 +912,7 @@ unfortunately, the mechanisms for this differ by directory. ...@@ -913,7 +912,7 @@ unfortunately, the mechanisms for this differ by directory.
FIXME: discuss non-C testsuites here. FIXME: discuss non-C testsuites here.
@node Test Directives @node Test Directives
@subsection Directives used within DejaGnu tests @section Directives used within DejaGnu tests
Test directives appear within comments in a test source file and begin Test directives appear within comments in a test source file and begin
with @code{dg-}. Some of these are defined within DejaGnu and others with @code{dg-}. Some of these are defined within DejaGnu and others
...@@ -1236,7 +1235,7 @@ Check branch and/or call counts, in addition to line counts, in ...@@ -1236,7 +1235,7 @@ Check branch and/or call counts, in addition to line counts, in
@end table @end table
@node Ada Tests @node Ada Tests
@subsection Ada Language Testsuites @section Ada Language Testsuites
The Ada testsuite includes executable tests from the ACATS 2.5 The Ada testsuite includes executable tests from the ACATS 2.5
testsuite, publicly available at testsuite, publicly available at
...@@ -1271,7 +1270,7 @@ These tests are run using the build tree: they can be run without doing ...@@ -1271,7 +1270,7 @@ These tests are run using the build tree: they can be run without doing
a @code{make install}. a @code{make install}.
@node C Tests @node C Tests
@subsection C Language Testsuites @section C Language Testsuites
GCC contains the following C language testsuites, in the GCC contains the following C language testsuites, in the
@file{gcc/testsuite} directory: @file{gcc/testsuite} directory:
...@@ -1369,7 +1368,7 @@ FIXME: merge in @file{testsuite/README.gcc} and discuss the format of ...@@ -1369,7 +1368,7 @@ FIXME: merge in @file{testsuite/README.gcc} and discuss the format of
test cases and magic comments more. test cases and magic comments more.
@node libgcj Tests @node libgcj Tests
@subsection The Java library testsuites. @section The Java library testsuites.
Runtime tests are executed via @samp{make check} in the Runtime tests are executed via @samp{make check} in the
@file{@var{target}/libjava/testsuite} directory in the build @file{@var{target}/libjava/testsuite} directory in the build
...@@ -1392,7 +1391,7 @@ bugs in libgcj that had caused Mauve test failures. ...@@ -1392,7 +1391,7 @@ bugs in libgcj that had caused Mauve test failures.
We encourage developers to contribute test cases to Mauve. We encourage developers to contribute test cases to Mauve.
@node LTO Testing @node LTO Testing
@subsection Support for testing link-time optimizations @section Support for testing link-time optimizations
Tests for link-time optimizations usually require multiple source files Tests for link-time optimizations usually require multiple source files
that are compiled separately, perhaps with different sets of options. that are compiled separately, perhaps with different sets of options.
...@@ -1428,7 +1427,7 @@ each of these sets of options. ...@@ -1428,7 +1427,7 @@ each of these sets of options.
@end table @end table
@node gcov Testing @node gcov Testing
@subsection Support for testing @command{gcov} @section Support for testing @command{gcov}
Language-independent support for testing @command{gcov}, and for checking Language-independent support for testing @command{gcov}, and for checking
that branch profiling produces expected values, is provided by the that branch profiling produces expected values, is provided by the
...@@ -1494,7 +1493,7 @@ commands to check branch percentages and call return percentages can ...@@ -1494,7 +1493,7 @@ commands to check branch percentages and call return percentages can
bracket the lines that report them. bracket the lines that report them.
@node profopt Testing @node profopt Testing
@subsection Support for testing profile-directed optimizations @section Support for testing profile-directed optimizations
The file @file{profopt.exp} provides language-independent support for The file @file{profopt.exp} provides language-independent support for
checking correct execution of a test built with profile-directed checking correct execution of a test built with profile-directed
...@@ -1533,7 +1532,7 @@ torture tests ...@@ -1533,7 +1532,7 @@ torture tests
@end table @end table
@node compat Testing @node compat Testing
@subsection Support for testing binary compatibility @section Support for testing binary compatibility
The file @file{compat.exp} provides language-independent support for The file @file{compat.exp} provides language-independent support for
binary compatibility testing. It supports testing interoperability of binary compatibility testing. It supports testing interoperability of
...@@ -1640,7 +1639,7 @@ targets. ...@@ -1640,7 +1639,7 @@ targets.
@end table @end table
@node Torture Tests @node Torture Tests
@subsection Support for torture testing using multiple options @section Support for torture testing using multiple options
Throughout the compiler testsuite there are several directories whose Throughout the compiler testsuite there are several directories whose
tests are run multiple times, each with a different set of options. tests are run multiple times, each with a different set of options.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment