[Bug 668820] Review Request: rubygem-rdoc - RDoc produces HTML and command-line documentation for Ruby projects

[bugzilla at redhat.com]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.


https://bugzilla.redhat.com/show_bug.cgi?id=668820

--- Comment #8 from Vít Ondruch <vondruch at redhat.com> 2011-07-08 03:08:21 EDT ---
(In reply to comment #7)
Chris,

You should compare the correct branches, i.e. [1] vs [2]. In that case, you
could see that Ruby 1.8 ships with RDoc V1.0.1 - 20041108 and upstream RDoc is
currently at 3.8 version. The package which comes bundled with Ruby has name
ruby-rdoc while the gem whould have name rubygem-rdoc.

In theory, it would be possible to replace the ruby-rdoc by newer RDoc from the
gem, but it would need some magic, because the ruby-rdoc package is not
behaving as a gem, i.e. there is no .gemspec file in specifications folder.
Since Ruby does not require RubyGems by default you would be in trouble with
folder ownership etc.

So at the end, the easiest solution is to let them live side by side. You have
never noticed up until now that there are bundled RDoc and RDoc gem, so I am
not afraid that this will cause that much confusion.

Of course we could patch Railties to avoid the dependency, but it results in
broken Rails. Other solution would be to patch Rake or Rubys RDoc, but if we
start with this, it will not be less confusing, since the project will work
only on Fedora and not on the other platforms. Please check again the
discussion [3] I linked previously for the reasons why the RDoc gem is required
by Rails now.

[1] https://github.com/ruby/ruby/blob/ruby_1_8/lib/rdoc/rdoc.rb#L5
[2] https://github.com/rdoc/rdoc/blob/master/lib/rdoc.rb#L107
[3] https://github.com/rails/rails/issues/1598

P.S. It is interesting that in Ruby, there were left bundled RDoc, which is
against Fedora policy anyway. Of course it is not the only one library bundled
in Ruby.

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.