X-Git-Url: https://git.sesse.net/?p=mlt;a=blobdiff_plain;f=src%2Fmodules%2Fxml%2Fproducer_xml.yml;h=0df379acb19904263923eb47b9ab1a73065c1589;hp=02988de25815f14de41920987268ac4eb34c0dad;hb=236717e4ecc23e458e191b6c9a2ba70915b80937;hpb=0d422babb828f64febdbcb91dedd9595db0dec92

diff --git a/src/modules/xml/producer_xml.yml b/src/modules/xml/producer_xml.yml
index 02988de2..0df379ac 100644
--- a/src/modules/xml/producer_xml.yml
+++ b/src/modules/xml/producer_xml.yml
@@ -12,6 +12,16 @@ tags:
   - Video
 description: |
   Construct a service network from an XML description. See docs/mlt-xml.txt.
+
+notes: >
+  If there is a service with a property "xml_retain=1" that is not the
+  producer, and if it also has an "id" property; then the extra service
+  is put into a properties list keyed on the id property. Then, that
+  properties list is placed as a property on the returned service with
+  the name "xml_retain". This lets an application retrieve additional
+  deserialized services that are not the lastmost producer or anywhere in
+  its graph.
+
 parameters:
   - identifier: argument
     title: File