[#79440] [Ruby trunk Bug#13188] Reinitialize Ruby VM. — shyouhei@...
Issue #13188 has been updated by Shyouhei Urabe.
6 messages
2017/02/06
[#79441] Re: [Ruby trunk Bug#13188] Reinitialize Ruby VM.
— SASADA Koichi <ko1@...>
2017/02/06
On 2017/02/06 10:10, shyouhei@ruby-lang.org wrote:
[#79532] Immutable Strings vs Symbols — Daniel Ferreira <subtileos@...>
Hi,
15 messages
2017/02/15
[#79541] Re: Immutable Strings vs Symbols
— Rodrigo Rosenfeld Rosas <rr.rosas@...>
2017/02/15
Em 15-02-2017 05:05, Daniel Ferreira escreveu:
[#79543] Re: Immutable Strings vs Symbols
— Daniel Ferreira <subtileos@...>
2017/02/16
Hi Rodrigo,
[#79560] Re: Immutable Strings vs Symbols
— Rodrigo Rosenfeld Rosas <rr.rosas@...>
2017/02/16
Em 15-02-2017 22:39, Daniel Ferreira escreveu:
[ruby-core:79817] [Ruby trunk Bug#13262] Docs of core classes (Math and others) are shadowed by mathn.rb docs
From:
sto.mar@...
Date:
2017-02-28 10:44:47 UTC
List:
ruby-core #79817
Issue #13262 has been updated by Marcus Stollsteimer. Description updated ---------------------------------------- Bug #13262: Docs of core classes (Math and others) are shadowed by mathn.rb docs https://bugs.ruby-lang.org/issues/13262#change-63253 * Author: Marcus Stollsteimer * Status: Open * Priority: Normal * Assignee: * Target version: * ruby -v: * Backport: 2.2: UNKNOWN, 2.3: UNKNOWN, 2.4: UNKNOWN ---------------------------------------- The deprecated (#10169) mathn library leaks documentation into some core classes, or even replaces it (see example further down). I would like to fix this, but I could need some ideas what would be the best way to do that. The problem is that mathn is not a module/class which could have it's own docs, but only modifies core classes. Should I: * simply comment out the rdoc? * add sections/paragraphs directly to the affected core classes, at the appropriate place? * can `ri mathn` be made to work somehow (documentation for a source file)? * ...? Example: Math.sqrt ``` $ ri Math::sqrt (from ruby site) ------------------------------------------------------------------------------ sqrt(a) ------------------------------------------------------------------------------ Computes the square root of a. It makes use of Complex and Rational to have no rounding errors if possible. Math.sqrt(4/9) # => 2/3 Math.sqrt(- 4/9) # => Complex(0, 2/3) Math.sqrt(4.0/9.0) # => 0.666666666666667 ``` That's **not** the standard behavior of Math.sqrt and neither the documentation that is provided in `math.c`; these are the docs provided in `lib/mathn.rb`, corresponding to the behavior after `require "mathn"`. Also affected: * class documentation of Integer (mathn docs are added at some unspecified place _before_ the proper docs, https://docs.ruby-lang.org/en/trunk/Integer.html) * ditto for Math (https://docs.ruby-lang.org/en/trunk/Math.html) * ditto for Object (shows the general description of mathn: https://docs.ruby-lang.org/en/trunk/Object.html#method-i-unknown-label-mathn) * ~~internal `Math.rsqrt` method documented publicly~~ (r57744) -- 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>