Sha256: e99464785f8f71b0ab60453cb757c4bd6794f9e3e0e7137099a2fc61d47fb2fa

Contents?: true

Size: 1.55 KB

Versions: 10

Compression:

Stored size: 1.55 KB

Contents

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

=== RDoc::VERSION.succ

Blockers:

* Update LICENSE to match ruby's switch
* The alias keyword should not be bidirectional
* Fix RDoc::Parser#use_markup to handle the filename (see TODO)
* Restore backwards compatibility due to paragraph text joining from existing
  ri files
* Fix consumption of , after link like: RDoc[rdoc-ref:RDoc], <- comma here
* Remove support for links like Matrix[*rows]

Nice to have:

* 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
* Provide the code_object to directive handlers

=== 4

API changes to RDoc

* 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
* Add versions to RDoc::Markup syntax tree marshal format
* Comments can no longer be Strings

=== Crazy Ideas

* Auto-normalize heading levels to look OK.  It's weird to see an <h1> in
  the middle of a method section.
* RDoc::CodeObject
  * Move into own namespace
  * Rename TopLevel to File
  * Rename Context to Container
  * Rename NormalClass to Class

Version data entries

10 entries across 8 versions & 2 rubygems

Version Path
rdoc-4.1.0.preview.3 TODO.rdoc
candlepin-api-0.4.0 bundle/ruby/gems/rdoc-4.0.1/TODO.rdoc
candlepin-api-0.4.0 bundle/ruby/1.9.1/gems/rdoc-4.0.1/TODO.rdoc
candlepin-api-0.4.0 bundle/ruby/1.8/gems/rdoc-4.0.1/TODO.rdoc
rdoc-4.0.1 TODO.rdoc
rdoc-4.0.0 TODO.rdoc
rdoc-4.0.0.rc.2.1 TODO.rdoc
rdoc-4.0.0.rc.2 TODO.rdoc
rdoc-4.0.0.preview2.1 TODO.rdoc
rdoc-4.0.0.preview2 TODO.rdoc