Commit b4da1fa5 authored by Timothy Gu's avatar Timothy Gu Committed by Stefano Sabatini

doc/utils: rewrite doc for time duration syntax

Extend description and clarify syntax.
Signed-off-by: 's avatarTimothy Gu <timothygu99@gmail.com>
Signed-off-by: 's avatarStefano Sabatini <stefasab@gmail.com>
parent d0b7d24b
...@@ -96,14 +96,42 @@ year-month-day. ...@@ -96,14 +96,42 @@ year-month-day.
@anchor{time duration syntax} @anchor{time duration syntax}
@section Time duration @section Time duration
The accepted syntax is: There are two accepted syntaxes for expressing time duration.
@example
[-][@var{HH}:]@var{MM}:@var{SS}[.@var{m}...]
@end example
@var{HH} expresses the number of hours, @var{MM} the number of minutes
for a maximum of 2 digits, and @var{SS} the number of seconds for a
maximum of 2 digits. The @var{m} at the end expresses decimal value for
@var{SS}.
@emph{or}
@example @example
[-][HH:]MM:SS[.m...] [-]@var{S}+[.@var{m}...]
[-]S+[.m...]
@end example @end example
@var{HH} expresses the number of hours, @var{MM} the number a of minutes @var{S} expresses the number of seconds, with the optional decimal part
and @var{SS} the number of seconds. @var{m}.
In both expressions, the optional @samp{-} indicates negative duration.
@subsection Examples
The following examples are all valid time duration:
@table @samp
@item 55
55 seconds
@item 12:03:45
12 hours, 03 minutes and 45 seconds
@item 23.189
23.189 seconds
@end table
@anchor{video size syntax} @anchor{video size syntax}
@section Video size @section Video size
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment