OSDN Git Service

2010-03-16 Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE>
authorjanis <janis@138bc75d-0d04-0410-961f-82ee72b054a4>
Tue, 16 Mar 2010 17:17:33 +0000 (17:17 +0000)
committerMasaki Muranaka <monaka@monami-software.com>
Sun, 23 May 2010 05:12:54 +0000 (14:12 +0900)
* doc/sourcebuild.texi (Testsuites): Fix markup.
Use pathnames relative to gcc/testsuite.
(Test Directives): Move description of how timeout is determined.
(Ada Tests): Favor gnat.exp over ada/acats/tests/gcc.
(C Tests): Correct gcc.misc-tests directory.
Framework tests now live in gcc.test-framework.

git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@157491 138bc75d-0d04-0410-961f-82ee72b054a4

gcc/ChangeLog
gcc/doc/sourcebuild.texi

index a188363..37be82f 100644 (file)
@@ -1,3 +1,12 @@
+2010-03-16  Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE>
+
+       * doc/sourcebuild.texi (Testsuites): Fix markup.
+       Use pathnames relative to gcc/testsuite.
+       (Test Directives): Move description of how timeout is determined.
+       (Ada Tests): Favor gnat.exp over ada/acats/tests/gcc.
+       (C Tests): Correct gcc.misc-tests directory.
+       Framework tests now live in gcc.test-framework.
+
 2010-03-16  Richard Guenther  <rguenther@suse.de>
 
        PR middle-end/43379
index 14397b7..613d402 100644 (file)
@@ -960,8 +960,21 @@ directives local to GCC sometimes override information used by the
 DejaGnu directives, which know nothing about the GCC directives, so the
 DejaGnu directives must precede GCC directives.
 
-Several test directives include selectors (@pxref{Selectors, , })
-which are usually preceded by the keyword @code{target} or @code{xfail}.
+Several test directives include selectors which are usually preceded by
+the keyword @code{target} or @code{xfail}.  A selector is: one or more
+target triplets, possibly including wildcard characters; a single
+effective-target keyword; or a logical expression.  Depending on the
+context, the selector specifies whether a test is skipped and reported
+as unsupported or is expected to fail.  Use @samp{*-*-*} to match any
+target.
+Effective-target keywords are defined in @file{lib/target-supports.exp} in
+the GCC testsuite.
+
+A selector expression appears within curly braces and uses a single
+logical operator: one of @samp{!}, @samp{&&}, or @samp{||}.  An
+operand is another selector expression, an effective-target keyword,
+a single target triplet, or a list of target triplets within quotes or
+curly braces.  For example:
 
 @subsubsection Specify how to build the test
 
@@ -1015,10 +1028,10 @@ all @code{dg-options} directives.
 For supported values of @var{feature} see @ref{Add Options, ,}.
 @end table
 
-@subsubsection Modify the test timeout value
-
-The normal timeout limit, in seconds, is found by searching the
-following in order:
+@item @{ dg-timeout @var{n} [@{target @var{selector} @}] @}
+Set the time limit for the compilation and for the execution of the test
+to the specified number of seconds.  The normal timeout limit, in
+seconds, is found by searching the following in order:
 
 @itemize @bullet
 @item the value defined by an earlier @code{dg-timeout} directive in
@@ -1031,19 +1044,10 @@ the test
 @item 300
 @end itemize
 
-@table @code
-@item @{ dg-timeout @var{n} [@{target @var{selector} @}] @}
-Set the time limit for the compilation and for the execution of the test
-to the specified number of seconds.
-
 @item @{ dg-timeout-factor @var{x} [@{ target @var{selector} @}] @}
 Multiply the normal time limit for compilation and execution of the test
 by the specified floating-point factor.
-@end table
 
-@subsubsection Skip a test for some targets
-
-@table @code
 @item @{ dg-skip-if @var{comment} @{ @var{selector} @} [@{ @var{include-opts} @} [@{ @var{exclude-opts} @}]] @}
 Arguments @var{include-opts} and @var{exclude-opts} are lists in which
 each element is a string of zero or more GCC options.
@@ -1094,15 +1098,17 @@ but not if @code{-fpic} is also present:
 /* @{ dg-skip-if "" @{ *-*-* @}  @{ "-O2 -g" "-O3 -g" @} @{ "-fpic" @} @} */
 @end smallexample
 
-@item @{ dg-require-effective-target @var{keyword} @}
-Skip the test if the test target, including current multilib flags,
-is not covered by the effective-target keyword.
-This directive must appear after any @code{dg-do} directive in the test
-and before any @code{dg-additional-sources} directive.
-@xref{Effective-Target Keywords, , }.
+@item  @{ dg-xfail-if @var{comment} @{ @var{selector} @} [@{ @var{include-opts} @} [@{ @var{exclude-opts} @}]] @}
+Expect the test to fail if the conditions (which are the same as for
+@code{dg-skip-if}) are met.  This does not affect the execute step.
+
+@item  @{ dg-xfail-run-if @var{comment} @{ @var{selector} @} [@{ @var{include-opts} @} [@{ @var{exclude-opts} @}]] @}
+Expect the execute step of a test to fail if the conditions (which are
+the same as for @code{dg-skip-if} and @code{dg-xfail-if}) are met.
 
 @item @{ dg-require-@var{support} args @}
-Skip the test if the target does not provide the required support.
+Skip the test if the target does not provide the required support;
+see @file{lib/gcc-dg.exp} in the GCC testsuite for the actual directives.
 These directives must appear after any @code{dg-do} directive in the test
 and before any @code{dg-additional-sources} directive.
 They require at least one argument, which can be an empty string if the