From: Justin Collins <justincollins@...>
Date: 2009-07-15T09:26:50+09:00
Subject: Re: rdoc run-time length question

Tom Cloyd wrote:
> Tom Cloyd wrote:
>> I note that if I don't delete the relevant /docs dir, then each time 
>> I run rdoc on my ruby file it takes longer, and reports the 
>> involvement of ever more files. Can someone explain this behavior? 
>> It's dramatic how much better (quicker) it runs if I delete the doc 
>> dir every time.
>>
>> t.
>>
> A little documentation:
>
> tomc@tomc-desktop:~/Ruby-work/setnet/lib/setnet$ ls
> SN.rb <= a single module, containing 6 classes
> tomc@tomc-desktop:~/Ruby-work/setnet/lib/setnet$ rdoc -N -U
> Parsing sources with 2 thread(s)...
> 100% [ 1/ 1]  SN.rb
>
> Generating Darkfish...
>
> Files:   1
> Classes: 6
> Modules: 1
> Methods: 58
> Elapsed: 7.3s
>
> tomc@tomc-desktop:~/Ruby-work/setnet/lib/setnet$ rdoc -N -U <= 
> immediate rerun, after trivial file change
> Parsing sources with 2 thread(s)...
> 100% [16/16]  doc/index.html
>
> Generating Darkfish...
>
> Files:   16
> Classes: 6
> Modules: 1
> Methods: 58
> Elapsed: 17.4s
> tomc@tomc-desktop:~/Ruby-work/setnet/lib/setnet$
>
> As you can see, the file  count and elapsed time doubles.
>
> tomc@tomc-desktop:~/Ruby-work/setnet/lib/setnet$ rdoc -N -U
> Parsing sources with 2 thread(s)...
> Unrecognized directive 'd' in doc/doc/SN/SetNet_html.html <=?????
> 100% [31/31]  doc/index.html
>
> Generating Darkfish...
>
> Files:   31
> Classes: 6
> Modules: 1
> Methods: 58
> Elapsed: 39.2s
> tomc@tomc-desktop:~/Ruby-work/setnet/lib/setnet$
>
> File count and elapsed time just keeps doubling.
>
> t.
>


It's processing the doc/ directory.

-Justin