# Novice question about rdoc

**URL:** <https://www.ruby-forum.com/t/novice-question-about-rdoc/157035>\
**Category:** Ruby\
**Created:** [January 6, 2009, 5:57pm UTC](https://www.ruby-forum.com/t/novice-question-about-rdoc/157035 "2009-01-06T17:57:36Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![LAMBEAU\_Bernard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/l/5fc32e/32.png) [@LAMBEAU\_Bernard](https://www.ruby-forum.com/u/LAMBEAU_Bernard)\
**Post date:** [January 6, 2009, 5:57pm UTC](https://www.ruby-forum.com/t/novice-question-about-rdoc/157035/1 "2009-01-06T17:57:36Z")

</div>

I’ve got a stupid problem with rdoc, and I don’t find any answer on  
the web. Sorry …

Is there an option to force rdoc to generate the html documentation  
each time it is invoked? I use the following task in Rakefile:

desc “Generates documentation”  
Rake::RDocTask.new do |rdoc|  
rdoc.rdoc\_files.include( “README”, “INSTALL”,  
“TODO”, “CHANGELOG”,  
“AUTHORS”, “COPYING”,  
“lib/” )  
rdoc.main = “README”  
rdoc.rdoc\_dir = “doc/html”  
rdoc.title = “Stamina Documentation”  
rdoc.options \<\< “-S” \<\< “-N” \<\< “-p” \<\< “-H”  
end

rake rdoc generates the documentation only the first time. After, it  
does not generate anything unless I remove the doc/html folder.

blambeau

---

<div class="post-metadata">

**Author:** ![LAMBEAU\_Bernard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/l/5fc32e/32.png) [@LAMBEAU\_Bernard](https://www.ruby-forum.com/u/LAMBEAU_Bernard)\
**Post date:** [January 6, 2009, 8:13pm UTC](https://www.ruby-forum.com/t/novice-question-about-rdoc/157035/2 "2009-01-06T20:13:31Z")

</div>

LAMBEAU Bernard wrote:

> rake rdoc generates the documentation only the first time. After, it  
> does not generate anything unless I remove the doc/html folder.

Try: rake rerdoc

# Rebuild the rdoc files from scratch, even if they are not out

# of date.

---

<div class="post-metadata">

**Author:** ![LAMBEAU\_Bernard](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/l/5fc32e/32.png) [@LAMBEAU\_Bernard](https://www.ruby-forum.com/u/LAMBEAU_Bernard)\
**Post date:** [January 7, 2009, 10:52pm UTC](https://www.ruby-forum.com/t/novice-question-about-rdoc/157035/3 "2009-01-07T22:52:04Z")

</div>

On Jan 6, 2009, at 11:13 , Brian C. wrote:

> LAMBEAU Bernard wrote:
> 
> > rake rdoc generates the documentation only the first time. After, it  
> > does not generate anything unless I remove the doc/html folder.
> 
> Try: rake rerdoc
> 
> # Rebuild the rdoc files from scratch, even if they are not out
> 
> # of date.

_nod_

or:

task :rdoc =\> :clobber\_docs