From 0d74bd6eefc9f03b22d5f1984e405a08f30be416 Mon Sep 17 00:00:00 2001
From: Kevin Ryde <user42@zip.com.au>
Date: Sun, 25 Jun 2006 01:05:55 +0000
Subject: [PATCH] (Time): In tm:gmtoff, give example values, note not the same
 as C tm_gmtoff.

---
 doc/ref/posix.texi | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/ref/posix.texi b/doc/ref/posix.texi
index 6a1d0f1b2..0cb735241 100644
--- a/doc/ref/posix.texi
+++ b/doc/ref/posix.texi
@@ -1170,6 +1170,13 @@ Daylight saving indicator (0 for ``no'', greater than 0 for ``yes'', less than
 @deffn {Scheme Procedure} tm:gmtoff tm
 @deffnx {Scheme Procedure} set-tm:gmtoff tm val
 Time zone offset in seconds west of @acronym{UTC} (-46800 to 43200).
+For example on East coast USA (zone @samp{EST+5}) this would be 18000
+(ie.@: @m{5\times60\times60,5*60*60}) in winter, or 14400
+(ie.@: @m{4\times60\times60,4*60*60}) during daylight savings.
+
+Note @code{tm:gmtoff} is not the same as @code{tm_gmtoff} in the C
+@code{tm} structure.  @code{tm_gmtoff} is seconds east and hence the
+negative of the value here.
 @end deffn
 @deffn {Scheme Procedure} tm:zone tm
 @deffnx {Scheme Procedure} set-tm:zone tm val