===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/awk/awk.1,v
retrieving revision 1.56
retrieving revision 1.57
diff -c -r1.56 -r1.57
*** src/usr.bin/awk/awk.1	2020/07/24 01:57:06	1.56
--- src/usr.bin/awk/awk.1	2020/08/28 16:29:16	1.57
***************
*** 1,4 ****
! .\"	$OpenBSD: awk.1,v 1.56 2020/07/24 01:57:06 millert Exp $
  .\"
  .\" Copyright (C) Lucent Technologies 1997
  .\" All Rights Reserved
--- 1,4 ----
! .\"	$OpenBSD: awk.1,v 1.57 2020/08/28 16:29:16 millert Exp $
  .\"
  .\" Copyright (C) Lucent Technologies 1997
  .\" All Rights Reserved
***************
*** 22,28 ****
  .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
  .\" THIS SOFTWARE.
  .\"
! .Dd $Mdocdate: July 24 2020 $
  .Dt AWK 1
  .Os
  .Sh NAME
--- 22,28 ----
  .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
  .\" THIS SOFTWARE.
  .\"
! .Dd $Mdocdate: August 28 2020 $
  .Dt AWK 1
  .Os
  .Sh NAME
***************
*** 684,689 ****
--- 684,724 ----
  provides the following functions for obtaining and formatting time
  stamps.
  .Bl -tag -width indent
+ .It Fn mktime datespec
+ Converts
+ .Fa datespec
+ into a timestamp in the same form as a value returned by
+ .Fn systime .
+ The
+ .Fa datespec
+ is a string composed of six or seven numbers separated by whitespace:
+ .Bd -literal -offset indent
+ YYYY MM DD HH MM SS [DST]
+ .Ed
+ .Pp
+ The fields in
+ .Fa datespec
+ are as follows:
+ .Bl -tag -width "YYYY"
+ .It YYY
+ Year: a four-digit year, including the century.
+ .It MM
+ Month: a number from 1 to 12.
+ .It DD
+ Day: a number from 1 to 31.
+ .It HH
+ Hour: a number from 0 to 23.
+ .It MM
+ Minute: a number from 0 to 59.
+ .It SS
+ Second: a number from 0 to 60 (permitting a leap second).
+ .It DST
+ Daylight Saving Time: a positive or zero value indicates that
+ DST is or is not in effect.
+ If DST is not specified, or is negative,
+ .Fn mktime
+ will attempt to determine the correct value.
+ .El
  .It Fn strftime "[format [, timestamp]]"
  Formats
  .Ar timestamp
***************
*** 696,701 ****
--- 731,738 ----
  The
  .Ar timestamp
  must be in the same form as a value returned by
+ .Fn mktime
+ and
  .Fn systime .
  If
  .Ar timestamp
***************
*** 935,940 ****
--- 972,978 ----
  .Fn xor ,
  .Fn lshift ,
  .Fn rshift ,
+ .Fn mktime ,
  .Fn strftime
  and
  .Fn systime