=== 3.12 / 2011-12-15
* Minor enhancements
* Added DEVELOPERS document which contains an overview of how RDoc works and
how to add new features to RDoc.
* Improved title for HTML output to include --title in the
title element.
* rdoc --pipe now understands --markup.
* RDoc now supports irc-scheme hyperlinks. Issue #83 by trans.
* Bug fixes
* Fix title on HTML output for pages.
* Fixed parsing of non-indented HEREDOC.
* Fixed parsing of %w[] and other % literals. Issue #84 by
Erik Hollensbe
* Fixed arrow replacement in HTML output munging the spaceship operator.
Issue #85 by eclectic923.
* Verbatim sections with ERB that match the ruby code whitelist are no
longer syntax-highlighted. Issue #86 by eclectic923
* Line endings on windows are normalized immediately after reading with
binmode. Issue #87 by Usa Nakamura
* RDoc better understands directives for comments. Comment directives can
now be found anywhere in multi-line comments. Issue #90 by Ryan Davis
* Tidy links to methods show the label again. Issue #88 by Simon Chiang
* RDoc::Parser::C can now find comments directly above
+rb_define_class_under+. Issue #89 by Enrico
* In rdoc, backspace and ansi formatters, labels and notes without bodies
are now shown.
* In rdoc, backspace and ansi formatters, whitespace between label or note
and the colon is now stripped.
=== 3.11 / 2011-10-17
* Bug fixes
* Avoid parsing TAGS files included in gems. Issue #81 by Santiago
Pastorino.
=== 3.10 / 2011-10-08
* Major enhancements
* RDoc HTML output has been improved:
* The search from Володя Колесников's (Vladimir Kolesnikov) Sdoc has been
integrated.
The search index generation is a reusable component through
RDoc::Generator::JsonIndex
* The table of contents is now a separate page and now shows links to
headings and sections inside a page or class.
* Class pages no longer show the namespace and no longer have file info
pages.
* HTML output is HTML 5.
* Static files can be copied into RDoc using --copy-files
* RDoc supports additional documentation formats:
* TomDoc 1.0.0-rc1
* RD format
The default markup can be set via the --markup option.
The format of documentation in a particular file can be specified by the
+:markup:+ directive. If the +:markup:+ directive is in the first comment
it is used as the default for the entire file. For other comments it
overrides the default markup format.
The markup format can be set for rake tasks using RDoc::Task#markup
* RDoc can save and load an options file.
To create an options file that defaults to using TomDoc markup run:
rdoc --markup tomdoc --write-options
This will create a .rdoc_options file. Check it in to your VCS and
package it with your gem. RDoc will automatically load this file and
combine it with the user's options.
Some options are not saved. See RDoc::Options@Saved+Options for full
details.
* Minor enhancements
* RDoc autoloads everything. You only need to require 'rdoc' now.
* HTML headings now have ids matching their titles.
= Hello!
Is rendered as
Hello!
* Labels for classes or methods can be linked-to by adding an @
following the class or method reference. For example,
RDoc::Markup@Links
See RDoc::Markup@Links for further details.
* For HTML output RDoc uses +SomeClass.method_name+ and
+SomeClass#method_name+ for remote methods and attributes and
+::method_name+ and +#method_name+ for local methods.
* RDoc makes an effort to syntax-highlight ruby code in verbatim sections.
See RDoc::Markup@Paragraphs+and+Verbatim
* Added RDoc::TopLevel#text? and RDoc::Parser::Text to indicate a
parsed file contains no ruby constructs.
* Added rdoc-label link scheme which allows bidirectional links.
See RDoc::Markup for details.
* Image paths at HTTPS URLs will now be turned into +![]()
+ tags. Pull
Request #60 by James Mead
* Added RDoc::Comment which encapsulates comment-handling functionality.
* Added RDoc::Markup::PreProcess::post_process to allow arbitrary comment
munging.
* RDoc::RDoc::current is set for the entire RDoc run.
* Split rdoc/markup/inline into individual files for its component classes.
* Moved token stream HTML markup out of RDoc::AnyMethod#markup_code into
RDoc::TokenStream::to_html
* "Top" link in section headers is no longer inside the heading element.
* RDoc avoids printing some warnings unless run with `rdoc --verbose`. For
Rails issue #1646.
* Finishing a paragraph with two or more spaces will result in a line break.
This feature is experimental and may be modified or removed.
* Bug fixes
* Markup defined by RDoc::Markup#add_special inside a is no
longer converted.
* Performance of RDoc::RubyLex has been improved. Ruby Bug #5202 by Ryan
Melton.
* Add US-ASCII magic comments to work with ruby -Ku. Issue #63 by
Travis D. Warlick, Jr.
* Clicking a link in the method description now works. Issue #61 by Alan
Hogan.
* Fixed RDoc::Markup::Parser for CRLF line endings. Issue #67 by Marvin
Gülker.
* Fixed lexing of percent strings like %r{#}. Issue #68 by eclectic923.
* The C parser now understands classes defined with
+rb_struct_define_without_accessor+ (like Range). Pull Request #73 by Dan
Bernier
* Fixed lexing of a b <<-HEREDOC. Issue #75 by John Mair.
* Added LEGAL.rdoc with references to licenses in other files. Issue #78 by
Dmitry Jemerov.
* Block parameters are displayed in Darkfish output again. Issue #76 by
Andrea Singh.
* The method parameter coverage report no longer includes parameter default
values. Issue #77 by Jake Goulding.
* The module for an include is not looked up until parsed all the files are
parsed. Unless your project includes nonexistent modules this avoids
worst-case behavior (O(n!)) of RDoc::Include#module.
=== 3.9.2 / 2011-08-11
* Bug fix
* Loosened TIDYLINK regexp to allow any content in the link section like:
{foo}[rdoc-ref:SomeClass]
* In HTML output headings are capped at again
=== 3.9.1 / 2011-07-31
* Bug fixes
* Fix RDoc::Markup parser for a header followed by a non-text token. Issue
#56 by Adam Tait
* Fix RDoc::Markup::ToHtmlCrossref#gen_url for non-rdoc-ref links.
* Fix bug report URL when rdoc crashes.
=== 3.9 / 2011-07-30
* Minor enhancements
* RDoc::Parser::C now supports :doc: and :nodoc: for class comments
* Added the rdoc-ref: link scheme which links to a named reference.
rdoc-ref: can resolve references to classes, modules, methods,
files, etc. This can be used to create cross-generator named links unlike
the link: scheme which is dependent upon the exact file name.
Issue #53 by Simon Chiang
* Pulled RDoc::CrossReference out of RDoc::Markup::ToHtmlCrossref.
Cross-references can now be created easily for non-HTML formatters.
* Bug fixes
* `ri []` and other special methods now work properly. Issue #52 by
ddebernardy.
* `ri` now has space between class comments from multiple files.
* :stopdoc: no longer creates Object references. Issue #55 by Simon Chiang
* :nodoc: works on class aliases now. Issue #51 by Steven G. Harms
* Remove tokenizer restriction on header lengths for verbatim sections.
Issue #49 by trans
=== 3.8 / 2011-06-29
* Minor enhancements
* RDoc::Parser::C can now discover methods on ENV and ARGF.
* RDoc::Parser::C now knows about rb_cSocket and rb_mDL.
* Bug fixes
* Updating Object in an ri data store with new data now removes methods,
includes, constants and aliases.
=== 3.7 / 2011-06-27
* Minor enhancements
* New directive :category: which allows methods to be grouped into sections
more cleanly. See RDoc::Markup for details.
* Document-class for RDoc::Parser::C now supports Foo::CONST as well as
CONST.
* ri method output is now a comma-separated list when displayed
interactively. Pull Request #39 by Benoit Daloze.
* RDoc::ClassModule#merge now prefers the argument's information over the
receiver's (it now behaves like Hash#merge! instead of a backwards
Hash#merge!).
* RDoc::Markup#convert now accepts an RDoc::Markup::Document instance
* RDoc now owns the code for generating RDoc and ri data when gems install
* Added RDoc::RDoc::reset
* Added RDoc::CodeObject#file_name
* Bug fixes
* ri no longer crashes when attempting to complete a plain [.
* ri data now tracks which file information came from so it can process
removals and changes to:
* Classes and Modules
* Methods
* Attributes
* Includes
* Constants
You will need to rebuild your ri data for it to update properly. Issue
#21 by Sven Riedel
* Signal and SignalException no longer clobber each other
* RDoc::Parser::C no longer creates classes when processing aliases.
* RDoc::Text#strip_stars handles Document-method for methods with =, ! and ?
now.
* RDoc::Parser::C now allows .cpp files to be used with the "in" comment on
rb_define_method. Bug #35 by Hanmac.
* RDoc::Parser::Ruby no longer eats content when =begin/=end documentation
blocks are followed by a documentable item. Issue #41 by mfn.
* RDoc::Markup::Formatter and subclasses now allow an optional +markup+
parameter for adding custom markup. The example in
RDoc::Markup::Formatter will now work. Issue #38 by tsilen.
* RDoc::Parser::C can now distinguish between class methods and instance
methods in Document-method. Issue #36 by Vincent Batts.
* RDoc now encodes file names in the output encoding. Issue #33 by Perry
Smith.
* ri data generation for method aliases no longer duplicates the class in
#full_name
=== 3.6.1 / 2011-05-15
* Bug fixes
* Fix infinite loop created when re-encountering BasicObject.
* RDoc::Context#each_ancestor is now provided for duck-typing.
* rb_path2class() can now be used to discover the parent class in
rb_define_class_under.
=== 3.6 / 2011-05-13
* Major Enhancements
* Interactive ri is now the default when no names are given.
* Minor Enhancements
* RDoc::RDoc#generate was added to allow multiple generators to be used with
a set of parsed file info.
* RDoc::Options#finish can be called multiple times now.
* `ri -i` only shows one level of namespace when completing class names.
* Added `ri --list` for explicit listing. `ri -l F G` will list all classes
or modules starting with F or G
* Bug fixes
* Remove windows-specific test for test_check_files, it is too hard to do.
Ruby commit r30811 by Usaku Nakamura.
* Remove unnecessary (and wrong) platform-dependent hacks. Ruby commit
r30829 by Usaku Nakamura.
* Completing via Array#[ in `ri -i` no longer crashes. Ruby Bug #3167
* Completing IO::o in `ri -i` now returns results. Ruby Bug #3167
* RDoc::Parser::C ignores prototypes better. Pull Request #34 by Pete
Higgins.
* private_class_method and public_class_method are now parsed correctly for
inherited methods. Issue #16 by gitsucks.
* The doc directive now forces documentation even when the method is marked
private or protected.
=== 3.5.3 / 2010-02-06
* Bug fixes
* When including a file lossily force-transcode it to the output encoding
instead of crashing to preserve as much content as possible. Ruby Bug
#4376 by Yui NARUSE.
* Work around inconsistent encoding result from String#sub!, String#gsub!.
Related to Ruby Bug #4376.
* Work around inconsistent encoding result from String#[]=. Related to Ruby
Bug #4376.
* When Darkfish fails the file being generated is now reported.
=== 3.5.2 / 2010-02-04
* Deprecations
* RDoc::Context::Section#sequence is now deprecated. Use
RDoc::Context::Section#aref instead.
* Bug fixes
* Fixed syntax highlighting CSS class generation. Reported by Daniel
Bretoi.
* Fixed ri for methods with aliases. Pull Request #15 by Sven Riedel.
* Added windows-specific test for test_check_files.
* Darkfish now supports sections. Template and generator author see
RDoc::Context#each_section to add section support. RubyForge Bug #26883
by Jeff Hodges.
* Fixed post-install message for Ruby 1.9.2 users.
* Set required ruby version to >= 1.8.7.
=== 3.5.1 / 2010-01-30
* Bug fixes
* Fixed some typos. Pull request #13 by R.T. Lechow.
* Ensure an RDoc::Stats is created in #parse_files. Fixes documentation for
railties which has no files. Reported by Aaron Patterson
=== 3.5 / 2010-01-29
* Minor enhancements
* RDoc::Parser::C looks for rb_scan_args and fills in RDoc::AnyMethod#params
appropriately. This may provide useful information if the author did not
provide a call-seq.
* RDoc::Parser::C now records the function name for methods implemented in
C.
* RDoc now records file and byte offset information for methods.
* Bug fixes
* Locations of module aliases are now recorded.
* RDoc::Parser::C finds method bodies better now.
* Fixed further locations where output encoding was not preserved. Bug #11
by Vít Ondruch, RubyForge bug #28791 by Dzmitry Prakapenka.
* Fixed display of numeric lists on the index page and file pages. Bug #12
by tobijk.
* Skip TestRDocOptions#test_check_files on windows until a windows-specific
test can be created. RubyForge bug #28821 by Usaku Nakamura.
* Fixed line-height of headings in method and alias descriptions. RubyForge
Bug #2770 by Adam Avilla
* Relaxed RDoc::Parser::Ruby#remove_private_comments to consume more dashes
as older versions once did. Bug #7 by Claus Folke Brobak.
=== 3.4 / 2010-01-06
* Minor enhancements
* RDoc::RDoc#document may now be called with an RDoc::Options instance.
* Bug fixes
* Added skips to Encoding tests running on 1.8.
* Fixed warnings
=== 3.3 / 2010-01-03
* Minor enhancements
* The coverage report can now report undocumented method parameters
including methods defined in C.
rdoc -C gives a standard report, rdoc -C1 includes
method parameters. Method parameters are considered documented if they're
marked-up with +, while begin a; b end # ....
Ruby Bug #3160 by Yusuke Endoh.
=== 2.5.3 / 2010-04-10
* 1 Minor Enhancement
* RDoc::Parser::Simple and the include directive remove coding: comment from
first line
* 2 Bug Fixes
* Fixed loading of created.rid when regenerating documentation. Ruby bug
#3121 by Yusuke Endoh.
* Compare times as Integers as created.rid doesn't store fractional times.
=== 2.5.2 / 2010-04-09
* 1 Minor Enhancement
* Imported various changes by Nobu from ruby trunk.
* 2 Bug Fixes
* RDoc parses files without extensions as text files again.
* RDoc::Parser::Ruby parses %{ strings correctly again.
=== 2.5.1 / 2010-04-06
* 1 Minor Enhancement
* RDoc::Parser::C now supports the include directive for classes and
modules.
* 6 Bug Fixes
* RDoc::AnyMethod params now get saved in ri data.
* ri now displays method arguments correctly.
* RDoc::Markup::Parser allows no space between = and header text like rdoc
2.4 and earlier.
* RDoc::Parser::C's "in" directive now looks in the current directory.
* RDoc::Task's rerdoc task no longer deletes the doc directory twice.
* rdoc --force-update now works correctly. Patch by Nobu Nokada
=== 2.5 / 2010-03-31
* 9 Major Enhancements
* Darkfish now has a "Home" button
* ri no longer displays the value of a constant. There's no easy way to
make them presentable. Use irb or ruby -e instead. Ruby Bug #549.
* New ri data format now uses Marshal and pre-builds caches
* No support for old ri data format, too hard to maintain
* To upgrade your core ri documentation, install the rdoc-data gem and run
rdoc-data
* RDoc now displays how well you've documented your library
* New recursive-descent parser for RDoc::Markup. See RDoc::Markup::Parser
* Updated ruby_lex and ruby_token
* Removed threading support, RDoc is not thread-safe
* Removed many unsupported options to rdoc
* Future versions of RDoc will not support Ruby 1.8.6. Bugs filed for
1.8.6-only issues will be (largely) rejected.
* 17 Minor Enhancements
* Source Parsing
* RDoc now supports module aliasing via constant assignment.
* RDoc now tracks superclasses correctly. Fixes File < IO for core docs.
* RDoc now ignores methods inside methods.
* RDoc now ignores Marshal and other binray files.
* Removed "Skipping require of dynamic string" warning.
* C parser now handles Document-method better. Bug #27329.
* API enhancements for writing parsers like the Ruby parser, see
RDoc::Parser::RubyTools
* ri
* Uses pager over less and more for Debian. Ruby Bug #1171.
* ri will use the RI_PAGER environment variable to find a pager.
* ri data generator now supports SIGINFO (^T)
* When rdoc is in debug mode, ^C now prints a backtrace
* RDoc::Markup::AttributeManager no longer uses global state.
* RDoc::RDoc no longer passes around options. Patch #27167.
* Darkfish won't generate a file if its template is missing. Patch #25857.
* Improved some wording for the RDoc main page. Patch #27264, #27268.
* Removed diagram generation support (to return in the future).
* Removed external support for RDoc::Task.
* 12 Bug Fixes
* The :attr: directives now use the name given to create an attribute. See
RDoc::Parser::Ruby#parse_meta_attr.
* Fix crossrefs on paths with '-'. Ruby Bug #883.
* Fix ruby parser for alias with = in the name. Bug #27522.
* Images are no longer executable. Bug #27156.
* --op is no longer overridden by --ri. Bug #27054.
* :method: now works when at the end of a class. Bug #26910.
* Preserve elipsis from call-seq in Darkfish. Patch #26974.
* Emacs-style coding: is handled properly. Patch #27388.
* RDoc::RubyLex now parses UTF-8 identifiers. Bug #26946, #26947.
* Fixed namespace lookup rules. Bug #26161.
* Worked around bug in Selenium where they hide a .jar in a .txt file.
Filed Selenium bug #27789.
* Alias comments are no longer hidden. Reported by Adam Avilla.
=== 2.4.3 / 2009-04-01
* 2 Bug Fixes
* Corrected patch for file links
* Corrected display of file popup
=== 2.4.2 / 2009-03-25
* 2 Minor Enhancements
* Added --pipe for turning RDoc on stdin into HTML
* Added rdoc/task.rb containing a replacement for rake/rdoctask.rb. Use
RDoc::Task now instead of Rake::RDocTask.
* 10 Bug Fixes
* Writing the ri cache file to the proper directory. Bug #24459 by Lars
Christensen.
* Possible fix for Dir::[] and Pathname interaction on 1.9. Bug #24650 by
tiburon.
* Fixed scanning constants for if/end, etc. pairs. Bug #24609 by Ryan
Davis.
* Fixed private methods in the C parser. Bug #24599 by Aaron Patterson.
* Fixed display of markup on RDoc main page. Bug #24168 by rhubarb.
* Fixed display of \\ character in documentation proceeding words.
Bug #22112 by James Gray. See RDoc for details.
* Fixed parsing and display of arg params for some corner cases. Bug #21113
by Csiszár Attila.
* Fixed links in Files box. Patch #24403 by Eric Wong.
* Toplevel methods now appear in Object. Bug #22677 by Ryan Davis.
* Added back --promiscuous which didn't do anything you cared about. Why
did you enable it? Nobody looked at that page! Oh, it warns, too.
=== 2.4.1 / 2009-02-26
* 1 Minor Enhancements
* Added :attr:, :attr_reader:, :attr_writer:, :attr_accessor: directives.
Replaces --accessor. See RDoc::Parser::Ruby for details.
* 3 Bug Fixes
* Don't complain when exiting normally. Bug by Matt Neuburg.
* Restore --inline-source that warns
* Fixed links to files in Darkfish output
=== 2.4.0 / 2009-02-24
* 9 Minor Enhancements
* `ri -f html` is now XHTML-happy
* Clarified RDoc::Markup link syntax. Bug #23517 by Eric Armstrong.
* Number of threads to parse with is now configurable
* Darkfish can now use alternate templates from $LOAD_PATH via -T
* Removed F95 parser in favor of the rdoc-f95 gem
* Moved HTML and XML generators to unmaintained
* No gem will be provided as it's too difficult to make them work
* Removed options --one-file, --style=, --inline-source, --promiscuous,
--op-name
* Removed support for --accessor, use regular documentation or
the method directive instead. See RDoc::Parser::Ruby
* Removed --ri-system as it is unused by Ruby's makefiles
* Added method list to index.html
* 6 Bug Fixes
* nodoc'd classes no longer appear in the index. Bug #23751 by Clifford
Heath.
* Fix 1.9 compatibility issues. Bug #23815 by paddor.
* Darkfish now respects --charset
* RDoc no longer attempts to be lazy when building HTML. This is a
workaround. Bug #23893 by Stefano Crocco.
* RDoc doesn't crash with def (blah).foo() end
* RDoc doesn't crash with #define functions
=== 2.3.0 / 2009-01-28
* 3 Major Enhancements
* Michael Granger's Darkfish generator is now the default for HTML output
* Various rdoc generation speedups by Hongli Lai. Patches #22555, #22556,
#22557, #22562, #22565.
* rdoc/discover.rb files are loaded automatically from installed gems
* 8 Minor Enhancements
* Added a space after the commas in ri class method lists. RubyForge
enhancement #22182.
* Improved ri --interactive
* Generators can now override generated file locations
* Moved unmaintained CHM generator to it's own package
* Moved unmaintained extra HTML templates to their own package
* Removed experimental texinfo generator
* Converted to minitest
* Known classes and modules list outputs once per line now for grep
* 11 Bug Fixes
* Fix missing superclass in ri output
* Fix an RDoc crash when told to parse an empty file
* Ignore nonexistent files instead of crashing
* .txt and .rdoc files are always considered text. Patch #22897 by Aaron
Patterson.
* When merging ri data with a nonexistant directory, RDoc no longer crashes
* Fix visibility of methods in XML output. Issue by Yehuda Katz.
* Fixed relative link generation
* Fix crash, RDoc now ignores comments above local variable assignments in
modules
* RDoc now only accepts adjacent comments for rb_define_module and
rb_define_class
* C file RDoc is no longer included in token stream
* Scan all gem paths to match gem name for ri output
=== 2.2.1 / 2008-09-24
This version provides some minor fixes and enhancements to 2.2.0 intended
to polish RDoc for Ruby 1.9.1.
* 3 Minor Enhancements
* Support for parsing RDoc from SWIG. Ruby patch #10742 by Gonzalo
Garramuno, #13993 by Steven Jenkins.
* Simple support for Perl POD documentation. Patch by Hugh Sasse.
* Changed the default character set of RDoc's output from iso-8859-1 to
utf-8.
* 9 Bug Fixes
* Explicitly set the html template's text color, so that the generated
documentation will display correctly on browsers with custom text and
background color settings (patch by Luther Thompson).
* Ensure that RDoc correctly will associate an alias and a method, even
if it encounters the alias first because the alias lives in a different
file.
* Fix the parsing of multiline constants (patch by Chris Alfeld and
Joel VanderWerf)
* Make --exclude usuable. Ruby patch #11671 by Trans.
* Detect inline C functions. Ruby Bug #11993 by Florian Frank.
* Fix an issue in which RDoc might not document a class'
superclass correctly if the class was defined in multiple files and
depending on the order in which RDoc processed the files. This should
ensure that the child class -> parent class relationship is correct in
ri documentation, allowing ri to lookup inherited methods (i.e., File.read).
* Stop ri from crashing when it looks for a completely bogus method (i.e.,
File#reada). Now, ri exits with a helpful error message.
* Fixed missing display of constant values in ri.
* Fixed display of constants in ri's html output.
=== 2.2.0 / 2008-09-19
This version includes some significant enhancements to ri. See RI.txt for
documentation about ri.
* 5 Major Enhancements
* More extensive unit tests (special thanks to Chris Lowis for contributing
a test).
* Made ri twice as fast for the most common use case of displaying
information for a class or a fully-qualified method
(i.e., ri Array#flatten, after ri has created a cache the first time that
it runs).
* Made ri many times faster when searching for an unqualified method (i.e.,
ri read, again after the first such search has populated ri's cache)
* Changed ri to do regular expression searches for unqualified methods;
now, a regular expression for a method can be passed to ri on the
command-line.
* Added an interactive mode to ri (patch by Daniel Choi). Now, when ri
is given a -i argument, it will allow the user to disambiguate
unqualified methods if more than one is present and also will allow a
user to get information for a class' method.
* 8 Minor Enhancements
* RDoc now adds the package title to the web pages that it generates
for files and classes/modules, which helps them appear better in
search engine results.
* RDoc now automatically generates cross-reference links for classes and
methods specified relative to the global namespace (i.e., ::A::B::C#method).
* All built-in templates now output valid, strict XHTML.
* The documentation is slightly better organized (the markup details were
merged into the RDoc module's documentation).
* Improved rdoc's HTML generation speed by about 20% (on Windows, the
boost seems larger).
* Provided an ri command-line option to control its caching behavior.
* Improved RDoc's documentation. Added RI.txt to document ri.
* Allow HTML templates distributed as gems to be loaded with the -T option,
just like the standard templates in rdoc/generator/html (so an HTML
template lib/new_template.rb in a gem can be used with rdoc -T new_template)
* 25 Bug fixes:
* Fixed prototype detection in C parser. Can process ruby 1.8 C files
again.
* Fixed the main page for frameless template. Patch by Marcin Raczkowski.
* Fixed the main page for frame templates. Now, if no main page is
specified, RDoc will default to the README.
* Fixed missing stylesheet in generated chm. Patch by Gordon Thiesfeld.
* Fixed the parsing of module names starting with '::'. Patch by
Giuseppe Bilotta.
* Fixed a case where RDoc first would encounter Foo::Bar and then would
encounter class Foo. Previously, RDoc erroneously would have considered
that both a Foo class and a Foo module existed.
* Fix a clase where RDoc would not generate correct cross-reference links
to a class contained within a module of the same name (i.e. RDoc::RDoc)
* Prevented RDoc from trying to parse binary files, which would produce
garbage output.
* RDoc now correctly converts ' characters to apostrophes, opening single
quotes, and closing single quotes in most cases (smart single quotes).
* RDoc now correctly converts " characters to opening double quotes and
and closing double quotes in most cases (smart double quotes).
* (c) correctly is converted into the copyright symbol.
* '&' characters in text now correctly are translated to HTML character codes.
* Fixed missing stylesheet in generated chm. Patch by Gordon Thiesfeld.
* Fixed broken method links in the built-in templates.
* RDoc properly links to files and classes in the one page HTML template.
* The kilmer and hefss templates properly syntax highlight when inlining
source code.
* The kilmer and hefss template class pages properly display methods again.
* Fixed broken class, file, and method links in the frameless template.
* Fixed the clipping of source code in the html and frameless templates when
the source code cannot fit into the window; a scrollbar now will allow
all of the source code to be viewed.
* Fixed the missing constant descriptions in the html and frameless
templates.
* Fixed the ri command-line options that customize the directories to be
searched for documentation.
* Fixed the XML generator. Patch by Anthony Durity.
* Stopped the XML template from generating invalid XML due to malformed
embedded ruby.
* Adding missing information about a class' constants to the XML template.
* Fixed the horizontal rule markup (---) so that it correctly adds a
horizontal rule rather than suppressing all text that follows.
=== 2.1.0 / 2008-07-20
* 3 Major Enhancements:
* RDoc now knows about meta-programmed methods, see RDoc::Parser::Ruby
* Reorganized parsers under RDoc::Parser base class
* ri now walks the ancestors of a class looking for a method e.g. ri
File#read displays documentation for IO#read (may require regeneration of
ri data)
* 5 Minor Enhancements:
* Allow links to files
* Default options now taken from RDOCOPT environment variable
* Class method documentation can be found at toplevel now (def X.foo)
* Allow HTML templates distributed as gems to be loaded with the -T option,
just like the standard templates in rdoc/generator/html (so an HTML
template lib/new_template.rb in a gem can be used with rdoc -T new_template)
* `rdoc -v` prints out files, classes, modules and methods as it goes
* 11 Bug Fixes:
* `ri Foo.bar` now looks for class methods also
* Sections work in the default template again
* Doesn't warn about :foo:: list item being an unrecognized directive
* RDoc no longer converts characters inside tt tags
* Fixed "unitialized constant RDoc::Markup::ToHtml::HTML"
* Fixed generation of relative links
* Fixed various diagram generation issues
* Fixed templates broken by switch to erb
* Fixed issue with style comments
* Lowercase words are no longer rdoc'd as methods without leading #, as
described in the documentation
* RDoc now correctly sets superclasses if they were originally unknown
=== 2.0.0 / 2008-04-10
* 3 Major Enhancements:
* Renamespaced everything RDoc under the RDoc module.
* New `ri` implementation.
* Reads from a cache in ~/.ri/ for enhanced speed.
* RubyGems aware, only searches latest gem versions.
* Now up to over 100 tests and 200 assertions.
* 4 Minor Enhancements:
* Switched to an ERb-based TemplatePage, see RDoc::TemplatePage.
* Class/module ri now displays attribute and constant comments.
* Cross-references can be disabled with a leading \.
* Relaxed parsing for some RDoc inline markup.