Research V4 development

Work on file man/man3/ctime.3

Synthesized-from: v4

diff --git a/man/man3/ctime.3 b/man/man3/ctime.3
new file mode 100644 (file)
index 0000000..60892c5
--- /dev/null
+++ b/man/man3/ctime.3
@@ -0,0 +1,118 @@
+.th CTIME III 10/15/73
+.sh NAME
+ctime  \*-  convert date and time to ASCII
+.sh SYNOPSIS
+.ft B
+char *ctime(tvec)
+.br
+int tvec[2];
+.s3
+.ft R
+[from Fortran]
+.br
+.ft B
+double precision ctime
+.br
+.li
+... = ctime(dummy)
+.s3
+int *localtime(tvec)
+.br
+int tvec[2];
+.s3
+int *gmtime(tvec)
+.br
+int tvec[2];
+.br
+.ft R
+.sh DESCRIPTION
+.it Ctime
+converts a time in the vector
+.it tvec
+such as returned by time (II)
+into ASCII
+and returns a pointer to a
+character string
+in the form
+.s3
+    Sun Sep 16 01:03:52 1973\\n\\0
+.s3
+All the fields have constant width.
+.s3
+Once the time has been placed into
+.it t
+and
+.it t+2,
+this routine is callable from assembly language
+as follows:
+.s3
+.nf
+.ft B
+       mov     $t,\*-(sp)
+       jsr     pc,\*_ctime
+       tst     (sp)+
+.s3
+.ft R
+.fi
+and a pointer to the string is available in r0.
+.s3
+The
+.it localtime
+and
+.it gmtime
+entries return integer vectors to the broken-down time.
+.it Localtime
+corrects for the time zone and possible daylight savings time;
+.it gmtime
+converts directly to GMT, which is the time UNIX uses.
+The value is a pointer
+to an array whose components are
+.s3
+.lp +5 5
+0      seconds
+.lp +5 5
+1      minutes
+.lp +5 5
+2      hours
+.lp +5 5
+3      day of the month (1-31)
+.lp +5 5
+4      month (0-11)
+.lp +5 5
+5      year \*- 1900
+.lp +5 5
+6      day of the week (Sunday = 0)
+.lp +5 5
+7      day of the year (0-365)
+.lp +5 5
+8      Daylight Saving Time flag if non-zero
+.i0
+.s3
+The external variable
+.it timezone
+contains the difference, in seconds, between GMT and local
+standard time (in EST, is 5*60*60);
+the external variable
+.it daylight
+is non-zero iff the standard U.S.A. Daylight
+Saving Time conversion should be applied
+between the last Sundays in April and October.
+The external variable
+.it nixonflg
+if non-zero
+supersedes
+.it daylight
+and causes daylight time all year round.
+.s3
+A routine named
+.it ctime
+is also available from Fortran.
+Actually it more resembles the
+.it time
+(II) system entry in that it returns the number of seconds
+since the epoch
+0000 GMT Jan. 1, 1970
+(as a floating-point number).
+.sh "SEE ALSO"
+time(II)
+.sh BUGS