Create a documentation task that will generate the RDoc files for a project.

The RDocTask will create the following targets:

rdoc
Main task for this RDOC task.
:clobber_rdoc
Delete all the rdoc files. This target is automatically added to the main clobber target.
:rerdoc
Rebuild the rdoc files from scratch, even if they are not out of date.

Simple Example:

  Rake::RDocTask.new do |rd|
    rd.main = "README.rdoc"
    rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
  end

You may wish to give the task a different name, such as if you are generating two sets of documentation. For instance, if you want to have a development set of documentation including private methods:

  Rake::RDocTask.new(:rdoc_dev) do |rd|
    rd.main = "README.doc"
    rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
    rd.options << "--all"
  end

The tasks would then be named :rdoc_dev, :clobber_rdoc_dev, and :rerdoc_dev.

Methods