From: nobu@... Date: 2016-03-31T02:01:44+00:00 Subject: [ruby-core:74731] [Ruby trunk Bug#12233] Please consider adding documentation to DateTime, one line, require 'date' Issue #12233 has been updated by Nobuyoshi Nakada. Tracker changed from Misc to Bug Backport set to 2.1: REQUIRED, 2.2: REQUIRED, 2.3: REQUIRED ---------------------------------------- Bug #12233: Please consider adding documentation to DateTime, one line, require 'date' https://bugs.ruby-lang.org/issues/12233#change-57866 * Author: Robert A. Heiler * Status: Open * Priority: Normal * Assignee: * ruby -v: * Backport: 2.1: REQUIRED, 2.2: REQUIRED, 2.3: REQUIRED ---------------------------------------- The ruby DateTime page does not include this line: require 'date' It just happened on IRC right now (I edited/truncated a bit here): Can anyone tell me why in irb Date/Time/DateTime gives me NameError: uninitialized constant DateTime schemanic: because you forgot to require 'date'? though, Time in that list won't give you a NameError sigh. Okay. I'm sorry - the Ruby doc code example didn't have the requirement statement The documentation can be found here: http://ruby-doc.org/stdlib/libdoc/date/rdoc/DateTime.html http://ruby-doc.org/stdlib-2.3.0/libdoc/date/rdoc/DateTime.html I suggest to add the require 'date' close to the top of that page, to help newcomers not be too confused about how to use it. PS: On a side note, perhaps another subsection could be added to the ruby bug/issue tracker here, a subsection solely for docs? That way, people could report suggestions to improve the documentation there. Anyway that's just a semi-random suggestion. :) -- https://bugs.ruby-lang.org/ Unsubscribe: