From f6ed2468264931869d46f6905beaeb92ce9cf7e8 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Wed, 19 Feb 2014 16:32:54 +0100
Subject: manpage: input: clarify chapter-metadata property

---
 DOCS/man/en/input.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

(limited to 'DOCS')

diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index a004333a58..dc31ea081e 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -671,8 +671,14 @@ an option at runtime.
     welcome how exactly this property should work.
 
 ``chapter-metadata``
-    Metadata of current chapter. Works similar to ``metadata`` property. This
-    also allows referring to a key directly.
+    Metadata of current chapter. Works similar to ``metadata`` property. IT
+    also allows the same access methods (using sub-properties).
+
+    Per-chapter metadata is very rare. Usually, only the chapter name
+    (``title``) is set.
+
+    For accessing other information, like chapter start, see the
+    ``chapter-list`` property.
 
 ``pause`` (RW)
     Pause status. This is usually ``yes`` or ``no``. See ``--pause``.
-- 
cgit v1.2.3