Various manual updates.
authorCarl Hetherington <cth@carlh.net>
Sun, 13 Jan 2019 23:46:41 +0000 (23:46 +0000)
committerCarl Hetherington <cth@carlh.net>
Sun, 13 Jan 2019 23:46:41 +0000 (23:46 +0000)
19 files changed:
doc/manual/dcpomatic.xml
doc/manual/screenshots/audio-tab.png
doc/manual/screenshots/dcp-tab.png
doc/manual/screenshots/examine-content.png
doc/manual/screenshots/file-new.png
doc/manual/screenshots/filters.png
doc/manual/screenshots/kdm-creator.png
doc/manual/screenshots/kdm.png
doc/manual/screenshots/making-dcp.png
doc/manual/screenshots/prefs-advanced.png
doc/manual/screenshots/prefs-cover-sheet.png
doc/manual/screenshots/prefs-defaults.png
doc/manual/screenshots/prefs-general.png
doc/manual/screenshots/prefs-kdm-email.png
doc/manual/screenshots/prefs-keys.png
doc/manual/screenshots/prefs-servers.png
doc/manual/screenshots/prefs-tms.png
doc/manual/screenshots/video-tab.png
src/lib/config.cc

index 1519562fdc4aedc20dae6ae65085e3f6185c2169..1b9418c7845eb10f6e26ad39583d8e49b11abf19 100644 (file)
@@ -32,7 +32,7 @@ Hello, and welcome to DCP-o-matic!
   <listitem>Creation of <ulink
   url="http://en.wikipedia.org/wiki/Digital_Cinema_Package">Digital
   Cinema Packages</ulink> (DCPs) from video, audio and/or
-  subtitle files.</listitem>
+  subtitle and closed caption files.</listitem>
   <listitem>Playback and verification of DCPs on a PC/Mac.</listitem>
   <listitem>Creation of KDMs for DCPs.</listitem>
 </itemizedlist>
@@ -119,7 +119,7 @@ Windows version.
 
 <para>
 DCP-o-matic will run on Mac OS X version 10.6 (Snow Leopard) and
-higher.  DCP-o-matic is split into four separate applications, each of
+higher.  DCP-o-matic is split into five separate applications, each of
 which can be installed by downloading the <code>.dmg</code>,
 double-clicking to open and then dragging the icon to your
 <guilabel>Applications</guilabel> folder.
@@ -142,7 +142,7 @@ with the first (main) part.
 
 <itemizedlist>
   <listitem>Debian 7 (&lsquo;wheezy&rsquo;), 8 (&lsquo;jessie&rsquo;), 9 (&lsquo;squeeze&rsquo;) and unstable (&lsquo;sid&rsquo;)</listitem>
-  <listitem>Ubuntu 14.04 (&lsquo;Trusty Tahr&rsquo;), 16.04 (&lsquo;Xenial Xerus&rsquo;) and 18.04 (&lsquo;Bionic Beaver&rsquo;)</listitem>
+  <listitem>Ubuntu 14.04 (&lsquo;Trusty Tahr&rsquo;), 16.04 (&lsquo;Xenial Xerus&rsquo;), 18.04 (&lsquo;Bionic Beaver&rsquo;) and 18.10 (&lsquo;Cosmic Cuttlefish&rsquo;)</listitem>
   <listitem>Mint 17, 18 and 19</listitem>
 </itemizedlist>
 
@@ -281,7 +281,7 @@ shown in <xref linkend="fig-file-new"/>.
   <title>Creating a new film</title>
   <mediaobject>
     <imageobject>
-      <imagedata fileref="screenshots/file-new&scs;"/>
+      <imagedata scale="250" fileref="screenshots/file-new&scs;"/>
     </imageobject>
   </mediaobject>
 </figure>
@@ -397,7 +397,7 @@ linkend="fig-making-dcp"/>.
   <title>Making the DCP</title>
   <mediaobject>
     <imageobject>
-      <imagedata scale="50" fileref="screenshots/making-dcp&scs;"/>
+      <imagedata scale="250" fileref="screenshots/making-dcp&scs;"/>
     </imageobject>
   </mediaobject>
 </figure>
index 07e1dfd6710a90881cb523d3651c08e539f08c1b..b28a71e67f1ff6bfa6d502c944ef3c0b16e031c9 100644 (file)
Binary files a/doc/manual/screenshots/audio-tab.png and b/doc/manual/screenshots/audio-tab.png differ
index 9851e6760447159641a624a12d5ace16597ff045..9bee689499571ad49c2cdfba5d24e52a49a4eb6c 100644 (file)
Binary files a/doc/manual/screenshots/dcp-tab.png and b/doc/manual/screenshots/dcp-tab.png differ
index 68a4f638916d3a840c28736181af7640e199372a..8aaff26d80063c806e7b1958d8425f45348ee296 100644 (file)
Binary files a/doc/manual/screenshots/examine-content.png and b/doc/manual/screenshots/examine-content.png differ
index 1a8a23eac7226763297ad6191489651620e80295..8e2c6ea56f7324d0e16bde17e68a739e2a8a8497 100644 (file)
Binary files a/doc/manual/screenshots/file-new.png and b/doc/manual/screenshots/file-new.png differ
index b7dae35d3bd452b632e645a59a6f4b14dc63c4a9..daabf15a79a45ff0d9c33e85f30d7a95ea36a122 100644 (file)
Binary files a/doc/manual/screenshots/filters.png and b/doc/manual/screenshots/filters.png differ
index b46581a11406929a10259caa26c5e8ac01c66ccb..29bd6048f5f985f76f93a3560a5849d0ee8dd9bf 100644 (file)
Binary files a/doc/manual/screenshots/kdm-creator.png and b/doc/manual/screenshots/kdm-creator.png differ
index 53ad06fb02bdd493423e1e6054e040a8e01fb7dc..89e982bfed29ff9159240a2cb9152507f384d839 100644 (file)
Binary files a/doc/manual/screenshots/kdm.png and b/doc/manual/screenshots/kdm.png differ
index 0f52f1131f74650ec15963717605500eec23830d..52f5a08863228b7ba15dbd3fb335f969aa9c638c 100644 (file)
Binary files a/doc/manual/screenshots/making-dcp.png and b/doc/manual/screenshots/making-dcp.png differ
index cbedb1ea7a035ad79aa90405b2cfcd424651edbb..538dfc1c0b46bcac309f818ee5ade94f57c3c42e 100644 (file)
Binary files a/doc/manual/screenshots/prefs-advanced.png and b/doc/manual/screenshots/prefs-advanced.png differ
index 70337d6b3b4726b157227cdf4041c7f0131d0400..c1103a5c519807ad2d08d52fa50c531473debc6d 100644 (file)
Binary files a/doc/manual/screenshots/prefs-cover-sheet.png and b/doc/manual/screenshots/prefs-cover-sheet.png differ
index 2b89ad8ef94c65068d15b6fbee8afabd46e9abd6..476db859b44a30da470e5da7586b6738324b0f81 100644 (file)
Binary files a/doc/manual/screenshots/prefs-defaults.png and b/doc/manual/screenshots/prefs-defaults.png differ
index 19ce2419fa27c5368cdac63bffe5101acdb8499b..b726df1b72645f10fe4f5777c6e1dc72c207432d 100644 (file)
Binary files a/doc/manual/screenshots/prefs-general.png and b/doc/manual/screenshots/prefs-general.png differ
index ed9ba60a5e59a3216999da042dccbfda25f1d391..6627c2ee42e431f3cec3d4abc78734ea16d7a5f7 100644 (file)
Binary files a/doc/manual/screenshots/prefs-kdm-email.png and b/doc/manual/screenshots/prefs-kdm-email.png differ
index 0f21a16aa7df2a446f132c1258aec2f9d740dc54..d9b1387a4ad911c5dc17797a7adeb1d767f8b635 100644 (file)
Binary files a/doc/manual/screenshots/prefs-keys.png and b/doc/manual/screenshots/prefs-keys.png differ
index 95621b4a5084e28bde26a0babb34e20cc0993281..f50227c99f09ab33e4cecd74af882871dc21641f 100644 (file)
Binary files a/doc/manual/screenshots/prefs-servers.png and b/doc/manual/screenshots/prefs-servers.png differ
index 7e5bf38d7b7eb867fe5270814545e91e4b09f594..4e0ba556e7761fc1e4168d7715fa80967ab20785 100644 (file)
Binary files a/doc/manual/screenshots/prefs-tms.png and b/doc/manual/screenshots/prefs-tms.png differ
index f732e84d84351a7e4517f2b00c1caa48d7f31547..a8a741373882d1ffb96e45d9574978546c4cdd1d 100644 (file)
Binary files a/doc/manual/screenshots/video-tab.png and b/doc/manual/screenshots/video-tab.png differ
index 04cf6dd9b5cfa12ae124bb9b1a44113964dd4263..99ed74b29bc27d53c27fb0cfcecf36dfd38e6580 100644 (file)
@@ -640,7 +640,7 @@ Config::write_config () const
        xmlpp::Document doc;
        xmlpp::Element* root = doc.create_root_node ("Config");
 
-       /* [XML] Version The version number of the configuration file format */
+       /* [XML] Version The version number of the configuration file format. */
        root->add_child("Version")->add_child_text (String::compose ("%1", _current_version));
        /* [XML] MasterEncodingThreads Number of encoding threads to use when running as master. */
        root->add_child("MasterEncodingThreads")->add_child_text (raw_convert<string> (_master_encoding_threads));
@@ -671,13 +671,13 @@ Config::write_config () const
        root->add_child("OnlyServersEncode")->add_child_text (_only_servers_encode ? "1" : "0");
        /* [XML] TMSProtocol Protocol to use to copy files to a TMS; 0 to use SCP, 1 for FTP. */
        root->add_child("TMSProtocol")->add_child_text (raw_convert<string> (static_cast<int> (_tms_protocol)));
-       /* [XML] TMSIP IP address of TMS */
+       /* [XML] TMSIP IP address of TMS. */
        root->add_child("TMSIP")->add_child_text (_tms_ip);
-       /* [XML] TMSPath Path on the TMS to copy files to */
+       /* [XML] TMSPath Path on the TMS to copy files to. */
        root->add_child("TMSPath")->add_child_text (_tms_path);
-       /* [XML] TMSUser Username to log into the TMS with */
+       /* [XML] TMSUser Username to log into the TMS with. */
        root->add_child("TMSUser")->add_child_text (_tms_user);
-       /* [XML] TMSPassword Password to log into the TMS with */
+       /* [XML] TMSPassword Password to log into the TMS with. */
        root->add_child("TMSPassword")->add_child_text (_tms_password);
        if (_cinema_sound_processor) {
                /* [XML:opt] CinemaSoundProcessor Identifier of the type of cinema sound processor to use when calculating
@@ -714,6 +714,7 @@ Config::write_config () const
        root->add_child("DCPIssuer")->add_child_text (_dcp_issuer);
        /* [XML] DCPIssuer Creator text to write into CPL files. */
        root->add_child("DCPCreator")->add_child_text (_dcp_creator);
+       /* [XML] DefaultUploadAfterMakeDCP 1 to default to uploading to a TMS after making a DCP, 0 to default to no upload. */
        root->add_child("DefaultUploadAfterMakeDCP")->add_child_text (_default_upload_after_make_dcp ? "1" : "0");
 
        /* [XML] ISDCFMetadata Default ISDCF metadata to use for new films; child tags are <code>&lt;ContentVersion&gt;</code>,
@@ -753,36 +754,36 @@ Config::write_config () const
                /* [XML] KDMCC CC address to use for KDM emails; you can use as many of these tags as you like. */
                root->add_child("KDMCC")->add_child_text (i);
        }
-       /* [XML] KDMBCC BCC address to use for KDM emails */
+       /* [XML] KDMBCC BCC address to use for KDM emails. */
        root->add_child("KDMBCC")->add_child_text (_kdm_bcc);
-       /* [XML] KDMEmail Text of KDM email */
+       /* [XML] KDMEmail Text of KDM email. */
        root->add_child("KDMEmail")->add_child_text (_kdm_email);
 
-       /* [XML] NotificationSubject Subject to use for Notification emails. */
+       /* [XML] NotificationSubject Subject to use for notification emails. */
        root->add_child("NotificationSubject")->add_child_text (_notification_subject);
-       /* [XML] NotificationFrom From address to use for Notification emails. */
+       /* [XML] NotificationFrom From address to use for notification emails. */
        root->add_child("NotificationFrom")->add_child_text (_notification_from);
-       /* [XML] NotificationFrom To address to use for Notification emails. */
+       /* [XML] NotificationFrom To address to use for notification emails. */
        root->add_child("NotificationTo")->add_child_text (_notification_to);
        BOOST_FOREACH (string i, _notification_cc) {
-               /* [XML] NotificationCC CC address to use for Notification emails; you can use as many of these tags as you like. */
+               /* [XML] NotificationCC CC address to use for notification emails; you can use as many of these tags as you like. */
                root->add_child("NotificationCC")->add_child_text (i);
        }
-       /* [XML] NotificationBCC BCC address to use for Notification emails */
+       /* [XML] NotificationBCC BCC address to use for notification emails. */
        root->add_child("NotificationBCC")->add_child_text (_notification_bcc);
-       /* [XML] NotificationEmail Text of Notification email */
+       /* [XML] NotificationEmail Text of notification email. */
        root->add_child("NotificationEmail")->add_child_text (_notification_email);
 
-       /* [XML] CheckForUpdates 1 to check dcpomatic.com for new versions, 0 to check only on request */
+       /* [XML] CheckForUpdates 1 to check dcpomatic.com for new versions, 0 to check only on request. */
        root->add_child("CheckForUpdates")->add_child_text (_check_for_updates ? "1" : "0");
-       /* [XML] CheckForUpdates 1 to check dcpomatic.com for new text versions, 0 to check only on request */
+       /* [XML] CheckForUpdates 1 to check dcpomatic.com for new text versions, 0 to check only on request. */
        root->add_child("CheckForTestUpdates")->add_child_text (_check_for_test_updates ? "1" : "0");
 
-       /* [XML] MaximumJ2KBandwidth Maximum J2K bandwidth (in bits per second) that can be specified in the GUI */
+       /* [XML] MaximumJ2KBandwidth Maximum J2K bandwidth (in bits per second) that can be specified in the GUI. */
        root->add_child("MaximumJ2KBandwidth")->add_child_text (raw_convert<string> (_maximum_j2k_bandwidth));
-       /* [XML] AllowAnyDCPFrameRate 1 to allow users to specify any frame rate when creating DCPs, 0 to limit the GUI to standard rates */
+       /* [XML] AllowAnyDCPFrameRate 1 to allow users to specify any frame rate when creating DCPs, 0 to limit the GUI to standard rates. */
        root->add_child("AllowAnyDCPFrameRate")->add_child_text (_allow_any_dcp_frame_rate ? "1" : "0");
-       /* [XML] AllowAnyContainer 1 to allow users to user any container ratio for their DCP, 0 to limit the GUI to standard containers */
+       /* [XML] AllowAnyContainer 1 to allow users to user any container ratio for their DCP, 0 to limit the GUI to standard containers. */
        root->add_child("AllowAnyContainer")->add_child_text (_allow_any_container ? "1" : "0");
        /* [XML] LogTypes Types of logging to write; a bitfield where 1 is general notes, 2 warnings, 4 errors, 8 debug information related
           to encoding, 16 debug information related to encoding, 32 debug information for timing purposes, 64 debug information related
@@ -798,9 +799,6 @@ Config::write_config () const
        root->add_child("Win32Console")->add_child_text (_win32_console ? "1" : "0");
 #endif
 
-       /* [XML] Signer Certificate chain and private key to use when signing DCPs and KDMs.  Should contain <code>&lt;Certificate&gt;</code>
-          tags in order and a <code>&lt;PrivateKey&gt;</code> tag all containing PEM-encoded certificates or private keys as appropriate.
-       */
 #ifdef DCPOMATIC_VARIANT_SWAROOP
        if (_signer_chain_path.is_relative()) {
                write_swaroop_chain (_signer_chain, path(_signer_chain_path.string()));
@@ -809,6 +807,9 @@ Config::write_config () const
        }
        root->add_child("Signer")->add_child_text(_signer_chain_path.string());
 #else
+       /* [XML] Signer Certificate chain and private key to use when signing DCPs and KDMs.  Should contain <code>&lt;Certificate&gt;</code>
+          tags in order and a <code>&lt;PrivateKey&gt;</code> tag all containing PEM-encoded certificates or private keys as appropriate.
+       */
        xmlpp::Element* signer = root->add_child ("Signer");
        DCPOMATIC_ASSERT (_signer_chain);
        BOOST_FOREACH (dcp::Certificate const & i, _signer_chain->unordered()) {
@@ -817,7 +818,6 @@ Config::write_config () const
        signer->add_child("PrivateKey")->add_child_text (_signer_chain->key().get ());
 #endif
 
-       /* [XML] Decryption Certificate chain and private key to use when decrypting KDMs */
 #ifdef DCPOMATIC_VARIANT_SWAROOP
        if (_decryption_chain_path.is_relative()) {
                write_swaroop_chain (_decryption_chain, path(_decryption_chain_path.string()));
@@ -826,6 +826,7 @@ Config::write_config () const
        }
        root->add_child("Decryption")->add_child_text(_decryption_chain_path.string());
 #else
+       /* [XML] Decryption Certificate chain and private key to use when decrypting KDMs */
        xmlpp::Element* decryption = root->add_child ("Decryption");
        DCPOMATIC_ASSERT (_decryption_chain);
        BOOST_FOREACH (dcp::Certificate const & i, _decryption_chain->unordered()) {
@@ -841,6 +842,9 @@ Config::write_config () const
                root->add_child("History")->add_child_text (i.string ());
        }
 
+       /* [XML] History Filename of DCP to present in the <guilabel>File</guilabel> menu of the player; there can be more than one
+          of these tags.
+       */
        BOOST_FOREACH (boost::filesystem::path i, _player_history) {
                root->add_child("PlayerHistory")->add_child_text (i.string ());
        }
@@ -851,39 +855,40 @@ Config::write_config () const
        /* [XML] DKDM A DKDM as XML */
        _dkdms->as_xml (root);
 
-       /* [XML] CinemasFile Filename of cinemas list file */
+       /* [XML] CinemasFile Filename of cinemas list file. */
        root->add_child("CinemasFile")->add_child_text (_cinemas_file.string());
-       /* [XML] ShowHintsBeforeMakeDCP 1 to show hints in the GUI before making a DCP, otherwise 0 */
+       /* [XML] ShowHintsBeforeMakeDCP 1 to show hints in the GUI before making a DCP, otherwise 0. */
        root->add_child("ShowHintsBeforeMakeDCP")->add_child_text (_show_hints_before_make_dcp ? "1" : "0");
-       /* [XML] ConfirmKDMEmail 1 to confirm before sending KDM emails in the GUI, otherwise 0 */
+       /* [XML] ConfirmKDMEmail 1 to confirm before sending KDM emails in the GUI, otherwise 0. */
        root->add_child("ConfirmKDMEmail")->add_child_text (_confirm_kdm_email ? "1" : "0");
-       /* [XML] KDMFilenameFormat Format for KDM filenames */
+       /* [XML] KDMFilenameFormat Format for KDM filenames. */
        root->add_child("KDMFilenameFormat")->add_child_text (_kdm_filename_format.specification ());
-       /* [XML] KDMContainerNameFormat Format for KDM containers (directories or ZIP files) */
+       /* [XML] KDMContainerNameFormat Format for KDM containers (directories or ZIP files). */
        root->add_child("KDMContainerNameFormat")->add_child_text (_kdm_container_name_format.specification ());
-       /* [XML] DCPMetadataFilenameFormat Format for DCP metadata filenames */
+       /* [XML] DCPMetadataFilenameFormat Format for DCP metadata filenames. */
        root->add_child("DCPMetadataFilenameFormat")->add_child_text (_dcp_metadata_filename_format.specification ());
-       /* [XML] DCPAssetFilenameFormat Format for DCP asset filenames */
+       /* [XML] DCPAssetFilenameFormat Format for DCP asset filenames. */
        root->add_child("DCPAssetFilenameFormat")->add_child_text (_dcp_asset_filename_format.specification ());
-       /* [XML] JumpToSelected 1 to make the GUI jump to the start of content when it is selected, otherwise 0 */
+       /* [XML] JumpToSelected 1 to make the GUI jump to the start of content when it is selected, otherwise 0. */
        root->add_child("JumpToSelected")->add_child_text (_jump_to_selected ? "1" : "0");
-       /* [XML] Nagged 1 if a particular nag screen has been shown and should not be shown again, otherwise 0 */
+       /* [XML] Nagged 1 if a particular nag screen has been shown and should not be shown again, otherwise 0. */
        for (int i = 0; i < NAG_COUNT; ++i) {
                xmlpp::Element* e = root->add_child ("Nagged");
                e->set_attribute ("Id", raw_convert<string>(i));
                e->add_child_text (_nagged[i] ? "1" : "0");
        }
-       /* [XML] PreviewSound 1 to use sound in the GUI preview and player, otherwise 0 */
+       /* [XML] PreviewSound 1 to use sound in the GUI preview and player, otherwise 0. */
        root->add_child("PreviewSound")->add_child_text (_sound ? "1" : "0");
        if (_sound_output) {
-               /* [XML:opt] PreviewSoundOutput Name of the audio output to use */
+               /* [XML:opt] PreviewSoundOutput Name of the audio output to use. */
                root->add_child("PreviewSoundOutput")->add_child_text (_sound_output.get());
        }
-       /* [XML] CoverSheet Text of the cover sheet to write when making DCPs */
+       /* [XML] CoverSheet Text of the cover sheet to write when making DCPs. */
        root->add_child("CoverSheet")->add_child_text (_cover_sheet);
        if (_last_player_load_directory) {
                root->add_child("LastPlayerLoadDirectory")->add_child_text(_last_player_load_directory->string());
        }
+       /* [XML] LastKDMWriteType Last type of KDM-write: <code>flat</code> for a flat file, <code>folder</code> for a folder or <code>zip</code> for a ZIP file. */
        if (_last_kdm_write_type) {
                switch (_last_kdm_write_type.get()) {
                case KDM_WRITE_FLAT:
@@ -897,6 +902,7 @@ Config::write_config () const
                        break;
                }
        }
+       /* [XML] LastDKDMWriteType Last type of DKDM-write: <code>file</code> for a file, <code>internal</code> to add to DCP-o-matic's list. */
        if (_last_dkdm_write_type) {
                switch (_last_dkdm_write_type.get()) {
                case DKDM_WRITE_INTERNAL:
@@ -912,15 +918,15 @@ Config::write_config () const
        */
        root->add_child("FramesInMemoryMultiplier")->add_child_text(raw_convert<string>(_frames_in_memory_multiplier));
 
-       /* [XML] DecodeReduction power of 2 to reduce DCP images by before decoding in the player */
+       /* [XML] DecodeReduction power of 2 to reduce DCP images by before decoding in the player. */
        if (_decode_reduction) {
                root->add_child("DecodeReduction")->add_child_text(raw_convert<string>(_decode_reduction.get()));
        }
 
-       /* [XML] DefaultNotify 1 to default jobs to notify when complete, otherwise 0 */
+       /* [XML] DefaultNotify 1 to default jobs to notify when complete, otherwise 0. */
        root->add_child("DefaultNotify")->add_child_text(_default_notify ? "1" : "0");
 
-       /* [XML] Notification 1 if a notification type is enabled, otherwise 0 */
+       /* [XML] Notification 1 if a notification type is enabled, otherwise 0. */
        for (int i = 0; i < NOTIFICATION_COUNT; ++i) {
                xmlpp::Element* e = root->add_child ("Notification");
                e->set_attribute ("Id", raw_convert<string>(i));
@@ -928,26 +934,33 @@ Config::write_config () const
        }
 
        if (_barco_username) {
+               /* [XML] BarcoUsername Username for logging into Barco's servers when downloading server certificates. */
                root->add_child("BarcoUsername")->add_child_text(*_barco_username);
        }
        if (_barco_password) {
+               /* [XML] BarcoPassword Password for logging into Barco's servers when downloading server certificates. */
                root->add_child("BarcoPassword")->add_child_text(*_barco_password);
        }
 
        if (_christie_username) {
+               /* [XML] ChristieUsername Username for logging into Christie's servers when downloading server certificates. */
                root->add_child("ChristieUsername")->add_child_text(*_christie_username);
        }
        if (_christie_password) {
+               /* [XML] ChristiePassword Password for logging into Christie's servers when downloading server certificates. */
                root->add_child("ChristiePassword")->add_child_text(*_christie_password);
        }
 
        if (_gdc_username) {
+               /* [XML] GCCUsername Username for logging into GDC's servers when downloading server certificates. */
                root->add_child("GDCUsername")->add_child_text(*_gdc_username);
        }
        if (_gdc_password) {
+               /* [XML] GCCPassword Password for logging into GDC's servers when downloading server certificates. */
                root->add_child("GDCPassword")->add_child_text(*_gdc_password);
        }
 
+       /* [XML] InterfaceComplexity <code>simple</code> for the reduced interface or <code>full</code> for the full interface. */
        switch (_interface_complexity) {
        case INTERFACE_SIMPLE:
                root->add_child("InterfaceComplexity")->add_child_text("simple");
@@ -957,6 +970,9 @@ Config::write_config () const
                break;
        }
 
+       /* [XML] PlayerMode <code>window</code> for a single window, <code>full</code> for full-screen and <code>dual</code> for full screen playback
+          with controls on another monitor.
+       */
        switch (_player_mode) {
        case PLAYER_MODE_WINDOW:
                root->add_child("PlayerMode")->add_child_text("window");
@@ -969,18 +985,24 @@ Config::write_config () const
                break;
        }
 
+       /* [XML] ImageDisplay Screen number to put image on in dual-screen player mode. */
        root->add_child("ImageDisplay")->add_child_text(raw_convert<string>(_image_display));
+       /* [XML] RespectKDMValidityPeriods 1 to refuse to use KDMs that are out of date, 0 to ignore KDM dates. */
        root->add_child("RespectKDMValidityPeriods")->add_child_text(_respect_kdm_validity_periods ? "1" : "0");
        if (_player_log_file) {
+               /* [XML] PlayerLogFile Filename to use for player logs */
                root->add_child("PlayerLogFile")->add_child_text(_player_log_file->string());
        }
        if (_player_content_directory) {
+               /* [XML] PlayerContentDirectory Filename to use for player content in the dual-screen mode. */
                root->add_child("PlayerContentDirectory")->add_child_text(_player_content_directory->string());
        }
        if (_player_playlist_directory) {
+               /* [XML] PlayerPlaylistDirectory Filename to use for player playlists in the dual-screen mode. */
                root->add_child("PlayerPlaylistDirectory")->add_child_text(_player_playlist_directory->string());
        }
        if (_player_kdm_directory) {
+               /* [XML] PlayerKDMDirectory Filename to use for player KDMs in the dual-screen mode. */
                root->add_child("PlayerKDMDirectory")->add_child_text(_player_kdm_directory->string());
        }
 #ifdef DCPOMATIC_VARIANT_SWAROOP