nanoc/nanoc — pull request #290 by ddfreyne (2013-03-18 19:32:18+00:00)
Title: Update rdoc filter to use RDoc 4.x

This change lets the RDoc filter use the `rdoc` gem, version 4.x, which is the latest released RDoc version.

### Compatibility with RDoc 3.x

As much as I would like to be compatible with both RDoc 3.x and 4.x, I do not believe this is possible here. There is no clean way to load RDoc 4.x if available, and fall back to RDoc 3.x if it is not. This is because RDoc is bundled with Ruby.

One solution to the compatibility problem would be to rescue the exception that the `gem` call raises. Afterwards, the filter code can base itself on the value of `RDoc::VERSION` to decide whether to take the 3.x or the 4.x path.

However, should people who use RDoc not simply upgrade to 4.x?