Fix History, I forgot I released 3.8

Restore post-install message

Author: drbrain

History.txt

@@ -1,16 +1,21 @@
-=== 3.8 / ??
+=== 3.9 / ??
 
 * Minor enhancements
-  * RDoc::Parser::C can now discover methods on ENV and ARGF.
-  * RDoc::Parser::C now knows about rb_cSocket and rb_mDL.
   * RDoc::Parser::C now supports :doc: and :nodoc: for class comments
 * Bug fixes
-  * Updating Object in an ri data store with new data now removes methods,
-    includes, constants and aliases.
   * `ri []` and other special methods now work properly.  Issue #52 by
     ddebernardy.
   * `ri` now has space between class comments from multiple files.
 
+=== 3.8 / 2011-06-29
+
+* Minor enhancements
+  * RDoc::Parser::C can now discover methods on ENV and ARGF.
+  * RDoc::Parser::C now knows about rb_cSocket and rb_mDL.
+* Bug fixes
+  * Updating Object in an ri data store with new data now removes methods,
+    includes, constants and aliases.
+
 === 3.7 / 2011-06-27
 
 * Minor enhancements

Rakefile

@@ -19,6 +19,16 @@ Hoe.spec 'rdoc' do
   rdoc_locations << 'docs.seattlerb.org:/data/www/docs.seattlerb.org/rdoc/'
   rdoc_locations << '[email protected]:/var/www/gforge-projects/rdoc/'
 
+
+  spec_extras[:post_install_message] = <<-MESSAGE
+Depending on your version of ruby, you may need to install ruby rdoc/ri data:
+
+<= 1.8.6 : unsupported
+ = 1.8.7 : gem install rdoc-data; rdoc-data --install
+ = 1.9.1 : gem install rdoc-data; rdoc-data --install
+>= 1.9.2 : nothing to do! Yay!
+  MESSAGE
+
   self.testlib = :minitest
   self.isolate_dir = 'tmp/isolate'
 

lib/rdoc/markup/formatter.rb

@@ -4,6 +4,10 @@
 # Base class for RDoc markup formatters
 #
 # Formatters use a visitor pattern to convert content into output.
+#
+# If you'd like to write your own Formatter use
+# RDoc::Markup::FormatterTestCase.  If you're writing a text-output formatter
+# use RDoc::Markup::TextFormatterTestCase which provides extra test cases.
 
 class RDoc::Markup::Formatter