From 00c18dc01d0a8cb9987d8adb6f74694dbfde3211 Mon Sep 17 00:00:00 2001
From: Johannes Nussbaum <39048939+jnussbaum@users.noreply.github.com>
Date: Wed, 23 Feb 2022 08:51:22 +0100
Subject: [PATCH] docs: explain the interval-prop more precisely (#162)

---
 docs/dsp-tools-xmlupload.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/docs/dsp-tools-xmlupload.md b/docs/dsp-tools-xmlupload.md
index b9c3eb836..47b3712ad 100644
--- a/docs/dsp-tools-xmlupload.md
+++ b/docs/dsp-tools-xmlupload.md
@@ -547,8 +547,8 @@ Example:
 
 ### &lt;interval-prop&gt;
 
-The `<interval-prop>` element is used for intervals between two decimal numbers. It must contain at least one
-`<interval>` element.
+The `<interval-prop>` element is used for intervals with a start and an end point on a timeline, e.g. relative to the beginning of an audio or video file. 
+An `<interval-prop>`  must contain at least one `<interval>` element.
 
 Attributes:
 
@@ -556,7 +556,9 @@ Attributes:
 
 #### &lt;interval&gt;
 
-The `<interval>` element contains two decimals separated by a colon (`:`).
+A time interval is represented by plain decimal numbers (=seconds), without a special notation for minutes and hours. 
+The `<interval>` element contains two decimals separated by a colon (`:`). The places before the decimal point are 
+seconds, and the places after the decimal points are fractions of a second.
 
 Attributes:
 
@@ -567,7 +569,8 @@ Example:
 
 ```xml
 <interval-prop name=":hasInterval">
-  <interval>1.5:3.12</interval>
+  <interval>60.5:120.5</interval>          <!-- 0:01:00.5 - 0:02:00.5 -->
+  <interval>61:3600</interval>             <!-- 0:01:01 - 1:00:00 -->
 </interval-prop>
 ```