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

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.

-- 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~