docs: Explain how to use multiple file-name patterns in RUNTESTFLAGS
authorDaniel Santos <dansan@gcc.gnu.org>
Tue, 22 Aug 2017 18:52:10 +0000 (18:52 +0000)
committerDaniel Santos <dansan@gcc.gnu.org>
Tue, 22 Aug 2017 18:52:10 +0000 (18:52 +0000)
* doc/install.texi: Modify to add more details on running
selected tests.

From-SVN: r251289

gcc/doc/install.texi

index 7c9e2f25d44c2b93379fa4aa8b18c08a7cc74f3c..da360da1c5053316887eefd280f3a7f7d4cf4535 100644 (file)
@@ -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}.