X-Git-Url: http://research.m1stereo.tv/gitweb?a=blobdiff_plain;f=docs%2Fwestley.txt;h=2d5e29196ee016d3571c52af6cde6e498ca6d040;hb=3b9de6081136b2a28bf7a6f85354ec04d92065bb;hp=89e59288d82cc7768e8a3bf5cf84105d08ee03b0;hpb=2a800ec4c840132c7a629b764b673dce09771637;p=melted
diff --git a/docs/westley.txt b/docs/westley.txt
index 89e5928..2d5e291 100644
--- a/docs/westley.txt
+++ b/docs/westley.txt
@@ -279,3 +279,182 @@ Tractors:
placed between all producers and the consumer).
TODO: transition example
+
+
+Flexibility:
+
+ The information presented above is considered the MLT Westley "normal"
+ form. This is the output generated by the westley consumer, for example,
+ when used with inigo. It is the output generated when you use the
+ "Westley to File" consumer in the demo script, which beginners will find
+ most useful for learning to use westley XML. This section describes
+ alternative forms the westley producer accepts.
+
+ First of all, the normal form is more of a linear format with producers
+ and playlists defined prior to their usage in a multitrack. Westley
+ also accepts a hierarchical format with producers as children of tracks
+ or playlist entries and with playlists as children of tracks:
+
+
+
+
+
+
+
+
+
+ Obviously, this example is meant to demonstrate hierarchy and not effective
+ use of playlist or multitrack!
+
+ Secondly, as part of error handling, westley is forgiving if you fail to
+ supply ,