From b06b2d5855555b28a686a6c073b365c6538108db Mon Sep 17 00:00:00 2001
From: Carl Hetherington <cth@carlh.net>
Date: Wed, 15 Oct 2025 21:17:38 +0200
Subject: Add some closed caption details to the manual.

---
 doc/manual/dcpomatic.xml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml
index 975d8bb7c..28936c2c3 100644
--- a/doc/manual/dcpomatic.xml
+++ b/doc/manual/dcpomatic.xml
@@ -1390,6 +1390,26 @@ only limited control is available for subtitles rendered by the
 projection system.
 </para>
 
+<section>
+<title>Closed captions</title>
+
+<para>If you choose <guilabel>closed captions</guilabel> or <guilabel>closed subtitles</guilabel>
+the timed text options will change a little, because then your captions or subtitles will be
+displayed on a dedicated display device, rather than on screen.</para>
+
+<para>Firstly, with closed captions you can no longer burn into the image, nor adjust font or
+appearance.  Closed caption displays usually do not allow different fonts or letter appearance.
+The position, scale and line spacing options are also disabled, for the same reason.</para>
+
+<para>Secondly, there is a new <guilabel>Track</guilabel> control.  This is because with some
+closed caption devices the viewer can choose one of several tracks to look at (perhaps in the
+language of their choice).  For each piece of closed caption content you will need to choose
+a track, creating a new one (by clicking on the drop-down and choosing <guilabel>Add new...</guilabel>)
+if required.  Adding a new track will prompt you for a name (which can be anything) and the
+language that the track is in.</para>
+
+</section>
+
 </section>
 
 
-- 
cgit v1.2.3