Ruby Document format
||This article includes a list of references, related reading or external links, but its sources remain unclear because it lacks inline citations. (October 2009) (Learn how and when to remove this template message)|
RD is a traditional format. In modern Ruby, developers tend to write documents in RDoc instead of RD.
RD was used for many documentation in the Ruby world. The documentation for Ruby itself was originally written in RD. In 2002, the documentation was re-written in RDoc format. The Japanese version of the Ruby Reference Manual is still written in RD.
RD is easy to read in the raw. It is designed to read or write by hand. But, in most cases, end-users read it after it has been converted into man pages or HTML pages.
Pure RD files usually have the extension
.rd. RD can be embedded in Ruby code.
Sample RD document
This document is syntactically correct RD, which attempts to follow the major conventions on section naming as well.
RD sample - A sample RD document
here.is_a?(Piece::Of::Code) print <<"END" This indented block will not be scanned for formatting codes or directives, and spacing will be preserved. END
Here's some normal text. It includes text that is emphasized, keyboard,
Copyright 2005 J. Random Hacker <firstname.lastname@example.org>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts.
- RDtool - Framework to translate RD document into other formats.
- rd-draft.rd - full description of RD markup languard (in RD format)
- rd-draft.html - full description of RD markup language (converted to HTML)
|This programming-language-related article is a stub. You can help Wikipedia by expanding it.|