From bee119e40de38de7e838f745aab1da612825e995 Mon Sep 17 00:00:00 2001
From: Matthias Maier <tamiko@43-1.org>
Date: Sun, 30 Aug 2015 13:21:02 -0500
Subject: [PATCH] Documentation: Fix typos

---
 doc/developers/testsuite.html | 12 ++++++++----
 doc/news/changes.h            |  4 ++--
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/doc/developers/testsuite.html b/doc/developers/testsuite.html
index ee8b890afc..b86950b14a 100644
--- a/doc/developers/testsuite.html
+++ b/doc/developers/testsuite.html
@@ -527,9 +527,13 @@ category/test.binary.output
     <h3>Tests with multiple comparison files</h3>
     <p>
       Sometimes it is necessary to provide multiple comparison files for a
-      single test. Additional comparison files have the same path as the
-      main comparison file (in this case <code>test.output</code>) followed
-      by a dot and a variant description:
+      single test, for example because you want to test code on multiple
+      platforms that produce different output files that, nonetheless, all
+      should be considered correct. An example would be tests that use the
+      <code>rand()</code> function that is implemented differently on
+      different platforms. Additional comparison files have the same path
+      as the main comparison file (in this case <code>test.output</code>)
+      followed by a dot and a variant description:
 <pre>
 category/test.output
 category/test.output.2
@@ -547,7 +551,7 @@ category/test.output.4
       <ol>
         <li> make the test more robust such that differences can be
           expressed in round-off errors detectable by numdiff.
-        <li> restrict comparison files to specific feature versions
+        <li> restrict comparison files to specific
           <a href="#restrictfeature">versions of an external feature</a>.
       </ol>
     </p>
diff --git a/doc/news/changes.h b/doc/news/changes.h
index b18892bf27..9aabca9a30 100644
--- a/doc/news/changes.h
+++ b/doc/news/changes.h
@@ -39,8 +39,8 @@ inconvenience this causes.
 
 <ol>
 
-  <li> Removed: The testsuite does no longer support compiler constraints
-  of the form <code>".compiler=[NAME]...</code>.
+  <li> Removed: The testsuite no longer supports compiler constraints of
+  the form "<code>.compiler=[NAME]...</code>".
   <br>
   (Matthias Maier, 2015/08/21)
   </li>
-- 
2.39.5