X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=src%2Fmodules%2Fxml%2Fconsumer_xml.yml;h=b75a90e39bdfccf2252c3f2a53f0c80aa9a278dc;hb=236717e4ecc23e458e191b6c9a2ba70915b80937;hp=85eab0bf55bc91d5a69a97f7271e5d7d2b955fcd;hpb=9d15e02b1822b253473fb72563c4daa6b03b3232;p=mlt

diff --git a/src/modules/xml/consumer_xml.yml b/src/modules/xml/consumer_xml.yml
index 85eab0bf..b75a90e3 100644
--- a/src/modules/xml/consumer_xml.yml
+++ b/src/modules/xml/consumer_xml.yml
@@ -13,11 +13,22 @@ tags:
 description: >
   Serialise the service network to XML.
   See docs/mlt-xml.txt for more information.
+
+notes: >
+  If you set a data property beginning with (and longer than) "xml_retain" on
+  the service connected to this consumer where the data is a mlt_service
+  pointer, then the pointed at service will also be serialized before the
+  connected service. This can be useful, for example, to save a playlist as
+  a media bin along with a multitrack. You can serialize more than one of these
+  additional services by setting more than property, each with a unique key
+  beginning with "xml_retain".
+
 bugs:
    - Untested arbitrary nesting of multitracks and playlists.
    - >
      Property "id" is generated as service type followed by number if no
      property named "id" exists, but it fails to guarantee uniqueness.
+
 parameters:
   - identifier: resource
     argument: yes
@@ -85,7 +96,7 @@ parameters:
     default: frames
     widget: dropdown
 
-  - identififer: store
+  - identifier: store
     title: Include property prefix
     type: string
     description: >