Novice question about rdoc

ruby-talk
1

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

2

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.

···

--
Posted via http://www.ruby-forum.com/\.

3

*nod*

or:

task :rdoc => :clobber_docs

···

On Jan 6, 2009, at 11:13 , Brian Candler 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.