Add xml_retain property support to xml module.

[mlt] / src / modules / xml / producer_xml.yml

diff --git a/src/modules/xml/producer_xml.yml b/src/modules/xml/producer_xml.yml
index 02988de25815f14de41920987268ac4eb34c0dad..0df379acb19904263923eb47b9ab1a73065c1589 100644 (file)
--- 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