This post originated from an RSS feed registered with Ruby Buzz by Eric Hodel. Original Post: rdoc 2.5 Feed Title: Segment7 Feed URL: http://blog.segment7.net/articles.rss Feed Description: Posts about and around Ruby, MetaRuby, ruby2c, ZenTest and work at The Robot Co-op. Latest Ruby Buzz Posts Latest Ruby Buzz Posts by Eric Hodel Latest Posts From Segment7

rdoc version 2.5 has been released!

• RDoc Project Page

• RDoc Documentation

• RDoc Bug Tracker

RDoc is an application that produces documentation for one or more Ruby source files. RDoc includes the rdoc and ri tools for generating and displaying online documentation.

At this point in time, RDoc 2.x is a work in progress and may incur further API changes beyond what has been made to RDoc 1.0.1. Command-line tools are largely unaffected, but internal APIs may shift rapidly.

See RDoc for a description of RDoc’s markup and basic use.

Changes:

NOTE:

You’ll need to:

  gem install rdoc-data

then run:

  rdoc-data

to have ri data for core and stdlib like Array or Kernel or Date.

• 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.