From aa43405020e2e710b8b431633b6750e92897c6b9 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Mon, 25 Mar 2013 20:32:29 +0100
Subject: screenshot: make it possible to format playback time in various ways

---
 DOCS/man/en/options.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

(limited to 'DOCS')

diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index e1134ef864..8ed9ba8066 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -1880,6 +1880,29 @@
             numbers would be more intuitive, but are not easily implementable
             because container formats usually use time stamps for identifying
             frames.)
+    ``%w{X}``
+        Specify the current playback time using the format string ``X``. The
+        nested time format string is contained within ``{`` and ``}``.
+        ``%p`` is like ``%w{%H:%M:%S}``, and ``%P`` is like ``%w{%H:%M:%S.%T}``.
+
+        Valid format specifiers:
+            ``%H``
+                hour (padded with 0 to two digits)
+            ``%h``
+                hour (not padded)
+            ``%M``
+                minutes (00-59)
+            ``%m``
+                total minutes (includes hours, unlike ``%M``)
+            ``%S``
+                seconds (00-59)
+            ``%s``
+                total seconds (includes hours and minutes)
+            ``%f``
+                like ``%s``, but as float
+            ``%T``
+                milliseconds (000-999)
+
     ``%tX``
         Specify the current local date/time using the format ``X``. This format
         specifier uses the UNIX ``strftime()`` function internally, and inserts
-- 
cgit v1.2.3