docs: Recommend against using GTimeVal

diff --git a/docs/reference/glib/tmpl/date.sgml b/docs/reference/glib/tmpl/date.sgml
index 54b38cb..ca82020 100644 (file)
--- 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.
 </para>
 
 <para>
-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.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -84,6 +81,12 @@ Similar to the <structname>struct timeval</structname> returned by
 the <function>gettimeofday()</function> UNIX call.
 </para>
 
+<para>
+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.
+</para>
+
 @tv_sec: seconds
 @tv_usec: microseconds