[Gnash-commit] gnash ChangeLog doc/C/internals.xml

[Ann Barcomb]

CVSROOT:        /sources/gnash
Module name:    gnash
Changes by:     Ann Barcomb <ann>       06/12/12 14:26:31

Modified files:
        .              : ChangeLog 
        doc/C          : internals.xml 

Log message:
        I replaced the existing description of the Dejagnu labels (which listed 
a
        few and said that the author did not know the rest) with a list derived
        from the DejaGnu documentation at 
            http://www.gnu.org/software/dejagnu/manual/x397.html
        
        I also put it in table format to aid clarity.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnash/ChangeLog?cvsroot=gnash&r1=1.1915&r2=1.1916
http://cvs.savannah.gnu.org/viewcvs/gnash/doc/C/internals.xml?cvsroot=gnash&r1=1.42&r2=1.43

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/gnash/gnash/ChangeLog,v
retrieving revision 1.1915
retrieving revision 1.1916
diff -u -b -r1.1915 -r1.1916
--- ChangeLog   11 Dec 2006 22:29:20 -0000      1.1915
+++ ChangeLog   12 Dec 2006 14:26:30 -0000      1.1916
@@ -1,3 +1,8 @@
+2006-12-12 Ann Barcomb <address@hidden>
+
+        * The Dejagnu format--as described in the test section of the
+          Docbook documentation--is now fully explained.
+
 2006-12-11 Sandro Santilli <address@hidden>
 
        * testsuite/movies.all/: ORIGIN merged into README.

Index: doc/C/internals.xml
===================================================================
RCS file: /sources/gnash/gnash/doc/C/internals.xml,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -b -r1.42 -r1.43
--- doc/C/internals.xml 7 Dec 2006 11:57:23 -0000       1.42
+++ doc/C/internals.xml 12 Dec 2006 14:26:30 -0000      1.43
@@ -2222,12 +2222,130 @@
        </para>
 
        <para>
-       Dejagnu form is basically a set of standard labels
-       to use when printing test results. These are:
-       FAILED for failures, PASSED for successes, XFAILED for
-       *expected* failure, XPASSED for unexpected successes.
-       There should be some more (UNTESTED, ...) but I don't know
-       them all currently, so will just omit the rest :)
+        The Dejagnu form uses a standard set of labels when printing test 
+        results.  These are:
+        <informaltable frame="all">
+        <?dbhtml table-width="75%" ?>
+        <tgroup cols="2">
+          <thead>
+            <row>
+              <entry valign="top">
+                <para>Label</para>
+              </entry>
+              <entry valign="top">
+                <para>Meaning</para>
+              </entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry valign="top" align="left">
+                <para>PASS</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>The test succeeded.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top" align="left">
+                <para>FAIL</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>The test failed.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top" align="left">
+                <para>XPASS</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>The test succeeded, but was expected to fail.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top" align="left">
+                <para>XFAIL</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>The test failed, and was expected to fail.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top" align="left">
+                <para>UNRESOLVED</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>The results of the test could not be automatically 
+                      parsed.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top" align="left">
+                <para>UNTESTED</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>This test case is not complete.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top" align="left">
+                <para>UNSUPPORTED</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>The test case relies on a conditional feature which 
+                      is not present in your environment.</para>
+              </entry>
+            </row>
+           </tbody>
+          </tgroup>
+         </informaltable>
+       </para>
+
+        <para>
+        The following labels may also appear:
+        <informaltable frame="all">
+        <?dbhtml table-width="75%" ?>
+        <tgroup cols="2">
+          <thead>
+            <row>
+              <entry valign="top">
+                <para>Label</para>
+              </entry>
+              <entry valign="top">
+                <para>Meaning</para>
+              </entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry valign="top" align="left">
+                <para>ERROR</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>There was a serious error in running the test. </para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top" align="left">
+                <para>WARNING</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>There may have been a problem with running the
+                      test.</para>
+              </entry>
+            </row>
+            <row>
+              <entry valign="top" align="left">
+                <para>NOTE</para>
+              </entry>
+              <entry valign="top" align="left">
+                <para>There was some additional information given about
+                      the test.</para>
+              </entry>
+            </row>
+           </tbody>
+          </tgroup>
+         </informaltable>
        </para>
 
         <sect4 id="generic_test_runner">