From d60451bc9e7e2f3593581db19b395b3a5cceebdd Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Fri, 21 Oct 2016 18:20:50 -0700 Subject: [PROPOSED PATCH] * localtime.c (time): Explain naming. --- localtime.c | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/localtime.c b/localtime.c index 5dba623..385b6bb 100644 --- a/localtime.c +++ b/localtime.c @@ -2268,7 +2268,12 @@ posix2time(time_t t) which is called 'time_t' in this file. Typically, this merely converts the time's integer width. On some platforms, the system time is local time not UT, or uses some epoch other than the POSIX - epoch. */ + epoch. + + Although this code appears to define a function named 'time' that + returns time_t, the macros in private.h cause this code to actually + define a function named 'tz_time' that returns tz_time_t. The call + to sys_time invokes the underlying system's 'time' function. */ time_t time(time_t *p) -- 2.7.4