| Class | Rake::RDocTask |
| In: |
lib/rake/rdoctask.rb
|
| Parent: | TaskLib |
Create a documentation task that will generate the RDoc files for a project.
The RDocTask will create the following targets:
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.
| external | [RW] | Run the rdoc process as an external shell (default is false) |
| main | [RW] | Name of file to be used as the main, top level file of the RDoc. (default is none) |
| name | [RW] | Name of the main, top level task. (default is :rdoc) |
| options | [RW] | List of options to be passed rdoc. (default is []) |
| rdoc_dir | [RW] | Name of directory to receive the html output files. (default is "html") |
| rdoc_files | [RW] | List of files to be included in the rdoc generation. (default is []) |
| template | [RW] | Name of template to be used by rdoc. (default is ‘html’) |
| title | [RW] | Title of RDoc documentation. (default is none) |