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.
This commit is contained in:
Tamar Christina 2020-07-17 13:12:46 +01:00
parent e410cbff5d
commit 7c4491e33d
1 changed files with 12 additions and 0 deletions

View File

@ -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