diff --git a/docs/reference/glib/tmpl/date.sgml b/docs/reference/glib/tmpl/date.sgml
index 54b38cbfb..ca8202058 100644
--- a/docs/reference/glib/tmpl/date.sgml
+++ b/docs/reference/glib/tmpl/date.sgml
@@ -52,10 +52,7 @@ representation is valid. Sometimes neither is valid. Use the API.
-GLib doesn't contain any time-manipulation functions; however, there
-is a #GTime typedef and a #GTimeVal struct which represents a more
-precise time (with microseconds). You can request the current time as
-a #GTimeVal with g_get_current_time().
+GLib also features #GDateTime which represents a precise time.
@@ -84,6 +81,12 @@ Similar to the struct timeval returned by
the gettimeofday() UNIX call.
+
+GLib is attempting to unify around the use of 64bit integers to
+represent microsecond-precision time. As such, this type will be
+removed from a future version of GLib.
+
+
@tv_sec: seconds
@tv_usec: microseconds