Just want to clarify that I am understanding this correctly, and if so suggest a small change. In the docs for Test::Builder it says:
"These methods are for setting up tests and declaring how many there are. You usually only want to call one of these methods."
Followed immediately by a description for 'exported_to' and then 'plan','expected_tests','no_plan','has_plan',and 'skip_all'.
But it seems you almost always want to call 'exported_to' so that as the doc states "TODO" will work properly, and optionally 1 of the additonal methods rather than "only ... one of these methods." The example in the synopsis shows this as well. If this is the case I would suggest moving the exported_to to a different part, or moving the "only one of these methods" to after its description.
And do I understand correctly that you would only likely use one of the 5 plan methods if you were planning on using the module as the base of your testing rather than as just an extra set of additional test functions? For instance I am writing test scripts for our app which has a home grown exception object, I have used Test::Builder to add a 'check_exception' function to our App::Testing module (not real name). In the actual scripts themselves I still want to use normal Test::More functions so I pass it a plan. The only time I would need to include the a call to the 'plan' methods in my App::Testing is if I didn't include (or better put, didn't want to have to include) a Test::More plan in the script correct?
Still trying to figure all this testing business out, thanks for your help,
http://danconia.org
