From dba1308d24d6518301e03fa8308e09d6fc3eb975 Mon Sep 17 00:00:00 2001 From: Tamar Christina Date: Fri, 17 Jul 2020 13:12:46 +0100 Subject: [PATCH] Testuite: Document environment setting directives This document some of the existing DejaGnu directives to modify environment variables before test or compiler invocations. gcc/ChangeLog: * doc/sourcebuild.texi (dg-set-compiler-env-var, dg-set-target-env-var): Document. (cherry picked from commit 7c4491e33d1be16bfb85d448862a8b956d35e4d8) --- gcc/doc/sourcebuild.texi | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/gcc/doc/sourcebuild.texi b/gcc/doc/sourcebuild.texi index 57391775241e..cb2e9e5b8c09 100644 --- a/gcc/doc/sourcebuild.texi +++ b/gcc/doc/sourcebuild.texi @@ -1244,6 +1244,18 @@ This DejaGnu directive compares @var{regexp} to the combined output that the test executable writes to @file{stdout} and @file{stderr}. @end table +@subsubsection Specify environment variables for a test + +@table @code +@item @{ dg-set-compiler-env-var @var{var_name} "@var{var_value}" @} +Specify that the environment variable @var{var_name} needs to be set +to @var{var_value} before invoking the compiler on the test file. + +@item @{ dg-set-target-env-var @var{var_name} "@var{var_value}" @} +Specify that the environment variable @var{var_name} needs to be set +to @var{var_value} before execution of the program created by the test. +@end table + @subsubsection Specify additional files for a test @table @code -- 2.47.2