sourcebuild.texi (Test directives): Clarify options to dg-skip-if.

* doc/sourcebuild.texi (Test directives): Clarify options to
	dg-skip-if.

Co-Authored-By: Daniel Jacobowitz <dan@codesourcery.com>

From-SVN: r157154
This commit is contained in:
Janis Johnson 2010-03-01 23:29:18 +00:00 committed by Janis Johnson
parent 604b384dd4
commit 15e7a617a1
2 changed files with 51 additions and 7 deletions

View File

@ -1,3 +1,9 @@
2010-03-01 Janis Johnson <janis187@us.ibm.com>
Daniel Jacobowitz <dan@codesourcery.com>
* doc/sourcebuild.texi (Test directives): Clarify options to
dg-skip-if.
2010-03-01 Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE> 2010-03-01 Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE>
* configure.ac (gcc_cv_as_cfi_directive) [i?86-*-solaris*]: * configure.ac (gcc_cv_as_cfi_directive) [i?86-*-solaris*]:

View File

@ -1021,14 +1021,52 @@ the test
@end itemize @end itemize
@item @{ dg-skip-if @var{comment} @{ @var{selector} @} @{ @var{include-opts} @} @{ @var{exclude-opts} @} @} @item @{ dg-skip-if @var{comment} @{ @var{selector} @} @{ @var{include-opts} @} @{ @var{exclude-opts} @} @}
Skip the test if the test system is included in @var{selector} and if Arguments @var{include-opts} and @var{exclude-opts} are lists in which
each of the options in @var{include-opts} is in the set of options with each element is a string of zero or more GCC options.
which the test would be compiled and if none of the options in Skip the test if all of the following conditions are met:
@var{exclude-opts} is in the set of options with which the test would be @itemize @bullet
compiled. @item the test system is included in @var{selector}
Use @samp{"*"} for an empty @var{include-opts} list and @samp{""} for @item for at least one of the option strings in @var{include-opts},
an empty @var{exclude-opts} list. every option from that string is in the set of options with which
the test would be compiled; use @samp{"*"} for an @var{include-opts} list
that matches any options
@item for each of the option strings in @var{exclude-opts}, at least one
option from that string is not in the set of options with which the test
would be compiled; use @samp{""} for an empty @var{exclude-opts} list
@end itemize
For example, to skip a test if option @code{-Os} is present:
@smallexample
/* @{ dg-skip-if "" @{ *-*-* @} @{ "-Os" @} @{ "" @} @} */
@end smallexample
To skip a test if both options @code{-O2} and @code{-g} are present:
@smallexample
/* @{ dg-skip-if "" @{ *-*-* @} @{ "-O2 -g" @} @{ "" @} @} */
@end smallexample
To skip a test if either @code{-O2} or @code{-O3} is present:
@smallexample
/* @{ dg-skip-if "" @{ *-*-* @} @{ "-O2" "-O3" @} @{ "" @} @} */
@end smallexample
To skip a test unless option @code{-OS} is present:
@smallexample
/* @{ dg-skip-if "" @{ *-*-* @} @{ "*" @} @{ "-Os" @} @} */
@end smallexample
To skip a test if either @code{-O2} or @code{-O3} is used with @code{-g}
but not if @code{-fpic} is also present:
@smallexample
/* @{ dg-skip-if "" @{ *-*-* @} @{ "-O2 -g" "-O3 -g" @} @{ "-fpic" @} @} */
@end smallexample
@item @{ dg-xfail-if @var{comment} @{ @var{selector} @} @{ @var{include-opts} @} @{ @var{exclude-opts} @} @} @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 Expect the test to fail if the conditions (which are the same as for