Remove trailing whitespace. Use Fn when referencing functions. Sort sections.

New sentence, new line.
This commit is contained in:
wiz 2010-02-03 08:47:40 +00:00
parent cd14256881
commit 368f216930
1 changed files with 28 additions and 27 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: ctime.3,v 1.30 2010/02/02 19:04:37 christos Exp $
.\" $NetBSD: ctime.3,v 1.31 2010/02/03 08:47:40 wiz Exp $
.Dd February 2, 2010
.Dt CTIME 3
.Os
@ -70,7 +70,7 @@ After filling in the
structure,
.Fn localtime
(such as Daylight Saving Time in the United States).
After filling in the
After filling in the
.Va tm
structure,
.Fn localtime
@ -154,7 +154,7 @@ and
are determined.
.Fn mktime
returns the specified calendar time; if the calendar time cannot be
represented, it returns
represented, it returns
.Va "(time_t)-1" .
.Pp
.Fn difftime
@ -198,27 +198,27 @@ from UTC, with positive values indicating east
of the Prime Meridian.
.Sh RETURN VALUES
On success the
.Nm asctime
.Fn asctime
and
.Nm ctime
.Fn ctime
functions return a pointer to a static character buffer, and the
.Nm asctime_r
.Fn asctime_r
and
.Nm ctime_r
.Fn ctime_r
function return a pointer to the user-supplied buffer.
On failure they all return
.Dv NULL
and no errors are defined for them.
On success the
.Nm gmtime ,
.Fn gmtime ,
and
.Nm localtime
.Fn localtime
functions return a pointer to a statically allocated
.Va "struct tm"
whereas the
.Nm gmtime_r
.Fn gmtime_r
and
.Nm localtime_r
.Fn localtime_r
functions return a pointer to the user-supplied
.Va "struct tm" .
On failure they all return
@ -227,29 +227,17 @@ and the global variable
.Va errno
is set to indicate the error.
The
.Nm mktime
.Fn mktime
function returns the specified time since the Epoch as a
.Va time_t
type value. If the time cannot be represented, then
.Nm mktime
type value.
If the time cannot be represented, then
.Fn mktime
returns
.Va "(time_t)-1"
setting the global variable
.Va errno
to indicate the error.
.Sh ERRORS
The
.Nm gmtime_r ,
.Nm localtime_r ,
.Nm gmtime ,
.Nm localtime ,
and
.Nm mktime
will fail when:
.Bl -tag -width Er
.It Bq Er EOVERFLOW
The result cannot be represented.
.El
.Sh FILES
.Bl -tag -width /usr/share/zoneinfo/posixrules -compact
.It Pa /etc/localtime
@ -266,6 +254,19 @@ If
.Pa /usr/share/zoneinfo/GMT
is absent, UTC leap seconds are loaded from
.Pa /usr/share/zoneinfo/posixrules .
.Sh ERRORS
The
.Fn gmtime_r ,
.Fn localtime_r ,
.Fn gmtime ,
.Fn localtime ,
and
.Fn mktime
will fail when:
.Bl -tag -width Er
.It Bq Er EOVERFLOW
The result cannot be represented.
.El
.Sh SEE ALSO
.Xr getenv 3 ,
.Xr strftime 3 ,