Is RDoc 4.x supported in Rails 3.2?

[voxik]

Is there any reason, why RDoc 4.x should not be used? Can the dependency in Railties be relaxed? Thank you.

[fxn]

Rails 3 only gets bug and security fixes, RDoc 3 is fine for Rails 3 thanks.

[voxik]

That is sad :/ You give me no other chance then patch this dependency in Fedora. This doesn't help Fedora, nor Rails nor anybody else :(

[fxn]

A tiny release 3.2.x is not going to gratuitously upgrade RDoc in the machines of all users.

[voxik]

I am not asking you to force RDoc 4.x, I am asking you to relax the dependency, if possible, i.e. instead of ~> 3.4 use >= 3.4. Ruby 2.0 comes with RDoc 4.x, why do you want to force everybody to install older RDoc? On Fedora, we even cannot install older version using YUM/RPM and I believe that Fedora is not exception in this.

[voxik]

This is the patch I am going to use in Fedora 19, which goes with Ruby 2.0.0:

http://pkgs.fedoraproject.org/cgit/rubygem-railties.git/tree/rubygem-railties-3.2.12-relax-rdoc-dependency.patch

[voxik]

BTW if you consider support of Ruby 2.0 and you are doing bugfixes due to it, I see no difference to support RDoc 4.x

[fxn]

Yeah, if we need to relax the constraint due to support for Ruby 2.0 then we would do it.

[voxik]

But why are you going to support Ruby 2.0 without supporting RDoc 4.x? If you can support Ruby 2.0, you can support RDoc 4.x, can't you? What can I do to convince you? Would PR make some difference?

[fxn]

By now not even Rails 4 is going to depend on RDoc 4, we depend on RDoc 3 via SDoc as of this writing.

[voxik]

It is interesting. You made me search for 'rdoc' in Rails and I really can't see any place why it should be runtime dependecy of railties. There is no single file what so ever which could be essential to run Rails but you still enforce the dependency and you are even picky about its version.

[voxik]

Interestingly enough, mail dependency can be bumped in 3.2.13. I see not other reason to update then that new mail version is available a497f84. Moreover, mail 2.4.x is apparently still maintained. Please update the RDoc. Thank you.

[fxn]

As already said, we'll do it if the project needs it.

In Ruby different gem versions coexist just fine thanks to RubyGems, and each lib requires whatever. If you are dealing with a more restrictive environment than Ruby itself, then go patch whatever you need to patch.

[voxik]

So I am not part of the project? Neither Fedora, Red Hat, CentOS users are part of the project? Interesting. Thank you.

[fxn]

You are part of the project, and I'd like to do my best to make your life easy. But SDoc as of this writing does not support RDoc 4.

[zzak]

There is some work going on to support RDoc 4 in SDoc (see: rails/sdoc#43).

@fxn could an sdoc release with rdoc 4 support make it into rails 4?

[fxn]

@zzak that would be great.

[translunar]

Hi folks, we're running into a problem with railties' RDoc version requirement.

NMatrix issue 149: SciRuby/nmatrix#149

NMatrix needs RDoc >= 4.0.1, because NMatrix is a mixture of C and C++, and earlier RDoc versions choke on the C++ version of its init_nmatrix entry point.

Any thoughts on how we can make the two gems work together? Let me know if I should open a new issue.

Cheers,
John Woods
SciRuby Project

[zzak]

@MohawkJohn @voxik Just a heads up, this will be fixed with the release of Rails 4.1!

[fxn]

Hi there! Let me also add that in Rails 4.0 the gem dependency was removed and SDoc became a dependency in the generated Gemfile for new apps.

[voxik]

@zzak @fxn Thank you. That is good news!

[translunar]

Wonderful, @zzak! Thank you so much.