We have a few problems concerning the rdoc, ri documentation.
- dist target installs rdoc and ri into bin. The scripts rely on RubyGems to provide the respective gems, but we do not distribute them. Thus, for the binary package we get:
- When you install rdoc, you get the following message (in both 1.8 and 1.9 modes):
It is not clear what the user is supposed to do for JRuby. The answer is that you need to install rdoc-data, and run the indicated command. If the marginal storage is negligible, it might be best to distribute these gems (rdoc and rdoc-data) and run rdoc-data --install beforehand for the dist target to avoid this potential confusion.
- Right now, generate-ri-cache ant task is commented out in build.xml. This task fails because of the issues described above.