Document that Timezone argument for Time uses dst? if available [ci skip]

1 files changed, 4 insertions, 1 deletions

diff --git a/time.c b/time.c
index ed7928848c..7f39799bed 100644
--- a/time.c
+++ b/time.c
@@ -5703,7 +5703,7 @@ rb_time_zone_abbreviation(VALUE zone, VALUE time)
  *  == Timezone argument
  *
  *  A timezone argument must have +local_to_utc+ and +utc_to_local+
- *  methods, and may have +name+ and +abbr+ methods.
+ *  methods, and may have +name+, +abbr+, and +dst?+ methods.
  *
  *  The +local_to_utc+ method should convert a Time-like object from
  *  the timezone to UTC, and +utc_to_local+ is the opposite.  The
@@ -5722,6 +5722,9 @@ rb_time_zone_abbreviation(VALUE zone, VALUE time)
  *
  *  The +abbr+ method is used by '%Z' in #strftime.
  *
+ *  The +dst?+ method is called with a +Time+ value and should return whether
+ *  the +Time+ value is in daylight savings time in the zone.
+ *
  *  === Auto conversion to Timezone
  *
  *  At loading marshaled data, a timezone name will be converted to a timezone