From 4ef84575dff847b54b2aa82224b507319f78e3db Mon Sep 17 00:00:00 2001 From: Joseph Myers Date: Thu, 5 Feb 2004 11:21:33 +0000 Subject: [PATCH] sourcebuild.texi (Test Idioms): Update testcase naming conventions. * sourcebuild.texi (Test Idioms): Update testcase naming conventions. From-SVN: r77306 --- gcc/ChangeLog | 5 +++++ gcc/doc/sourcebuild.texi | 22 +++++++++++++++------- 2 files changed, 20 insertions(+), 7 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 79977d1..f769f9f 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2004-02-05 Joseph S. Myers + + * sourcebuild.texi (Test Idioms): Update testcase naming + conventions. + 2004-02-04 Per Bothner Partially revert/redo 2003-10-01 change; fix -fworking-directory. diff --git a/gcc/doc/sourcebuild.texi b/gcc/doc/sourcebuild.texi index d21e863..8d08827 100644 --- a/gcc/doc/sourcebuild.texi +++ b/gcc/doc/sourcebuild.texi @@ -788,13 +788,21 @@ here; FIXME: document the others. @node Test Idioms @subsection Idioms Used in Test Suite Code -In the @file{gcc.c-torture} test suites, test cases are commonly named -after the date on which they were added. This allows people to tell -at a glance whether a test failure is because of a recently found bug -that has not yet been fixed, or whether it may be a regression. In -other test suites, more descriptive names are used. In general C test -cases have a trailing @file{-@var{n}.c}, starting with @file{-1.c}, in -case other test cases with similar names are added later. +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 +later. If the test is a test of some well-defined feature, it should +have a name referring to that feature such as +@file{@var{feature}-1.c}. If it does not test a well-defined feature +but just happens to exercise a bug somewhere in the compiler, and a +bug report has been filed for this bug in the GCC bug database, +@file{pr@var{bug-number}-1.c} is the appropriate form of name. +Otherwise (for miscellaneous bugs not filed in the GCC bug database), +and previously more generally, test cases are named after the date on +which they were added. This allows people to tell at a glance whether +a test failure is because of a recently found bug that has not yet +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. Test cases should use @code{abort ()} to indicate failure and @code{exit (0)} for success; on some targets these may be redefined to -- 2.7.4