Document dg-line directive

2017-05-23  Tom de Vries  <tom@codesourcery.com>

	* doc/sourcebuild.texi (Directives, Verify compiler message): Document
	dg-line directive.

From-SVN: r248376

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 57849a84e233ce0a2ad9bbb3ae686c42d212ff58..a24c3697492a4ca190c6fea60a717336fdd072ae 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2017-05-23  Tom de Vries  <tom@codesourcery.com>
+
+       * doc/sourcebuild.texi (Directives, Verify compiler message): Document
+       dg-line directive.
+
 2017-05-23  Jan Hubicka  <hubicka@ucw.cz>
 
        * cgraphunit.c (symbol_table::process_new_functions): Update.

diff --git a/gcc/doc/sourcebuild.texi b/gcc/doc/sourcebuild.texi
index ab2f8b62b605230aa9f37c609caae983bbcbd667..bb5b6b96158d75834c75cff45032087844ba6b57 100644 (file)
--- a/gcc/doc/sourcebuild.texi
+++ b/gcc/doc/sourcebuild.texi
@@ -1180,6 +1180,18 @@ associated with the bogus message.  It is usually used with @samp{xfail}
 to indicate that the message is a known problem for a particular set of
 targets.
 
+@item @{ dg-line @var{linenumvar} @}
+This DejaGnu directive sets the variable @var{linenumvar} to the line number of
+the source line.  The variable @var{linenumvar} can then be used in subsequent
+@code{dg-error}, @code{dg-warning}, @code{dg-message} and @code{dg-bogus}
+directives.  For example:
+
+@smallexample
+int a;   /* @{ dg-line first_def_a @} */
+float a; /* @{ dg-error "conflicting types of" @} */
+/* @{ dg-message "previous declaration of" "" @{ target *-*-* @} first_def_a @} */
+@end smallexample
+
 @item @{ dg-excess-errors @var{comment} [@{ target/xfail @var{selector} @}] @}
 This DejaGnu directive indicates that the test is expected to fail due
 to compiler messages that are not handled by @samp{dg-error},