From a5194c5b2ea218a35025f5b1d241c0516eb86e85 Mon Sep 17 00:00:00 2001
From: Thomas Lauf <thomas.lauf@tngtech.com>
Date: Thu, 29 Dec 2022 16:18:30 +0100
Subject: [PATCH] Update documentation on dates and durations

Relates to #252

Signed-off-by: Thomas Lauf <thomas.lauf@tngtech.com>
---
 doc/man7/timew-dates.7.adoc     | 9 +++++----
 doc/man7/timew-durations.7.adoc | 2 +-
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/doc/man7/timew-dates.7.adoc b/doc/man7/timew-dates.7.adoc
index 84657540..80f5fa61 100644
--- a/doc/man7/timew-dates.7.adoc
+++ b/doc/man7/timew-dates.7.adoc
@@ -6,7 +6,8 @@ timew-dates - date formats supported by Timewarrior
 == SYNOPSIS
 
 == DESCRIPTION
-Timewarrior supports the following date formats based on ISO-8601:
+Timewarrior supports the following datetime formats based on ISO-8601.
+If times are followed by a 'Z', they are assumed to be in UTC, otherwise local time (TZ) is assumed.
 
   <extended-date> [T <extended-time>]   Extended date, optional extended time
   <date> [T <time>]                     Date, optional time
@@ -37,7 +38,8 @@ time::
     hhmm[ss]Z                           Hour, minutes, optional seconds, UTC
     hhmm[ss][+/-hh[mm]]                 Hour, minutes, optional seconds, TZ
 
-Examples:
+== EXAMPLES
+Here are some examples for ISO datetimes:
 
   2016-06-09T08:12:00Z
   2016-06T08:12:00+01:00
@@ -90,14 +92,13 @@ In addition to the standard date formats, the following are supported:
   midsommarafton                        midnight, 1st Friday after 19th June
   juhannus                              midnight, 1st Friday after 19th June
 
-Examples:
+For times, the following are also possible:
 
   8am
   24th
   monday
   august
 
-
 == SEE ALSO
 **timew-durations**(7),
 **timew-hints**(7)
diff --git a/doc/man7/timew-durations.7.adoc b/doc/man7/timew-durations.7.adoc
index e3a0696e..0d3642c0 100644
--- a/doc/man7/timew-durations.7.adoc
+++ b/doc/man7/timew-durations.7.adoc
@@ -57,4 +57,4 @@ Examples:
   10d           10 days
 
 Note that the year, quarter and month terms are imprecise, being defined as 365d, 91d and 30d respectively.
-For precision use the other terms.
\ No newline at end of file
+For precision use the other terms.