From 6769d5d5accf274e211d60f01bfd8b1dd08f9ef4 Mon Sep 17 00:00:00 2001 From: zzak Date: Sun, 12 Oct 2014 18:21:41 +0000 Subject: [PATCH] * ext/date/date_core.c: [DOC] Clean up whitespace, examples, and typos in date_core based on a patch by @vipulnsward [Fixes GH-724] https://github.com/ruby/ruby/pull/724 git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@47895 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ChangeLog | 6 +++++ ext/date/date_core.c | 56 ++++++++++++++++++++++++-------------------- 2 files changed, 37 insertions(+), 25 deletions(-) diff --git a/ChangeLog b/ChangeLog index b1955c3582..fb34fcea38 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Mon Oct 13 03:20:23 2014 Zachary Scott + + * ext/date/date_core.c: [DOC] Clean up whitespace, examples, and typos + in date_core based on a patch by @vipulnsward [Fixes GH-724] + https://github.com/ruby/ruby/pull/724 + Mon Oct 13 02:39:26 2014 Nobuyoshi Nakada * parse.y (remove_duplicate_keys): should not simply eliminate all diff --git a/ext/date/date_core.c b/ext/date/date_core.c index 835120631a..9ef5160b19 100644 --- a/ext/date/date_core.c +++ b/ext/date/date_core.c @@ -9051,7 +9051,7 @@ Init_date_core(void) * The calendar week is a seven day period within a calendar year, * starting on a Monday and identified by its ordinal number within * the year; the first calendar week of the year is the one that - * includes the first Thursday of that year. In the Gregorian + * includes the first Thursday of that year. In the Gregorian * calendar, this is equivalent to the week which includes January 4. * * In those classes, this so-called "commercial". @@ -9062,8 +9062,8 @@ Init_date_core(void) * time) on January 1, 4713 BCE (in the Julian calendar). * * In this document, the astronomical Julian day number is same as the - * original Julian day number. And the chronological Julian day - * number is a variation of the Julian day number. Its days begin at + * original Julian day number. And the chronological Julian day + * number is a variation of the Julian day number. Its days begin at * midnight on local time. * * In this document, when the term "Julian day number" simply appears, @@ -9079,9 +9079,9 @@ Init_date_core(void) * Gregorian calendar). * * In this document, the astronomical modified Julian day number is - * same as the original modified Julian day number. And the + * same as the original modified Julian day number. And the * chronological modified Julian day number is a variation of the - * modified Julian day number. Its days begin at midnight on local + * modified Julian day number. Its days begin at midnight on local * time. * * In this document, when the term "modified Julian day number" simply @@ -9090,10 +9090,9 @@ Init_date_core(void) * * In those classes, this is so-called "mjd". * - * * == Date * - * A subclass of Object includes Comparable module, easily handles + * A subclass of Object that includes Comparable module and easily handles * date. * * Date object is created with Date::new, Date::jd, Date::ordinal, @@ -9102,14 +9101,20 @@ Init_date_core(void) * * require 'date' * - * Date.new(2001,2,3) #=> # - * Date.jd(2451944) #=> # - * Date.ordinal(2001,34) #=> # - * Date.commercial(2001,5,6) #=> # - * Date.parse('2001-02-03') #=> # + * Date.new(2001,2,3) + * #=> # + * Date.jd(2451944) + * #=> # + * Date.ordinal(2001,34) + * #=> # + * Date.commercial(2001,5,6) + * #=> # + * Date.parse('2001-02-03') + * #=> # * Date.strptime('03-02-2001', '%d-%m-%Y') - * #=> # - * Time.new(2001,2,3).to_date #=> # + * #=> # + * Time.new(2001,2,3).to_date + * #=> # * * All date objects are immutable; hence cannot modify themselves. * @@ -9117,11 +9122,11 @@ Init_date_core(void) * of the day count, the offset and the day of calendar reform. * * The day count denotes the absolute position of a temporal - * dimension. The offset is relative adjustment, which determines - * decoded local time with the day count. The day of calendar - * reform denotes the start day of the new style. The old style + * dimension. The offset is relative adjustment, which determines + * decoded local time with the day count. The day of calendar + * reform denotes the start day of the new style. The old style * of the West is the Julian calendar which was adopted by - * Caersar. The new style is the Gregorian calendar, which is the + * Caesar. The new style is the Gregorian calendar, which is the * current civil calendar of many countries. * * The day count is virtually the astronomical Julian day number. @@ -9162,10 +9167,10 @@ Init_date_core(void) * * == DateTime * - * A subclass of Date easily handles date, hour, minute, second and + * A subclass of Date that easily handles date, hour, minute, second and * offset. * - * DateTime does not consider any leapseconds, does not track + * DateTime does not consider any leap seconds, does not track * any summer time rules. * * DateTime object is created with DateTime::new, DateTime::jd, @@ -9177,7 +9182,7 @@ Init_date_core(void) * DateTime.new(2001,2,3,4,5,6) * #=> # * - * The last element of day, hour, minute or senond can be + * The last element of day, hour, minute or second can be * fractional number. The fractional number's precision is assumed * at most nanosecond. * @@ -9185,14 +9190,15 @@ Init_date_core(void) * #=> # * * An optional argument the offset indicates the difference - * between the local time and UTC. For example, Rational(3,24) + * between the local time and UTC. For example, Rational(3,24) * represents ahead of 3 hours of UTC, Rational(-5,24) represents - * behind of 5 hours of UTC. The offset should be -1 to +1, and - * its precision is assumed at most second. The default value is - * zero (equals to UTC). + * behind of 5 hours of UTC. The offset should be -1 to +1, and + * its precision is assumed at most second. The default value is + * zero(equals to UTC). * * DateTime.new(2001,2,3,4,5,6,Rational(3,24)) * #=> # + * * also accepts string form. * * DateTime.new(2001,2,3,4,5,6,'+03:00')