From: merch-redmine@...
Date: 2019-08-12T02:49:33+00:00
Subject: [ruby-core:94297] [Ruby master Bug#10691] Bad or Non-existent class names listed on 'Index of Files, Classes & Methods in Ruby' page.

Issue #10691 has been updated by jeremyevans0 (Jeremy Evans).

File fatal-doc-10691.patch added

`Complex::compatible`, `unknown`, `Rational::compatible` were removed by Ruby 2.6.0.  `fatal` is still documented, but that exists even though you cannot reference it directly:

```ruby
f = ObjectSpace.each_object(Class){|c| break c if c.name && c.name.downcase == c.name}
# => fatal
f.ancestors
# => [fatal, Exception, Object, Kernel, BasicObject]
```

The documentation for `fatal` states `You are not able to rescue fatal.`  That appears to be incorrect:

```ruby
f = ObjectSpace.each_object(Class){|c| break c if c.name && c.name.downcase == c.name}

begin
  raise f
rescue f
  2
end
# => 2
```

Attached is a patch that removes that sentence from fatal's documentation.  I'm not sure if we actually want to prevent the rescuing of fatal instead, though.

----------------------------------------
Bug #10691: Bad or Non-existent class names listed on 'Index of Files, Classes & Methods in Ruby' page.
https://bugs.ruby-lang.org/issues/10691#change-80645

* Author: JuanitoFatas (Juanito Fatas)
* Status: Open
* Priority: Normal
* Assignee: zzak (Zachary Scott)
* Target version: 
* ruby -v: ruby 2.2.0p0 (2014-12-25 revision 49005) [x86_64-darwin14]
* Backport: 2.0.0: UNKNOWN, 2.1: UNKNOWN, 2.2: UNKNOWN
----------------------------------------
On this page: [Index of Files, Classes & Methods in Ruby 2.2.0 (Ruby 2.2.0)](http://www.ruby-doc.org/core-2.2.0/)

There are Classes:

![](https://dl.dropboxusercontent.com/u/4708852/bugs-ruby-lang/ruby-classes.png)

I found some of the classes listed here does not exist:

```ruby
Complex::compatible
fatal
unknown
Rational::compatible
```

What do I mean by not exist? That is if I type `fatal` in irb:

```
irb(main):001:0> fatal
NameError: undefined local variable or method `fatal' for main:Object
	from (irb):1
	from /Users/Juan/.rubies/ruby-2.2.0/bin/irb:11:in `<main>'
irb(main):002:0> Fatal
NameError: uninitialized constant Fatal
	from (irb):2
	from /Users/Juan/.rubies/ruby-2.2.0/bin/irb:11:in `<main>'
```

Other versions of documentation also has this problem.

http://www.ruby-doc.org/core-2.0.0/
http://www.ruby-doc.org/core-2.1.5/
http://www.ruby-doc.org/core-2.2.0/

I want to remove it but cannot find which repository to work on.

So I report here, Thanks!


---Files--------------------------------
ruby-classes.png (47.4 KB)
fatal-doc-10691.patch (897 Bytes)


-- 
https://bugs.ruby-lang.org/

Unsubscribe: <mailto:ruby-core-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>