From: xkernigh@... Date: 2017-10-12T22:30:37+00:00 Subject: [ruby-core:83245] [Ruby trunk Bug#14004] ri confused by method aliases and by Queue versus Thread::Queue Issue #14004 has been updated by kernigh (George Koehler). rdoc also confuses class Gem::RDoc with class RDoc. The command `ri RDoc` shows the description of both Gem::RDoc and RDoc as if they were one class. The command `ri Gem::RDoc` says, "Nothing known about Gem::RDoc". The HTML from `make html` documents Gem::RDoc as RDoc and has no document for the real RDoc. The document for RDoc::RDoc seems fine. ---------------------------------------- Bug #14004: ri confused by method aliases and by Queue versus Thread::Queue https://bugs.ruby-lang.org/issues/14004#change-67197 * Author: kernigh (George Koehler) * Status: Open * Priority: Normal * Assignee: * Target version: * ruby -v: ruby 2.5.0dev (2017-10-10 trunk 60155) [x86_64-openbsd6.2] * Backport: 2.3: UNKNOWN, 2.4: UNKNOWN ---------------------------------------- `ri` in Ruby trunk fails to find documentation for some methods. Array#append and Array#prepend are new in trunk. ri knows that these methods exist, but has no document for them. ``` $ ri Array#append = Array#append (from ruby core) ------------------------------------------------------------------------------ append(*args) ------------------------------------------------------------------------------ ``` The same problem happens with all methods from `rb_define_alias()` in Ruby's source code. For example, Array#size, IO#to_i, Hash#to_s, and Thread#inspect have no document. These are all aliases of other methods that have document. There is another problem with Queue, an alias for Thread::Queue. ri doesn't know that Queue has methods. ``` $ ri Queue#push Nothing known about Queue#push ``` The command `ri Queue` shows the document for the class, but it has no methods. The command `ri Thread::Queue` shows methods, but no class document. The same problem happens with other classes in rthread_sync.c, like Mutex. -- https://bugs.ruby-lang.org/ Unsubscribe: