Bug 1458131 - RI can't find Array#new docs
Summary: RI can't find Array#new docs
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: rubygem-rdoc
Version: 26
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Mo Morsi
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
: 1475253 (view as bug list)
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-06-02 06:37 UTC by Alexander Kurtakov
Modified: 2017-08-04 20:49 UTC (History)
8 users (show)

Fixed In Version: rubygem-rdoc-5.1.0-2.fc26 rubygem-rdoc-4.2.2-3.fc24 rubygem-rdoc-4.2.2-3.fc25
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-08-04 16:52:32 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Alexander Kurtakov 2017-06-02 06:37:42 UTC
`ri Array#new` gives 'Nothing known about Array'.

Looking at ruby-doc content is in /usr/share/ri/system but 
ri --list-doc-dirs
/usr/share/ri/2.4.0/system
/usr/share/ri/2.4.0/site
/home/akurtakov/.rdoc
/usr/share/gems/doc/coderay-1.1.0/ri
/usr/share/gems/doc/rdoc-5.1.0/ri
/usr/share/gems/doc/test-unit-3.2.4/ri
/usr/share/gems/doc/test-unit-notify-1.0.4/ri
/usr/share/gems/doc/test-unit-rr-1.0.5/ri

so the place where ruby-doc puts its content is not looked up by ri.

Comment 1 Vít Ondruch 2017-06-02 09:13:05 UTC
First of all, your example is wrong, since Array#new would be instance method, while you should be looking for class method Array.new.

But anyway, this is interesting, since the paths are wrong and they must be broken for ages (probably since Ruby 1.9.3 already) and nobody noticed yet. This needs to be fixed in rubygem-rdoc as well as in ruby (since ruby ships bundled version of rubygem-rdoc).

This is where the paths are set:

https://github.com/rdoc/rdoc/blob/e02728fdf440012ace74b62b00b4f4954d2f91c3/lib/rdoc/ri/paths.rb#L182
https://github.com/rdoc/rdoc/blob/e02728fdf440012ace74b62b00b4f4954d2f91c3/lib/rdoc/ri/paths.rb#L15

As a temporary workaround, you can use:

~~~
$ ri --doc-dir=/usr/share/ri/system/ Array.new
~~~

or

~~~
$ export RI=--doc-dir=/usr/share/ri/system/
$ ri Array.new
~~~

Comment 2 Aaron Lu 2017-06-23 08:47:11 UTC
Same problem here on Fedora 25.

I was looking for Regexp but ri gives me nothing:
$ ri Regexp
Nothing known about Regexp
$ ri --list-doc-dirs
/usr/share/ri/2.3.0/system
/usr/share/ri/2.3.0/site
/home/aaron/.rdoc
/usr/local/share/gems/doc/ast-2.3.0/ri
/usr/local/share/gems/doc/builder-3.2.3/ri
/usr/local/share/gems/doc/bundler-1.14.6/ri
/usr/local/share/gems/doc/coderay-1.1.1/ri
/usr/local/share/gems/doc/git-1.3.0/ri
/usr/local/share/gems/doc/gnuplot-2.6.2/ri
/usr/local/share/gems/doc/method_source-0.8.2/ri
/usr/local/share/gems/doc/pry-0.10.4/ri
/usr/local/share/gems/doc/rake-12.0.0/ri
/usr/local/share/gems/doc/slop-3.6.0/ri
/usr/local/share/gems/doc/term-ansicolor-1.4.0/ri
/usr/local/share/gems/doc/tins-1.13.2/ri

While those rdocs are actually under /usr/share/ri/system/Regexp.

The mentioned workaround works.

Comment 3 Aaron Lu 2017-06-26 08:39:50 UTC
BTW, I think the problematic package is ruby-doc: it should install those ri doc files to /usr/share/ri/2.3.0/System instead of /usr/share/ri/System.

Comment 4 Vít Ondruch 2017-06-26 14:25:52 UTC
There is "--with-ridir=DIR" configuration option if I am not mistaken, this should help ...

Comment 5 Alexander Kurtakov 2017-06-26 19:09:45 UTC
It's worth fixing ruby-doc instead of relying on every user finding on his own additional params to pass.

Comment 6 Aaron Lu 2017-06-27 01:56:49 UTC
(In reply to Alexander Kurtakov from comment #5)
> It's worth fixing ruby-doc instead of relying on every user finding on his
> own additional params to pass.

Agree. I found this bug report before I'm aware of those switches.

Comment 7 Vít Ondruch 2017-06-27 07:59:02 UTC
Ok, let me try to rephrase comment #4:

It seems that Ruby configure script has "--with-ridir=DIR" option, which should help to resolve the issue once for all and for everybody.

Comment 8 Aaron Lu 2017-06-28 05:11:58 UTC
(In reply to Vít Ondruch from comment #7)
> Ok, let me try to rephrase comment #4:
> 
> It seems that Ruby configure script has "--with-ridir=DIR" option, which
> should help to resolve the issue once for all and for everybody.

Good to know this. Looking forward to have an updated package that has this problem fixed, thanks!

Comment 9 Mamoru TASAKA 2017-07-26 11:13:00 UTC
*** Bug 1475253 has been marked as a duplicate of this bug. ***

Comment 10 Vít Ondruch 2017-07-26 16:28:52 UTC
As it turns out, this is issue of independent rubygem-rdoc, which has ATM higher version then the rubygem-rdoc coming from ruby package.

Comment 11 Fedora Update System 2017-07-26 16:58:56 UTC
rubygem-rdoc-5.1.0-2.fc26 has been submitted as an update to Fedora 26. https://bodhi.fedoraproject.org/updates/FEDORA-2017-0dd79e9cf5

Comment 12 Fedora Update System 2017-07-26 17:11:37 UTC
rubygem-rdoc-4.2.2-3.fc25 has been submitted as an update to Fedora 25. https://bodhi.fedoraproject.org/updates/FEDORA-2017-29526f04d3

Comment 13 Fedora Update System 2017-07-26 17:12:50 UTC
rubygem-rdoc-4.2.2-3.fc24 has been submitted as an update to Fedora 24. https://bodhi.fedoraproject.org/updates/FEDORA-2017-f1a98f12f3

Comment 14 Fedora Update System 2017-07-27 22:50:54 UTC
rubygem-rdoc-4.2.2-3.fc24 has been pushed to the Fedora 24 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-f1a98f12f3

Comment 15 Fedora Update System 2017-07-27 23:23:15 UTC
rubygem-rdoc-4.2.2-3.fc25 has been pushed to the Fedora 25 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-29526f04d3

Comment 16 Fedora Update System 2017-07-28 01:52:14 UTC
rubygem-rdoc-5.1.0-2.fc26 has been pushed to the Fedora 26 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2017-0dd79e9cf5

Comment 17 Aaron Lu 2017-07-31 01:43:48 UTC
Works for me, thanks.

Comment 18 Fedora Update System 2017-08-04 16:52:32 UTC
rubygem-rdoc-5.1.0-2.fc26 has been pushed to the Fedora 26 stable repository. If problems still persist, please make note of it in this bug report.

Comment 19 Fedora Update System 2017-08-04 19:47:51 UTC
rubygem-rdoc-4.2.2-3.fc24 has been pushed to the Fedora 24 stable repository. If problems still persist, please make note of it in this bug report.

Comment 20 Fedora Update System 2017-08-04 20:49:58 UTC
rubygem-rdoc-4.2.2-3.fc25 has been pushed to the Fedora 25 stable repository. If problems still persist, please make note of it in this bug report.


Note You need to log in before you can comment on or make changes to this bug.