Class: RDoc::RI::Task
Relationships & Source Files | |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
::RDoc::Task,
Rake::TaskLib
|
|
Instance Chain:
self,
::RDoc::Task,
Rake::TaskLib
|
|
Inherits: |
RDoc::Task
|
Defined in: | lib/rdoc/ri/task.rb |
Overview
Task
creates ri data in ./.rdoc
for your project.
It contains the following tasks:
- ri
-
Build ri data
- clobber_ri
-
Delete ri data files. This target is automatically added to the main clobber target.
- reri
-
Rebuild the ri data from scratch even if they are not out of date.
Simple example:
require 'rdoc/ri/task'
RDoc::RI::Task.new do |ri|
ri.main = 'README.rdoc'
ri.rdoc_files.include 'README.rdoc', 'lib/**/*.rb'
end
For further configuration details see ::RDoc::Task.
Class Method Summary
-
.new(name = DEFAULT_NAMES) ⇒ Task
constructor
Create an ri task with the given name.
::RDoc::Task - Inherited
.new | Create an ::RDoc::RDoc task with the given name. |
Instance Attribute Summary
::RDoc::Task - Inherited
#external | Whether to run the rdoc process as an external shell (default is false). |
#generator | Name of format generator (<tt>–format<tt>) used by rdoc. |
#main | Name of file to be used as the main, top level file of the ::RDoc::RDoc. |
#markup | ::RDoc::Comment markup format. |
#name | Name of the main, top level task. |
#options | Additional list of options to be passed rdoc. |
#rdoc_dir | Name of directory to receive the html output files. |
#rdoc_files | List of files to be included in the rdoc generation. |
#template | Name of template to be used by rdoc. |
#title | Title of ::RDoc::RDoc documentation. |
Instance Method Summary
-
#defaults
Sets default task values.
::RDoc::Task - Inherited
#before_running_rdoc | The block passed to this method will be called just before running the ::RDoc::RDoc generator. |
#check_names | Ensures that |
#clobber_task_description |
|
#defaults | Sets default task values. |
#define | Create the tasks defined by this task lib. |
#option_list | List of options that will be supplied to ::RDoc::RDoc. |
#rdoc_task_description |
|
#rerdoc_task_description |
|
#clobber_task_name, #rdoc_target, #rdoc_task_name, #rerdoc_task_name |
Constructor Details
.new(name = DEFAULT_NAMES) ⇒ Task
Create an ri task with the given name. See ::RDoc::Task for documentation on setting names.
# File 'lib/rdoc/ri/task.rb', line 48
def initialize name = DEFAULT_NAMES # :yield: self super end
Instance Method Details
#defaults
Sets default task values
# File 'lib/rdoc/ri/task.rb', line 59
def defaults super @rdoc_dir = '.rdoc' end