Document usage of line number 0 in dg-{warning,error,message,bogus} directives

Message ID 1bee29b4-4641-dd50-3780-d4c4746ef0d9@mittosystems.com
State New
Headers show
Series
  • Document usage of line number 0 in dg-{warning,error,message,bogus} directives
Related show

Commit Message

Jozef Lawrynowicz June 6, 2018, 5:32 p.m.
For the dg-{warning,error,message,bogus} directives, a value of 0 for the line
argument can be passed to specify that the message is not associated with any
line. This patch documents that in the Directives section of the
documentation.

Ok for trunk?

Comments

Jeff Law June 11, 2018, 7:25 p.m. | #1
On 06/06/2018 11:32 AM, Jozef Lawrynowicz wrote:
> For the dg-{warning,error,message,bogus} directives, a value of 0 for the line

> 

> argument can be passed to specify that the message is not associated with any

> 

> line. This patch documents that in the Directives section of the

> documentation.

> 

> Ok for trunk?

> 

> 

> 0001-Document-usage-of-line-number-0-in-dg-warning-error-.patch

> 

> 

> From d08160770abef420b6699f6bd2c30a055bd10350 Mon Sep 17 00:00:00 2001

> From: Jozef Lawrynowicz <jozef.l@mittosystems.com>

> Date: Wed, 6 Jun 2018 18:20:56 +0100

> Subject: [PATCH] Document usage of line number 0 in

>  dg-{warning,error,message,bogus} directives

> 

> 2018-06-06  Jozef Lawrynowicz  <jozef.l@mittosystems.com>

> 

> 	* gcc/doc/sourcebuild.texi: Document usage of line number 0 in verify

> 	compiler messages directives.

OK.
jeff

Patch

From d08160770abef420b6699f6bd2c30a055bd10350 Mon Sep 17 00:00:00 2001
From: Jozef Lawrynowicz <jozef.l@mittosystems.com>
Date: Wed, 6 Jun 2018 18:20:56 +0100
Subject: [PATCH] Document usage of line number 0 in
 dg-{warning,error,message,bogus} directives

2018-06-06  Jozef Lawrynowicz  <jozef.l@mittosystems.com>

	* gcc/doc/sourcebuild.texi: Document usage of line number 0 in verify
	compiler messages directives.

---
 gcc/doc/sourcebuild.texi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/gcc/doc/sourcebuild.texi b/gcc/doc/sourcebuild.texi
index 09c0053..d52183d 100644
--- a/gcc/doc/sourcebuild.texi
+++ b/gcc/doc/sourcebuild.texi
@@ -1177,6 +1177,8 @@  conditions (which are the same as for @code{dg-skip-if}) are met.
 @end table
 
 @subsubsection Verify compiler messages
+Where @var{line} is an accepted argument for these commands, a value of @samp{0}
+can be used if there is no line associated with the message.
 
 @table @code
 @item @{ dg-error @var{regexp} [@var{comment} [@{ target/xfail @var{selector} @} [@var{line}] ]] @}
-- 
2.7.4