[Octave-bug-tracker] [bug #53908] Omissions in Documentation of tm_struct

[Ian McCallion]

URL:
  <http://savannah.gnu.org/bugs/?53908>

                 Summary: Omissions in Documentation of tm_struct
                 Project: GNU Octave
            Submitted by: ianmcc
            Submitted on: Tue 15 May 2018 11:50:00 AM UTC
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
             Assigned to: None
         Originator Name: 
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: 4.4.0
        Operating System: Any

    _______________________________________________________

Details:

A. I'm in the UK and on Windows (4.2.2 and 4.4.0):
> >> localtime(time)
>     usec =  178342
>     sec =  59
>     min =  32
>     hour =  8
>     mday =  12
>     mon =  4
>     year =  118
>     wday =  6
>     yday =  131
>     isdst =  1
>     gmtoff = 0
>     zone = GMT Daylight Time
Clearly gmtoff should be 1 as it is currently daylight time. 

I would suggest this is a code bug. However I have been asked to submit it as
a documentation bug with the fix being to state at the start of section 36.1
of the manual that gmtoff is not implemented in Windows.

B. The mktime function takes a tm_struct as parameter. However the values for
gmtoff and zone are ignored. This is working as designed (because mktime uses
the TZ environment variable to obtain timezone information). This fact should
be mentioned in the documentation.





    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?53908>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/