[ANN] RDoc 2.2.1 released

RDoc 2.2.1 now is available!

This version essentially aims to fix a number of bugs overlooked for the
2.2.0 release in order to get the fixes into Ruby 1.9.1. Thanks for all
of the patches and for bringing the problems to the RDoc development
team’s attention.

Documentation: http://rdoc.rubyforge.org
Project Page (and download): http://rubyforge.org/projects/rdoc

I wrote a blog post at
http://blogs.designingpatterns.com/urban-jungle/2008/09/24/rdoc-221-released/
that highlights some features of the new release.
The full changelog is at
http://rdoc.rubyforge.org/files/History_txt.html.
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 S…
  • 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 T.).
  • 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 A. and Joel
    VanderWerf)
  • Make --exclude usuable. Ruby patch #11671 by Trans.
  • Detect inline C functions. Ruby Bug #11993 by Florian F…
  • 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). In order to see the fix, a machine’s documentation will
    need to be rebuilt (see the blog post linked to above).
  • 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.