manpage: input: clarify chapter-metadata property

1 files changed, 8 insertions, 2 deletions

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``.