[Gzz-commits] gzz/doc/pegboard/bug_test--tjl peg.rst

[Tuomas J. Lukka]

CVSROOT:        /cvsroot/gzz
Module name:    gzz
Changes by:     Tuomas J. Lukka <address@hidden>        02/11/19 12:26:53

Modified files:
        doc/pegboard/bug_test--tjl: peg.rst 

Log message:
        Update

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/gzz/doc/pegboard/bug_test--tjl/peg.rst.diff?tr1=1.1&tr2=1.2&r1=text&r2=text

Patches:
Index: gzz/doc/pegboard/bug_test--tjl/peg.rst
diff -u gzz/doc/pegboard/bug_test--tjl/peg.rst:1.1 
gzz/doc/pegboard/bug_test--tjl/peg.rst:1.2
--- gzz/doc/pegboard/bug_test--tjl/peg.rst:1.1  Sun Nov 17 06:04:52 2002
+++ gzz/doc/pegboard/bug_test--tjl/peg.rst      Tue Nov 19 12:26:53 2002
@@ -3,8 +3,8 @@
 =============================================================
 
 :Author:   Tuomas Lukka
-:Last-Modified: $Date: 2002/11/17 11:04:52 $
-:Revision: $Revision: 1.1 $
+:Last-Modified: $Date: 2002/11/19 17:26:53 $
+:Revision: $Revision: 1.2 $
 :Status:   Incomplete
 
 Making failing tests for bugs is not currently handled very
@@ -15,7 +15,13 @@
 
     * Should we use the test name or the docstring for tagging?
 
+        RESOLVED: Docstring. This gives us easier extensibility
+       and avoids the "breaking of test after it passes" 
+       problem this PEG is meant to prevent.
+
     * What conventions should there be for encoding the failing of tests?
+       
+       RESOLVED: A bit like rfc822. Extensibility.
 
     * Should we be able to tag separately tests failing in AWT,
       tests failing in GL and both?
@@ -40,14 +46,22 @@
        and can lead to mistakes when moving tests (e.g. the framework).
 
 The proposal is that we encode whether a given test is failing into
-the test name.
+the test docstring.
 
 For example, ::
 
     def testFoo(): # run test always
+       """Test that foo does X correctly.
+       """
        pass
 
-    def testBar__failAWT(): # this test is known to fail on AWT.
+    def testBar(): # this test is known to fail on AWT.
+       """Test that bar does Y in the right way, 
+       if gloob is bree.
+
+       fail: AWT
+       """
+
        pass
 
 Then, the Makefile targets should be adjusted as follows::