This file contains some things that might happen in RDoc, or might not. Forward Looking Statements applies.

RDoc::VERSION.succ

Blockers:

• The alias keyword should not be bidirectional

• Github extensions to markdown

• Fix RDoc::Parser#use_markup to handle the filename (see TODO)

• Restore backwards compatibility due to paragraph text joining from existing ri files

Nice to have:

• Update LICENSE to match ruby’s switch

• Reload the RDoc tree from an RI store

  • Re-run generators

  • Parse only changed files (like in ruby)

• Page of Glory (or Shame) in HTML output showing documentation coverage statistics.

• Link to the parent-class implementation of methods that use super

• Add direct accessor to RDoc::Options to RDoc::Task

• Remove “Public” in HTML output if there are only public methods

• Method markup support for rd documentation (per rd syntax)

• Improve SIGINFO handling

• Global variable support

• Page support for ri

• Provide the code_object to directive handlers

4

API changes to RDoc

• Remove global state

• Remove RDoc::RDocError

• RDoc::TopLevel#add_method should automatically create the appropriate method class rather than requiring one be passed in.

• Remove comment= from Context subclasses in favor of add_comment

• RDoc::CodeObject

  • Move into own namespace

  • Rename TopLevel to File

  • Rename Context to Container

  • Rename NormalClass to Class

• Add versions to RDoc::Markup syntax tree marshal format

Crazy Ideas

* Auto-normalize heading levels to look OK.  It's weird to see an <h1> in
  the middle of a method section.