From: Gavin Sinclair <gsinclair@...>
Date: 2004-03-12T05:57:43+09:00
Subject: Re: Problems rdoc'ing cvs...

On Friday, March 12, 2004, 4:15:42 AM, Dave wrote:


> On Mar 11, 2004, at 10:46, Hugh Sasse Staff Elec Eng wrote:

>> I have just done
>> cvs update -d
>> both for rdoc and for my ruby cvs directory.   Running rdoc on the
>> results gave:
>>         [...]
>>                     beginmainend.rb:
>>               test_beginendblock.rb: c....
>>                   test_trackback.rb: c....
>>                 test_syndication.rb: c.c
>>
>> RDoc failure in test/rss/test_syndication.rb at or around line 22 
>> column 37

> Hugh:

> I'll look into wht test_syndication breaks RDoc, but in the meantime,
> why are you RDocing the test directories?

Aside: in my own projects, I sometimes RDoc test dirs separately so I
can browse the test coverage.  Examining the source code of someone
else's test cases gives you example usage, and RDoc is a nice source
browser as well as documentation browser!

Cheers,
Gavin