This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
committed: document Ada test suite
- From: Arnaud Charlet <charlet at ACT-Europe dot FR>
- To: gcc-patches at gcc dot gnu dot org
- Date: Mon, 27 Oct 2003 15:56:14 +0100
- Subject: committed: document Ada test suite
As suggested on this list, I have moved the contents of README.ada to
doc/sourcebuild.texi
in gcc:
2003-10-27 Arnaud Charlet <charlet@act-europe.fr>
PR ada/5909:
* doc/sourcebuild.texi: Document Ada test suite.
In gcc/testsuite:
2003-10-27 Arnaud Charlet <charlet@act-europe.fr>
* README.ada: Removed, integrated in ../doc/sourcebuild.texi
Index: doc/sourcebuild.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/sourcebuild.texi,v
retrieving revision 1.32
diff -u -r1.32 sourcebuild.texi
--- doc/sourcebuild.texi 20 Oct 2003 20:58:20 -0000 1.32
+++ doc/sourcebuild.texi 27 Oct 2003 14:50:43 -0000
@@ -778,6 +778,7 @@
@menu
* Test Idioms:: Idioms used in test suite code.
+* Ada Tests:: The Ada language test suites.
* C Tests:: The C language test suites.
* libgcj Tests:: The Java library test suites.
* gcov Testing:: Support for testing gcov.
@@ -859,6 +860,39 @@
unfortunately, the mechanisms for this differ by directory.
FIXME: discuss non-C test suites here.
+
+@node Ada Tests
+@subsection Ada Language Test Suites
+
+The Ada test suite includes executable tests from the ACATS 2.5 test
+suite, publicly available at @uref{http://www.adaic.org/compilers/acats/2.5}
+
+These tests are integrated in the GCC test suite in the
+@file{gcc/testsuite/ada/acats} directory, and
+enabled automatically when running @code{make check}, assuming
+the Ada language has been enabled when configuring GCC.
+
+You can also run the Ada test suite independently, using
+@code{make check-ada}, or run a subset of the tests by specifying which
+chapter to run, e.g:
+
+@smallexample
+$ make check-ada CHAPTERS="c3 c9"
+@end smallexample
+
+The tests are organized by directory, each directory corresponding to
+a chapter of the Ada Reference Manual. So for example, c9 corresponds
+to chapter 9, which deals with tasking features of the language.
+
+There is also an extra chapter called @file{gcc} containing a template for
+creating new executable tests.
+
+The tests are run using two 'sh' scripts: run_acats and run_all.sh
+To run the tests using a simulator or a cross target, see the small
+customization section at the top of run_all.sh
+
+These tests are run using the build tree: they can be run without doing
+a @code{make install}.
@node C Tests
@subsection C Language Test Suites