From: Daniel Santos <dansan@gcc.gnu.org>
Date: Tue, 22 Aug 2017 18:52:10 +0000 (+0000)
Subject: docs: Explain how to use multiple file-name patterns in RUNTESTFLAGS
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=d35bcdd42ccc6f18d9da132365061f05c57e8d93;p=gcc.git

docs: Explain how to use multiple file-name patterns in RUNTESTFLAGS

	* doc/install.texi: Modify to add more details on running
	selected tests.

From-SVN: r251289
---

diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index 7c9e2f25d44..da360da1c50 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -2737,6 +2737,16 @@ the testsuite with filenames matching @samp{9805*}, you would use
 make check-g++ RUNTESTFLAGS="old-deja.exp=9805* @var{other-options}"
 @end smallexample
 
+The file-matching expression following @var{filename}@command{.exp=} is treated
+as a series of whitespace-delimited glob expressions so that multiple patterns
+may be passed, although any whitespace must either be escaped or surrounded by
+single quotes if multiple expressions are desired. For example,
+
+@smallexample
+make check-g++ RUNTESTFLAGS="old-deja.exp=9805*\ virtual2.c @var{other-options}"
+make check-g++ RUNTESTFLAGS="'old-deja.exp=9805* virtual2.c' @var{other-options}"
+@end smallexample
+
 The @file{*.exp} files are located in the testsuite directories of the GCC
 source, the most important ones being @file{compile.exp},
 @file{execute.exp}, @file{dg.exp} and @file{old-deja.exp}.