Re: TAP docs

2005-02-21 Thread Andrew Pimlott
On Mon, Feb 21, 2005 at 08:58:46PM -0600, Andy Lester wrote: > The plan has to exist, whether it's the first or last line. I've added > that to the docs. Ah, that clarifies it. I misunderstood the current situation--I didn't realize that Test::More automatically adds the plan at the bottom when

Re: TAP docs

2005-02-21 Thread Andy Lester
If your tests are numbered then a plan is mandatory. In certain instances a test file may not know how many test points it will ultimately be running. In this case the plan can be the last non-diagnostic line in the output. The plan has to exist, whether it's the first or last line. I've added

Re: TAP docs

2005-02-21 Thread Fergal Daly
On Mon, Feb 21, 2005 at 08:31:43PM -0600, Andy Lester wrote: > >was expected. I propose to fix this by allowing, in place of a plan at > >the beginning, something like the line "ends with plan". > > In effect, finding > > ok 1 > > as the first line means "ends with plan". I think that's

Re: TAP docs

2005-02-21 Thread Andrew Pimlott
On Mon, Feb 21, 2005 at 08:31:43PM -0600, Andy Lester wrote: > >This feature is new to me--and I have to say, it seems nearly useless. > > It's the ages-old argument about the value of the plan. Some people > don't like the plan, and some do. I don't mean the plan is new, only the plan at the e

Re: TAP docs

2005-02-21 Thread Andy Lester
This feature is new to me--and I have to say, it seems nearly useless. It's the ages-old argument about the value of the plan. Some people don't like the plan, and some do. was expected. I propose to fix this by allowing, in place of a plan at the beginning, something like the line "ends with

Re: TAP docs

2005-02-21 Thread Andrew Pimlott
In certain instances a test file may not know how many test points it will ultimately be running. In this case the plan can be the last non-diagnostic line in the output. This feature is new to me--and I have to say, it seems nearly useless. I consider that the primary purpose of a pla

Re: TAP docs

2005-02-21 Thread Michael G Schwern
On Mon, Feb 21, 2005 at 02:42:49PM -, Clayton, Nik wrote: > T::H specific, not relevant to TAP. As T::H is the only complete implementation of TAP and thus is something of a working reference, it is quite relevant to note where it strays from the ideal.

Re: TAP docs

2005-02-21 Thread Andy Lester
On Mon, Feb 21, 2005 at 02:42:49PM -, Clayton, Nik ([EMAIL PROTECTED]) wrote: > 1. qq{will generate > > FAILED tests 1, 3, 6 > Failed 3/6 tests, 50.00% okay} > > That's T::H output. Ok, modified so that it notes that it's T::H output. > 2. qq{Currently Test::Harness does nothing wi

RE: TAP docs

2005-02-21 Thread Clayton, Nik
> I specifically left that out. It's an issue that Test::More deals > with, but doesn't have to. TAP.pod really only deals with > TAP, not the libs that create it. Sort of. 1. qq{will generate FAILED tests 1, 3, 6 Failed 3/6 tests, 50.00% okay} That's T::H output. 2. qq{Currently T

Re: TAP docs

2005-02-21 Thread Andy Lester
tion, including Dejagnu, POSIX and JUnit, drawing analogies between them and TAP. It would help those who are already familiar with other systems to more easily understand TAP. This sounds like a separate document for someone to write for us to include with T::H, but not part of the TAP docs.

Re: TAP docs

2005-02-21 Thread Andy Lester
"Descriptions should not begin with a digit" -- at the moment this generates a warning (in Test::* and libtap). It should probably be documented that this is a non-fatal error. I specifically left that out. It's an issue that Test::More deals with, but doesn't have to. TAP.pod really only dea

Re: TAP docs

2005-02-21 Thread Andy Lester
, however, it doesn't, so the TAP docs are right. xoa -- Andy Lester => [EMAIL PROTECTED] => www.petdance.com => AIM:petdance

Re: TAP docs

2005-02-21 Thread Michael G Schwern
On Mon, Feb 21, 2005 at 12:29:59PM -, Clayton, Nik wrote: > Perhaps a gammar (or just a regex) that describes a fully conforming test > line would be helpful. > > Some comments about POSIX (non-)conformance might be useful, see the DejaGnu > docs for examples; http://www.gnu.org/software/dejag

RE: TAP docs

2005-02-21 Thread Clayton, Nik
> On Sun, Feb 20, 2005 at 10:19:09AM +0100, Johan Vromans wrote: > > http://www.petdance.com/random/tap.html > > > Everyone: I still need more comments. Pete Krawczyk's the only one to > > > provide complaints yet. > > There's no discussion of the exit code of the test process. "Descrip

Re: TAP docs

2005-02-21 Thread Michael G Schwern
On Sun, Feb 20, 2005 at 10:19:09AM +0100, Johan Vromans wrote: > http://www.petdance.com/random/tap.html > > Everyone: I still need more comments. Pete Krawczyk's the only one to > > provide complaints yet. There's no discussion of the exit code of the test process. Acknowledgements sho

Re: TAP docs

2005-02-21 Thread Johan Vromans
Andy Lester <[EMAIL PROTECTED]> writes: http://www.petdance.com/random/tap.html > Everyone: I still need more comments. Pete Krawczyk's the only one to > provide complaints yet. @ Test number 1..6 not ok ok not ok ok ok will generate FAILED tests 1, 3, 6

Re: TAP docs

2005-02-21 Thread Ian Langworth
Under "TESTS AND PLANS: The plan," the first sentence of the third paragraph seems to fit better at the end of the previoius paragraph: This is a safeguard in case your test dies quietly in the middle of its run. It should be the first non-diagnostic line output by your te

Re: TAP docs

2005-02-19 Thread Ian Langworth
Under "TESTS AND PLANS: The plan," the first sentence of the third paragraph seems to fit better at the end of the previoius paragraph: This is a safeguard in case your test dies quietly in the middle of its run. It should be the first non-diagnostic line output by your test

Re: TAP docs

2005-02-19 Thread Andy Lester
On Feb 19, 2005, at 8:53 PM, Jason Gessner wrote: is skip supposed to be case sensitive? is it Skip, skip or SKIP ? Either way. I've updated it. xoa -- Andy Lester => [EMAIL PROTECTED] => www.petdance.com => AIM:petdance

Re: TAP docs

2005-02-19 Thread chromatic
On Sat, 2005-02-19 at 20:53 -0600, Jason Gessner wrote: > is skip supposed to be case sensitive? is it Skip, skip or SKIP ? > > TODO seems to be all caps. T::H doesn't really care, but the documentation could be a little stricter than the practice. Aside from that, I also noticed lots of passi

Re: TAP docs

2005-02-19 Thread Andy Lester
On Feb 19, 2005, at 8:53 PM, Jason Gessner wrote: is skip supposed to be case sensitive? is it Skip, skip or SKIP ? Both TODO and SKIP are case-insensitive. I've updated to make that explicit. xoa -- Andy Lester => [EMAIL PROTECTED] => www.petdance.com => AIM:petdance

Re: TAP docs

2005-02-19 Thread Jason Gessner
is skip supposed to be case sensitive? is it Skip, skip or SKIP ? TODO seems to be all caps. -jason gessner [EMAIL PROTECTED] On Feb 19, 2005, at 8:48 PM, Andy Lester wrote: The synopsis uses passive voice; <.> is called TAP. Id turn that around. TAP, the Test Anything Protocol, is ...

Re: TAP docs

2005-02-19 Thread Andy Lester
The synopsis uses passive voice; <.> is called TAP. Id turn that around. TAP, the Test Anything Protocol, is . Fixed, thanks. Everything else reads fine. Id like to see Description replaced by Remarks, but maybe that fish is already fried. Battered, fried, slathered with tartar sauce a

Re: TAP docs

2005-02-19 Thread Jim Cromie
Andy Lester wrote: http://www.petdance.com/random/tap.html Looks good. Thanks for working on this. You're welcome. Everyone: I still need more comments. Pete Krawczyk's the only one to provide complaints yet. The synopsis uses passive voice; <.> is called TAP. Id turn that around.

Re: TAP docs

2005-02-19 Thread Andy Lester
http://www.petdance.com/random/tap.html Looks good. Thanks for working on this. You're welcome. Everyone: I still need more comments. Pete Krawczyk's the only one to provide complaints yet. xoxo, Andy -- Andy Lester => [EMAIL PROTECTED] => www.petdance.com => AIM:petdance

Re: TAP docs

2005-02-19 Thread Andy Lester
On Sat, Feb 19, 2005 at 10:34:06AM -0600, Andy Lester ([EMAIL PROTECTED]) wrote: > Please have a look at my latest/greatest HTMLified version of > Test::Harness::TAP.pod: > > http://www.petdance.com/random/tap.html Also note that it goes with the form: ok 1 Description # Directive #

TAP docs

2005-02-19 Thread Andy Lester
I'm updating the TAP docs in Test::Harness, so that I can update Test::Harness and get it into bleadperl so that (I hope) it makes it into Perl 5.8.7. Please have a look at my latest/greatest HTMLified version of Test::Harness::TAP.pod: http://www.petdance.com/random/tap.html Get