From: Ben Elliston <bje@gnu.org>
Date: Sun, 13 Mar 2016 00:29:14 +0000 (+1100)
Subject: 	* lib/dg.exp: Improve top-of-file documentation.
X-Git-Tag: upstream/1.6.2~151
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=2c352b2731a9eaa106cd8719a5be35c99b84ac28;p=platform%2Fupstream%2Fdejagnu.git

	* lib/dg.exp: Improve top-of-file documentation.
---

diff --git a/ChangeLog b/ChangeLog
index b7f6696..0374edd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2016-03-13  Ben Elliston  <bje@gnu.org>
+
+	* lib/dg.exp: Improve top-of-file documentation.
+
 2016-03-05  Yvan Roux  <yvan.roux@linaro.org>
 
 	* lib/remote.exp (remote_exec): Restore original timeout value.
diff --git a/lib/dg.exp b/lib/dg.exp
index b49b260..4894841 100644
--- a/lib/dg.exp
+++ b/lib/dg.exp
@@ -39,15 +39,15 @@
 # dg-do do-what-keyword [{ target/xfail selector }]
 #	`do-what-keyword' is tool specific and is passed unchanged to
 #	${tool}-dg-test.  An example is gcc where `keyword' can be any of:
-#	preprocess|compile|assemble|link|run
+#	preprocess | compile | assemble | link | run
 #	and will do one of: produce a .i, produce a .s, produce a .o,
 #	produce an a.out, or produce an a.out and run it (the default is
-#	compile).
+#	'compile').
 #
 # dg-error regexp comment [{ target/xfail selector } [{.|0|linenum}]]
 #	indicate an error message <regexp> is expected on this line
 #	(the test fails if it doesn't occur)
-#	Linenum=0 for general tool messages (eg: -V arg missing).
+#	linenum=0 for general tool messages (eg: -V arg missing).
 #	"." means the current line.
 #
 # dg-warning regexp comment [{ target/xfail selector } [{.|0|linenum}]]
@@ -72,8 +72,8 @@
 #	indicate the expected output of the program is <regexp>
 #	(there may be multiple occurrences of this, they are concatenated)
 #
-# dg-final { tcl code }
-#	add some tcl code to be run at the end
+# dg-final { tcl script }
+#	add some Tcl script to be run at the end
 #	(there may be multiple occurrences of this, they are concatenated)
 #	(unbalanced braces must be \-escaped)
 #
@@ -96,9 +96,8 @@
 #       [ ... some complicated code ... ]
 #	return a; /* { dg-build "fatal" "ran out of spill regs" { xfail i386-*-* } } */
 #
-# In this example, the compiler use to crash on the "return a;" for some
-# target and that it still does crash on i386-*-*.  Admittedly, this is a
-# contrived example.
+# In this contrived example, the compiler used to crash on the "return
+# a;" for some target and it still does crash on i386-*-*.
 #
 # ??? It might be possible to add additional optional arguments by having
 # something like: { dg-error ".*syntax.*" "syntax error" { { foo 1 } ... } }