RDoc
{{for|the medical framework|Research Domain Criteria}}
{{more references|date=August 2018}}
{{Infobox Software
| name = RDoc
| screenshot =
| caption =
| author = Dave Thomas
| developer =
| released =
| latest release version = 5.1.0
| latest release date = {{Start date and age|2017|02|24}}
| latest preview version =
| latest preview date =
| operating system = Cross-platform
| platform =
| programming language = Ruby
| genre = embedded documentation generator
| license = GPLv2
| website = {{URL|https://ruby.github.io/rdoc/}}
}}
RDoc, designed by Dave Thomas, is an embedded documentation generator for the Ruby programming language.
It analyzes Ruby source code, generating a structured collection of pages for Ruby objects and methods.
Code comments can be added in a natural style.
RDoc is included as part of the Ruby core distribution. The RDoc software and format are successors to the Ruby Document format (with associated software RD).
RDoc can produce usable documentation even if the target source code does not contain explicit comments as it will still parse the classes, modules, and methods, and list them in the generated API files. RDoc also provides the engine for creating Ruby ri data files, providing access to API information from the command line.
RDoc and ri are currently maintained by Eric Hodel and Ryan Davis.
Syntax
RDoc supports four markup languages, RDoc Markup, Markdown, tomdoc, and rdtool. Its own RDoc Markup is used by default. In RDoc Markup, special directives are enclosed in a pair of colons. For example, to indicate that a method takes arguments called {{code|site}} and {{code|article}}, one can write {{code|:args: site, article}}.{{cite web |title=class RDoc::Markup |url=https://ruby.github.io/rdoc/RDoc/Markup.html |website=rdoc 6.0.4 Documentation}}
See also
{{Portal|Free and open-source software}}
References
{{Reflist}}
External links
{{Ruby programming language}}
Category:Free documentation generators
Category:Free software programmed in Ruby
Category:Software using the GNU General Public License
Category:Cross-platform free software
{{Free-software-stub}}