[Gnash-commit] gnash/doc/C sources.xml [testing-documentation-refactor]

[Ann Barcomb]

CVSROOT:        /sources/gnash
Module name:    gnash
Branch:         testing-documentation-refactor
Changes by:     Ann Barcomb <ann>       06/12/20 12:14:07

Modified files:
        doc/C          : sources.xml 

Log message:
        Sandro made some points about running just some (or just one test).
        These have been incorporated in to the documentation.  Also, I have
        added headings to the verbosity and the 'some tests' sections.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/sources.xml?cvsroot=gnash&only_with_tag=testing-documentation-refactor&r1=1.25.2.4&r2=1.25.2.5

Patches:
Index: sources.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/sources.xml,v
retrieving revision 1.25.2.4
retrieving revision 1.25.2.5
diff -u -b -r1.25.2.4 -r1.25.2.5
--- sources.xml 20 Dec 2006 11:51:05 -0000      1.25.2.4
+++ sources.xml 20 Dec 2006 12:14:07 -0000      1.25.2.5
@@ -1391,6 +1391,8 @@
           </programlisting>
         </para>
 
+        <sect5 id="testing_verbosity">
+          <title>Increasing Verbosity</title>
         <para>
           If you encounter a problem with a test, increasing the
           verbosity may make the issue easier to spot.
@@ -1403,16 +1405,26 @@
             make check RUNTESTFLAGS="-v -a"
           </programlisting>
         </para> 
+        </sect5>
    
+        <sect5 id="running_some_tests">
+          <title>Running Some Tests</title>
         <para>
           It is possible to run just a particular test, or group of tests,
-          by specifying the directory or compiled test file.  For instance,
-          the following runs the 'clip_as_button2-TestRunner' test from
-          the top source directory:
+            by specifying the directory or compiled test file, provided
+            the file <emphasis>testsuite/Dejagnu.swf</emphasis> exists.
+            This file is created when you run the entire testsuite.
+          </para>
+          <para>
+            For instance, the following runs the 'clip_as_button2-TestRunner'
+            test from the top source directory, then runs all the tests
+            in 'movies.all':
           <programlisting>
-            make -C testsuite/samples/clip_as_button2-TestRunner check
+              make testsuite/samples/clip_as_button2-TestRunner check
+              make -C testsuite/movies.all check
           </programlisting>
         </para>
+        </sect5>
    
       </sect4>
       <sect4 id="manually">