From: eloyesp@...
Date: 2014-08-05T19:35:45+00:00
Subject: [ruby-core:64208] [ruby-trunk - Bug #10105] Mixed styles for class methods on Tempfile break RDocs.

Issue #10105 has been updated by Eloy Esp.


I don't think that it is only a bug in RDoc.

There are at least 3 ways to define class methods in ruby, and I think that all are acceptable, but define two class methods in different ways in the standard library it's not a good example, nor a good practice and does not help in readability.

Ok, there is a lacking feature in RDoc, but I don't think that keeping it that way is the way to go.

----------------------------------------
Bug #10105: Mixed styles for class methods on Tempfile break RDocs.
https://bugs.ruby-lang.org/issues/10105#change-48206

* Author: Eloy Esp
* Status: Third Party's Issue
* Priority: Normal
* Assignee: Eric Hodel
* Category: doc
* Target version: 
* ruby -v: 2.1.1
* Backport: 2.0.0: UNKNOWN, 2.1: UNKNOWN
----------------------------------------
I've already made a little pull request here https://github.com/ruby/ruby/pull/691.

The diff is here: https://github.com/ruby/ruby/pull/691.diff

But to make the real changes clear is it better to ignore white-space (as there are many indentation changes).

Changes ignoring white-space: https://github.com/ruby/ruby/pull/691/files?w=1

Regards.



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