From 2eac577f17210ba9b9e3780cee6c6dbefa0298e6 Mon Sep 17 00:00:00 2001 From: Joseph Myers Date: Thu, 1 Jul 2004 23:02:41 +0100 Subject: [PATCH] cppinternals.texi, [...]: Use terminology "testsuite" and "enumerated". * doc/cppinternals.texi, doc/install.texi, doc/invoke.texi, doc/md.texi, doc/sourcebuild.texi, doc/tm.texi, doc/trouble.texi: Use terminology "testsuite" and "enumerated". From-SVN: r84000 --- gcc/ChangeLog | 6 ++++ gcc/doc/cppinternals.texi | 2 +- gcc/doc/install.texi | 4 +-- gcc/doc/invoke.texi | 6 ++-- gcc/doc/md.texi | 2 +- gcc/doc/sourcebuild.texi | 74 +++++++++++++++++++-------------------- gcc/doc/tm.texi | 6 ++-- gcc/doc/trouble.texi | 2 +- 8 files changed, 54 insertions(+), 48 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 90ec4a76367..f8351e59bb7 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,9 @@ +2004-07-01 Joseph S. Myers + + * doc/cppinternals.texi, doc/install.texi, doc/invoke.texi, + doc/md.texi, doc/sourcebuild.texi, doc/tm.texi, doc/trouble.texi: + Use terminology "testsuite" and "enumerated". + 2004-07-01 Richard Henderson * dwarf2out.c (reg_save): Use INVALID_REGNUM. diff --git a/gcc/doc/cppinternals.texi b/gcc/doc/cppinternals.texi index 3f3d9af0051..2b8c5086883 100644 --- a/gcc/doc/cppinternals.texi +++ b/gcc/doc/cppinternals.texi @@ -226,7 +226,7 @@ foo @end smallexample This is a good example of the subtlety of getting token spacing correct -in the preprocessor; there are plenty of tests in the test suite for +in the preprocessor; there are plenty of tests in the testsuite for corner cases like this. The lexer is written to treat each of @samp{\r}, @samp{\n}, @samp{\r\n} diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 3badfa40719..18f1b7b8a92 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -1688,7 +1688,7 @@ might emit some harmless messages resembling @samp{WARNING: Couldn't find the global config file.} or @samp{WARNING: Couldn't find tool init file} that can be ignored. -@section How can I run the test suite on selected tests? +@section How can I run the testsuite on selected tests? In order to run sets of tests selectively, there are targets @samp{make check-gcc} and @samp{make check-g++} @@ -1801,7 +1801,7 @@ specifying the location of that tree when invoking @samp{make}, as in @samp{make MAUVEDIR=~/mauve check}. @uref{http://www-124.ibm.com/developerworks/oss/cvs/jikes/~checkout~/jacks/jacks.html,,Jacks} -is a free test suite that tests Java compiler front ends. This suite +is a free testsuite that tests Java compiler front ends. This suite can be run as part of libgcj testing by placing the Jacks tree within the libjava testsuite at @file{libjava/testsuite/libjava.jacks/jacks}. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index ede70f67a46..4d05a98fd86 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -1718,7 +1718,7 @@ to a plain pointer. @item -Wsign-promo @r{(C++ only)} @opindex Wsign-promo Warn when overload resolution chooses a promotion from unsigned or -enumeral type to a signed type, over a conversion to an unsigned type of +enumerated type to a signed type, over a conversion to an unsigned type of the same size. Previous versions of G++ would try to preserve unsignedness, but the standard mandates the current behavior. @@ -2347,7 +2347,7 @@ exceptions are @samp{main} and functions defined in system headers. @item -Wswitch @opindex Wswitch -Warn whenever a @code{switch} statement has an index of enumeral type +Warn whenever a @code{switch} statement has an index of enumerated type and lacks a @code{case} for one or more of the named codes of that enumeration. (The presence of a @code{default} label prevents this warning.) @code{case} labels outside the enumeration range also @@ -2360,7 +2360,7 @@ case. @item -Wswitch-enum @opindex Wswitch-enum -Warn whenever a @code{switch} statement has an index of enumeral type +Warn whenever a @code{switch} statement has an index of enumerated type and lacks a @code{case} for one or more of the named codes of that enumeration. @code{case} labels outside the enumeration range also provoke warnings when this option is used. diff --git a/gcc/doc/md.texi b/gcc/doc/md.texi index 6b9135f733e..b7ccecef303 100644 --- a/gcc/doc/md.texi +++ b/gcc/doc/md.texi @@ -4877,7 +4877,7 @@ specified for an attribute, the following are defined: A @samp{#define} is written for the symbol @samp{HAVE_ATTR_@var{name}}. @item -An enumeral class is defined for @samp{attr_@var{name}} with +An enumerated class is defined for @samp{attr_@var{name}} with elements of the form @samp{@var{upper-name}_@var{upper-value}} where the attribute name and value are first converted to uppercase. diff --git a/gcc/doc/sourcebuild.texi b/gcc/doc/sourcebuild.texi index 21a7bb9aa5f..400634ba4c5 100644 --- a/gcc/doc/sourcebuild.texi +++ b/gcc/doc/sourcebuild.texi @@ -14,7 +14,7 @@ which it is presumed that you are familiar. * Configure Terms:: Configuration terminology and history. * Top Level:: The top level source directory. * gcc Directory:: The @file{gcc} subdirectory. -* Test Suites:: The GCC test suites. +* Testsuites:: The GCC testsuites. @end menu @include configterms.texi @@ -44,7 +44,7 @@ front end. @item gcc The main sources of GCC itself (except for runtime libraries), including optimizers, support for different target architectures, -language front ends, and test suites. @xref{gcc Directory, , The +language front ends, and testsuites. @xref{gcc Directory, , The @file{gcc} Subdirectory}, for details. @item include @@ -104,7 +104,7 @@ configure, The GNU configure and build system}, for details. The @file{gcc} directory contains many files that are part of the C sources of GCC, other files used as part of the configuration and build process, and subdirectories including documentation and a -test suite. The files that are sources of GCC are documented in a +testsuite. The files that are sources of GCC are documented in a separate chapter. @xref{Passes, , Passes and Files of the Compiler}. @menu @@ -172,8 +172,8 @@ by @samp{make gcc.pot}, and @file{EXCLUDES}, a list of files from which messages should not be extracted. @item testsuite -The GCC test suites (except for those for runtime libraries). -@xref{Test Suites}. +The GCC testsuites (except for those for runtime libraries). +@xref{Testsuites}. @end table @node Configuration @@ -488,9 +488,9 @@ Details of source file suffixes for that language and @option{-x Entries in @code{default_compilers} in @file{gcc.c} for source file suffixes for that language. @item -Preferably test suites, which may be under @file{gcc/testsuite} or +Preferably testsuites, which may be under @file{gcc/testsuite} or runtime library directories. FIXME: document somewhere how to write -test suite harnesses. +testsuite harnesses. @item Probably a runtime library for the language, outside the @file{gcc} directory. FIXME: document this further. @@ -804,26 +804,26 @@ but it would be unusual to add support for a target that does not have a maintainer when support is added. @end itemize -@node Test Suites -@section Test Suites +@node Testsuites +@section Testsuites -GCC contains several test suites to help maintain compiler quality. -Most of the runtime libraries and language front ends in GCC have test -suites. Currently only the C language test suites are documented +GCC contains several testsuites to help maintain compiler quality. +Most of the runtime libraries and language front ends in GCC have +testsuites. Currently only the C language testsuites are documented here; FIXME: document the others. @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. +* Test Idioms:: Idioms used in testsuite code. +* Ada Tests:: The Ada language testsuites. +* C Tests:: The C language testsuites. +* libgcj Tests:: The Java library testsuites. * gcov Testing:: Support for testing gcov. * profopt Testing:: Support for testing profile-directed optimizations. * compat Testing:: Support for testing binary compatibility. @end menu @node Test Idioms -@subsection Idioms Used in Test Suite Code +@subsection Idioms Used in Testsuite Code 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 @@ -841,7 +841,7 @@ been fixed, or whether it may be a regression, but does not give any other information about the bug or where discussion of it may be found. Some other language testsuites follow similar conventions. -In the @file{gcc.dg} test suite, it is often necessary to test that an +In the @file{gcc.dg} testsuite, it is often necessary to test that an error is indeed a hard error and not just a warning---for example, where it is a constraint violation in the C standard, which must become an error with @option{-pedantic-errors}. The following idiom, @@ -899,20 +899,21 @@ All testcases must be portable. Target-specific testcases must have appropriate code to avoid causing failures on unsupported systems; unfortunately, the mechanisms for this differ by directory. -FIXME: discuss non-C test suites here. +FIXME: discuss non-C testsuites here. @node Ada Tests -@subsection Ada Language Test Suites +@subsection Ada Language Testsuites -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} +The Ada testsuite includes executable tests from the ACATS 2.5 +testsuite, publicly available at +@uref{http://www.adaic.org/compilers/acats/2.5} -These tests are integrated in the GCC test suite in the +These tests are integrated in the GCC testsuite 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 +You can also run the Ada testsuite independently, using @code{make check-ada}, or run a subset of the tests by specifying which chapter to run, e.g: @@ -935,9 +936,9 @@ 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 +@subsection C Language Testsuites -GCC contains the following C language test suites, in the +GCC contains the following C language testsuites, in the @file{gcc/testsuite} directory: @table @file @@ -986,7 +987,7 @@ FIXME: describe this. This directory should probably not be used for new tests. @item gcc.c-torture/compile -This test suite contains test cases that should compile, but do not +This testsuite contains test cases that should compile, but do not need to link or run. These test cases are compiled with several different combinations of optimization options. All warnings are disabled for these test cases, so this directory is not suitable if @@ -996,7 +997,7 @@ platforms, by the use of @file{.x} files, mostly these test cases should not contain platform dependencies. FIXME: discuss how defines such as @code{NO_LABEL_VALUES} and @code{STACK_SIZE} are used. @item gcc.c-torture/execute -This test suite contains test cases that should compile, link and run; +This testsuite contains test cases that should compile, link and run; otherwise the same comments as for @file{gcc.c-torture/compile} apply. @item gcc.c-torture/execute/ieee This contains tests which are specific to IEEE floating point. @@ -1033,14 +1034,14 @@ FIXME: merge in @file{testsuite/README.gcc} and discuss the format of test cases and magic comments more. @node libgcj Tests -@subsection The Java library test suites. +@subsection The Java library testsuites. Runtime tests are executed via @samp{make check} in the @file{@var{target}/libjava/testsuite} directory in the build tree. Additional runtime tests can be checked into this testsuite. Regression testing of the core packages in libgcj is also covered by the -Mauve test suite. The @uref{http://sources.redhat.com/mauve/,,Mauve Project} +Mauve testsuite. The @uref{http://sources.redhat.com/mauve/,,Mauve Project} develops tests for the Java Class Libraries. These tests are run as part of libgcj testing by placing the Mauve tree within the libjava testsuite sources at @file{libjava/testsuite/libjava.mauve/mauve}, or by specifying @@ -1054,8 +1055,8 @@ Update this file when adding new failing tests to Mauve, or when fixing bugs in libgcj that had caused Mauve test failures. The @uref{http://oss.software.ibm.com/developerworks/opensource/jacks/,, -Jacks} project provides a test suite for Java compilers that can be used -to test changes that affect the GCJ front end. This test suite is run as +Jacks} project provides a testsuite for Java compilers that can be used +to test changes that affect the GCJ front end. This testsuite is run as part of Java testing by placing the Jacks tree within the the libjava testsuite sources at @file{libjava/testsuite/libjava.jacks/jacks}. @@ -1170,11 +1171,10 @@ torture tests @subsection Support for testing binary compatibility The file @file{compat.exp} provides language-independent support for -binary compatibility testing. It supports testing interoperability -of two compilers that follow the same ABI, or of multiple sets of -compiler options that should not affect binary compatibility. -It is intended to be used for test suites that complement ABI test -suites. +binary compatibility testing. It supports testing interoperability of +two compilers that follow the same ABI, or of multiple sets of +compiler options that should not affect binary compatibility. It is +intended to be used for testsuites that complement ABI testsuites. A test supported by this framework has three parts, each in a separate source file: a main program and two pieces that interact diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index a5455b00baf..b196ac4d854 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -2318,9 +2318,9 @@ single-byte values can be loaded or stored. This is so that @code{PREFERRED_RELOAD_CLASS} can always have a possible value to return. @deftp {Data type} {enum reg_class} -An enumeral type that must be defined with all the register class names -as enumeral values. @code{NO_REGS} must be first. @code{ALL_REGS} -must be the last register class, followed by one more enumeral value, +An enumerated type that must be defined with all the register class names +as enumerated values. @code{NO_REGS} must be first. @code{ALL_REGS} +must be the last register class, followed by one more enumerated value, @code{LIM_REG_CLASSES}, which is not a register class but rather tells how many classes there are. diff --git a/gcc/doc/trouble.texi b/gcc/doc/trouble.texi index b2112d36732..c28f9a21f52 100644 --- a/gcc/doc/trouble.texi +++ b/gcc/doc/trouble.texi @@ -1423,7 +1423,7 @@ an error message for a certain program. ISO C requires a ``diagnostic'' message for certain kinds of invalid programs, but a warning is defined by GCC to count as a diagnostic. If GCC produces a warning but not an error, that is correct ISO C support. -If test suites call this ``failure'', they should be run with the GCC +If testsuites call this ``failure'', they should be run with the GCC option @option{-pedantic-errors}, which will turn these warnings into errors. -- 2.30.2