Author: jkeenan
Date: Mon Jun 18 19:30:42 2007
New Revision: 19107

Modified:
   branches/reconfigure/t/configure/126-auto_pack.t
   branches/reconfigure/t/configure/127-auto_format.t
   branches/reconfigure/t/configure/128-auto_isreg.t
   branches/reconfigure/t/configure/130-gen_cpu.t
   branches/reconfigure/t/configure/131-auto_funcptr.t
   branches/reconfigure/t/configure/132-auto_cgoto.t
   branches/reconfigure/t/configure/133-auto_inline.t
   branches/reconfigure/t/configure/134-auto_gc.t
   branches/reconfigure/t/configure/135-auto_memalign.t

Log:
Add comments in POD for= block providing suggestions for testing the
underlying module.


Modified: branches/reconfigure/t/configure/126-auto_pack.t
==============================================================================
--- branches/reconfigure/t/configure/126-auto_pack.t    (original)
+++ branches/reconfigure/t/configure/126-auto_pack.t    Mon Jun 18 19:30:42 2007
@@ -10,6 +10,16 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::auto::pack');
 
+=for hints_for_testing The documentation of the package being tested is
+insufficient; please try to improve it.  Check latest reports of Parrot
+configuration tools testing coverage to see where your time available for
+writing tests is spent.  Try to write tests which will trigger the warnings in
+the package being tested.  They can probably be captured with
+Parrot::IO::Capture::Mini; see t/tools/ for examples of how to use this
+module.
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Modified: branches/reconfigure/t/configure/127-auto_format.t
==============================================================================
--- branches/reconfigure/t/configure/127-auto_format.t  (original)
+++ branches/reconfigure/t/configure/127-auto_format.t  Mon Jun 18 19:30:42 2007
@@ -10,6 +10,15 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::auto::format');
 
+=for hints_for_testing The documentation of the package being tested is
+insufficient; please try to improve it.  Check latest reports of Parrot
+configuration tools testing coverage to see where your time available for
+writing tests is spent.  Try to write tests which will trigger the 'die'
+statements in the package being tested.  They can be caught in 'eval' blocks
+and then the error messages can be examined with Test::More::like().
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Modified: branches/reconfigure/t/configure/128-auto_isreg.t
==============================================================================
--- branches/reconfigure/t/configure/128-auto_isreg.t   (original)
+++ branches/reconfigure/t/configure/128-auto_isreg.t   Mon Jun 18 19:30:42 2007
@@ -10,6 +10,13 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::auto::isreg');
 
+=for hints_for_testing The documentation of the package being tested is
+insufficient; please try to improve it.  Check latest reports of Parrot
+configuration tools testing coverage to see where your time available for
+writing tests is spent.
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Modified: branches/reconfigure/t/configure/130-gen_cpu.t
==============================================================================
--- branches/reconfigure/t/configure/130-gen_cpu.t      (original)
+++ branches/reconfigure/t/configure/130-gen_cpu.t      Mon Jun 18 19:30:42 2007
@@ -10,6 +10,13 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::gen::cpu');
 
+=for hints_for_testing Check latest reports of Parrot configuration tools
+testing coverage to see where your time available for writing tests is spent.
+You will have to determine a way to test a user's response to a prompt. #'
+In the course of writing tests, you should try to resolve RT 43146.
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Modified: branches/reconfigure/t/configure/131-auto_funcptr.t
==============================================================================
--- branches/reconfigure/t/configure/131-auto_funcptr.t (original)
+++ branches/reconfigure/t/configure/131-auto_funcptr.t Mon Jun 18 19:30:42 2007
@@ -10,6 +10,12 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::auto::funcptr');
 
+=for hints_for_testing Check latest reports of Parrot configuration tools
+testing coverage to see where your time available for writing tests is spent.
+Try to cover all branches and conditions.
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Modified: branches/reconfigure/t/configure/132-auto_cgoto.t
==============================================================================
--- branches/reconfigure/t/configure/132-auto_cgoto.t   (original)
+++ branches/reconfigure/t/configure/132-auto_cgoto.t   Mon Jun 18 19:30:42 2007
@@ -10,6 +10,12 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::auto::cgoto');
 
+=for hints_for_testing Check latest reports of Parrot configuration tools
+testing coverage to see where your time available for writing tests is spent.
+Try to cover all branches and conditions.
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Modified: branches/reconfigure/t/configure/133-auto_inline.t
==============================================================================
--- branches/reconfigure/t/configure/133-auto_inline.t  (original)
+++ branches/reconfigure/t/configure/133-auto_inline.t  Mon Jun 18 19:30:42 2007
@@ -10,6 +10,12 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::auto::inline');
 
+=for hints_for_testing Check latest reports of Parrot configuration tools
+testing coverage to see where your time available for writing tests is spent.
+Try to cover all branches and conditions.
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Modified: branches/reconfigure/t/configure/134-auto_gc.t
==============================================================================
--- branches/reconfigure/t/configure/134-auto_gc.t      (original)
+++ branches/reconfigure/t/configure/134-auto_gc.t      Mon Jun 18 19:30:42 2007
@@ -10,6 +10,14 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::auto::gc');
 
+=for hints_for_testing Check latest reports of Parrot configuration tools
+testing coverage to see where your time available for writing tests is spent.
+Try to cover all branches and conditions.  In the course of testing, try to
+determine whether the comment in the for= block in runsteps() should continue
+to reside in the code.
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Modified: branches/reconfigure/t/configure/135-auto_memalign.t
==============================================================================
--- branches/reconfigure/t/configure/135-auto_memalign.t        (original)
+++ branches/reconfigure/t/configure/135-auto_memalign.t        Mon Jun 18 
19:30:42 2007
@@ -10,6 +10,13 @@
 use lib qw( . lib ../lib ../../lib );
 use_ok('config::auto::memalign');
 
+=for hints_for_testing Check latest reports of Parrot configuration tools
+testing coverage to see where your time available for writing tests is spent.
+Try to cover all branches and conditions.  Can you generate cases where the
+'eval's fail?  If so, examine the error message with Test::More::like().
+
+=cut
+
 pass("Completed all tests in $0");
 
 ################### DOCUMENTATION ###################

Reply via email to