From: Tom Cloyd <tomcloyd@...>
Date: 2009-07-15T14:33:30+09:00
Subject: Re: rdoc run-time length question

Justin Collins wrote:
> 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
>
>
I don't understand - processing involves doubling the time and files. 
This quickly becomes a monster. Why? Am I running this thing wrong? I 
don't see anything in the documentation about this (from "rdoc -h"). I'm 
wondering what I don't know here.

t.

-- 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Tom Cloyd, MS MA, LMHC - Private practice Psychotherapist
Bellingham, Washington, U.S.A: (360) 920-1226
<< tc@tomcloyd.com >> (email)
<< TomCloyd.com >> (website) 
<< sleightmind.wordpress.com >> (mental health weblog)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~