From 10ae6ece368d1c0e3782cfa596b1741dabb2bfe1 Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Sat, 23 Jun 2001 08:57:40 +0000 Subject: Document "normalizing" behavior of mktime(3). PR: bin/28313 Reviewed by: bde, wollman MFC after: 1 week --- lib/libc/stdtime/ctime.3 | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) (limited to 'lib/libc/stdtime') diff --git a/lib/libc/stdtime/ctime.3 b/lib/libc/stdtime/ctime.3 index 989db255f54e3..94f0622515fd1 100644 --- a/lib/libc/stdtime/ctime.3 +++ b/lib/libc/stdtime/ctime.3 @@ -196,7 +196,18 @@ The original values of the and .Fa tm_yday components of the structure are ignored, and the original values of the -other components are not restricted to their normal ranges. +other components are not restricted to their normal ranges, and will be +normalized if needed. +For example, +October 40 is changed into November 9, +a +.Fa tm_hour +of \-1 means 1 hour before midnight, +.Fa tm_mday +of 0 means the day preceding the current month, and +.Fa tm_mon +of \-2 means 2 months before January of +.Fa tm_year . (A positive or zero value for .Fa tm_isdst causes -- cgit v1.3