From b4ab9f4adc9dd10d0f1a33286d78821da580a4d1 Mon Sep 17 00:00:00 2001 From: ancient-skyscraper Date: Thu, 9 Mar 2023 14:16:56 -0500 Subject: Update documentation and CLI UI with hint info Goal is to explain what hints are, and how the `--hints` option changes behavior of `dcpomatic2_cli` command --- doc/manual/dcpomatic.xml | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml index dd59facfa..81321a83d 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -320,7 +320,20 @@ making the DCP. Choose Make DCP from the -Jobs menu. DCP-o-matic will encode your DCP. +Jobs menu. Before encoding your DCP, DCP-o-matic +will run a series of checks on your film to look for various conditions +that might cause problems when playing back the DCP. If any potential +problems are found, DCP-o-matic will show you a list of hints. +Each hint describes the condition that was found and gives +advice on how to resolve it. If hints are found and reported, you can +either Make DCP anyway (without adjusting any +settings), or Go back in order to make +adjustments before encoding the DCP. + + + +If no hints were found (or you pressed Make DCP +after hints were displayed), DCP-o-matic will encode your DCP. This may take some time (many hours in some cases). While the job is in progress, DCP-o-matic will update you on how it is getting on with the progress bar in the bottom of its window, as shown in