Index: lib/libc/sys/gettimeofday.2
===================================================================
--- lib/libc/sys/gettimeofday.2
+++ lib/libc/sys/gettimeofday.2
@@ -28,7 +28,7 @@
 .\"     @(#)gettimeofday.2	8.2 (Berkeley) 5/26/95
 .\" $FreeBSD$
 .\"
-.Dd October 27, 2018
+.Dd March 4, 2020
 .Dt GETTIMEOFDAY 2
 .Os
 .Sh NAME
@@ -44,6 +44,14 @@
 .Ft int
 .Fn settimeofday "const struct timeval *tp" "const struct timezone *tzp"
 .Sh DESCRIPTION
+.Em Note :
+The
+.Nm
+function is obsolescent.
+See the
+.Sx STANDARDS
+section for more details.
+.Pp
 The system's notion of the current Greenwich time and the current time
 zone is obtained with the
 .Fn gettimeofday
@@ -125,6 +133,18 @@
 .Xr timeradd 3 ,
 .Xr clocks 7 ,
 .Xr timed 8
+.Sh STANDARDS
+The
+.Nm
+function is considered obsolescent and its usage discouraged by
+.\" XXX: This should be replaced in the future when an appropriate argument to
+.\" the St macro is available: -p1003.1-2017
+.No IEEE Std 1003.1-2008, 2017 Edition (\\(LqPOSIX.1\\(Rq) .
+Application should use the
+.Xr clock_gettime 2
+function instead as
+.Nm
+might be removed in the future.
 .Sh HISTORY
 The
 .Fn gettimeofday