Missing documentation for some extern variables in time.h

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

Missing documentation for some extern variables in time.h

Andras Farkas
In this diff
https://github.com/openbsd/src/commit/c9da469ac9133c60159589ec32d42d777401961c
the external variables daylight and timezone were added to time.h.
However, they're not documented in any man page.
In contrast, the external variable tzname is described in ctime.3:
https://man.openbsd.org/ctime.3
I think daylight and timezone could also be described in ctime.3

An alternative is that all three of time.h's extern variables could be
documented in tzset.3
https://man.openbsd.org/tzset.3
I see this approach taken in Solaris man pages and POSIX.
https://docs.oracle.com/cd/E88353_01/html/E37843/ctime-3c.html
https://pubs.opengroup.org/onlinepubs/9699919799/functions/tzset.html