From: sawadatsuyoshi@...
Date: 2014-07-20T09:39:29+00:00
Subject: [ruby-core:63894] [ruby-trunk - Bug #10049] RDoc bug for time format

Issue #10049 has been updated by Tsuyoshi Sawada.


Jared Beck wrote:
> I don't see it at ruby-doc.org, either.  Check out lib/time.rb:420 (https://github.com/ruby/ruby/blob/f75b676cc4f5411c4c1aa8cc9cb48d5dd665af6f/lib/time.rb#L420)

My bug report is about the documentation. It is about what appears in the document. It does not matter what is in the source code. Furthermore, ordinary people do not see the source code when there is a document. And if the document only lists the format once (which you claim to be only for output), it is very natural to take that as the format regardless of input or output.

Either way, it is a documentation bug.

But it is helpful that you made clear the cause of the problem.

----------------------------------------
Bug #10049: RDoc bug for time format
https://bugs.ruby-lang.org/issues/10049#change-47924

* Author: Tsuyoshi Sawada
* Status: Open
* Priority: Normal
* Assignee: 
* Category: 
* Target version: 
* ruby -v: 2.1.1
* Backport: 2.0.0: UNKNOWN, 2.1: UNKNOWN
----------------------------------------
A bug report https://bugs.ruby-lang.org/issues/8941 notes a contradiction between RDoc and Ruby behavior. If tadayoshi funaba is correct and `%Y` should be able to accept digits less than four, then the following RDoc description is a bug, and should be corrected.

    %Y - Year with century (can be negative, 4 digits at least)



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