On Mar 8, 1:20 am, Trans <[EMAIL PROTECTED]> wrote: > I know the immediate reaction this is likely to get --half of which is > probably just b/c it is coming from me. But putting these gut- > reactions aside, consider it objectively. It makes sense... > > RubyGems should not be generating rdocs. > > As good an example as any for when convention ought to triumph over > configuration, this is it. As it stands we currently must fill out > gemspec options: has_rdoc, rdoc_options and extra_rdoc_files, to get > rdocs generated on install, but that's still not enough to get them > right. For starters, --main README's are missing across the board.
I found some gem generated rdocs that mange to get the READMEs up front. So that can be configured. Many of packages I looked at though don't have it configured correctly. Clearly many people aren't checking the output of RubyGems generated rdocs. T. _______________________________________________ Rubygems-developers mailing list [email protected] http://rubyforge.org/mailman/listinfo/rubygems-developers
