diff --git a/docs/manual/state-diagram.svg b/docs/manual/state-diagram.svg
new file mode 100644
index 0000000000..1be6d42a15
--- /dev/null
+++ b/docs/manual/state-diagram.svg
@@ -0,0 +1,233 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="311.62961"
+   height="322.74072"
+   id="svg2"
+   version="1.1"
+   inkscape:version="0.48.3.1 r9886"
+   sodipodi:docname="New document 1">
+  <defs
+     id="defs4" />
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.4"
+     inkscape:cx="161.52909"
+     inkscape:cy="161.37036"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     borderlayer="true"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1600"
+     inkscape:window-height="841"
+     inkscape:window-x="0"
+     inkscape:window-y="27"
+     inkscape:window-maximized="1" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-219.1852,-376.7061)">
+    <g
+       id="g3006"
+       style="fill:none;stroke-width:0.025in"
+       transform="matrix(0.07407407,0,0,0.07407407,119.44446,321.40981)">
+      <!-- Circle -->
+      <circle
+         id="circle3008"
+         style="stroke:#000000;stroke-width:7"
+         r="480"
+         cy="1950"
+         cx="3600"
+         sodipodi:cx="3600"
+         sodipodi:cy="1950"
+         sodipodi:rx="480"
+         sodipodi:ry="480"
+         d="m 4080,1950 c 0,265.0967 -214.9033,480 -480,480 -265.0967,0 -480,-214.9033 -480,-480 0,-265.0967 214.9033,-480 480,-480 265.0967,0 480,214.9033 480,480 z" />
+      <!-- Circle -->
+      <circle
+         id="circle3010"
+         style="stroke:#000000;stroke-width:7"
+         r="480"
+         cy="3150"
+         cx="3600"
+         sodipodi:cx="3600"
+         sodipodi:cy="3150"
+         sodipodi:rx="480"
+         sodipodi:ry="480"
+         d="m 4080,3150 c 0,265.0967 -214.9033,480 -480,480 -265.0967,0 -480,-214.9033 -480,-480 0,-265.0967 214.9033,-480 480,-480 265.0967,0 480,214.9033 480,480 z" />
+      <!-- Circle -->
+      <circle
+         id="circle3012"
+         style="stroke:#000000;stroke-width:7"
+         r="480"
+         cy="4350"
+         cx="3600"
+         sodipodi:cx="3600"
+         sodipodi:cy="4350"
+         sodipodi:rx="480"
+         sodipodi:ry="480"
+         d="m 4080,4350 c 0,265.0967 -214.9033,480 -480,480 -265.0967,0 -480,-214.9033 -480,-480 0,-265.0967 214.9033,-480 480,-480 265.0967,0 480,214.9033 480,480 z" />
+      <!-- Circle -->
+      <circle
+         id="circle3014"
+         style="stroke:#000000;stroke-width:7"
+         r="480"
+         cy="4350"
+         cx="4875"
+         sodipodi:cx="4875"
+         sodipodi:cy="4350"
+         sodipodi:rx="480"
+         sodipodi:ry="480"
+         d="m 5355,4350 c 0,265.0967 -214.9033,480 -480,480 -265.0967,0 -480,-214.9033 -480,-480 0,-265.0967 214.9033,-480 480,-480 265.0967,0 480,214.9033 480,480 z" />
+      <!-- Line -->
+      <polyline
+         id="polyline3016"
+         style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+         points="3600,900 3600,1380 " />
+      <!-- Arrowhead on XXXpoint 3600 900 - 3600 1515-->
+      <polygon
+         id="polygon3018"
+         style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+         points="3600,1499 3630,1379 3570,1379 3570,1379 " />
+      <!-- Line: box -->
+      <rect
+         id="rect3020"
+         style="stroke:#ffffff;stroke-width:7;stroke-linecap:butt;stroke-linejoin:miter"
+         rx="0"
+         height="4350"
+         width="4200"
+         y="750"
+         x="1350" />
+      <!-- Line -->
+      <polyline
+         id="polyline3022"
+         style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:bevel"
+         points="3150,1875 3149,1876 3145,1878 3139,1881 3130,1887 3118,1895 3101,1905 3082,1917 3060,1931 3035,1948 3009,1966 2981,1985 2953,2006 2925,2028 2897,2051 2869,2075 2843,2101 2818,2127 2794,2155 2773,2184 2753,2215 2735,2248 2721,2283 2710,2321 2703,2360 2700,2400 2703,2440 2710,2479 2721,2517 2735,2552 2753,2585 2773,2616 2794,2645 2818,2673 2843,2699 2869,2725 2897,2749 2925,2772 2953,2794 2981,2815 3009,2834 3035,2852 3060,2869 3082,2883 3101,2895 3118,2905 3130,2913 3047,2863 " />
+      <!-- Arrowhead on XXXpoint 3130 2913 - 3162 2932-->
+      <polygon
+         id="polygon3024"
+         style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+         points="3148,2924 3060,2836 3029,2888 3029,2888 " />
+      <!-- Line -->
+      <polyline
+         id="polyline3026"
+         style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:bevel"
+         points="3150,3150 3149,3151 3145,3153 3139,3156 3130,3162 3118,3170 3101,3180 3082,3192 3060,3206 3035,3223 3009,3241 2981,3260 2953,3281 2925,3303 2897,3326 2869,3350 2843,3376 2818,3402 2794,3430 2773,3459 2753,3490 2735,3523 2721,3558 2710,3596 2703,3635 2700,3675 2703,3715 2710,3754 2721,3792 2735,3827 2753,3860 2773,3891 2794,3920 2818,3948 2843,3974 2869,4000 2897,4024 2925,4047 2953,4069 2981,4090 3009,4109 3035,4127 3060,4144 3082,4158 3101,4170 3118,4180 3130,4188 3047,4138 " />
+      <!-- Arrowhead on XXXpoint 3130 4188 - 3162 4207-->
+      <polygon
+         id="polygon3028"
+         style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+         points="3148,4199 3060,4111 3029,4163 3029,4163 " />
+      <!-- Line -->
+      <polyline
+         id="polyline3030"
+         style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:bevel"
+         points="3750,3900 3751,3899 3755,3896 3760,3891 3769,3884 3781,3875 3796,3863 3814,3850 3834,3834 3857,3818 3881,3802 3907,3785 3935,3768 3964,3752 3995,3737 4027,3723 4062,3710 4099,3699 4139,3689 4182,3682 4228,3677 4275,3675 4322,3677 4368,3682 4411,3689 4451,3699 4488,3710 4523,3723 4555,3737 4586,3752 4615,3768 4643,3785 4669,3802 4693,3818 4716,3834 4736,3850 4754,3863 4769,3875 4781,3884 4708,3823 " />
+      <!-- Arrowhead on XXXpoint 4781 3884 - 4811 3909-->
+      <polygon
+         id="polygon3032"
+         style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+         points="4799,3899 4726,3799 4687,3845 4687,3845 " />
+      <!-- Line -->
+      <polyline
+         id="polyline3034"
+         style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:bevel"
+         points="4800,4800 4799,4801 4795,4804 4790,4809 4781,4816 4769,4825 4754,4837 4736,4850 4716,4866 4693,4882 4669,4898 4643,4915 4615,4932 4586,4948 4555,4963 4523,4977 4488,4990 4451,5001 4411,5011 4368,5018 4322,5023 4275,5025 4228,5023 4182,5018 4139,5011 4099,5001 4062,4990 4027,4977 3995,4963 3964,4948 3935,4932 3907,4915 3881,4898 3857,4882 3834,4866 3814,4850 3796,4837 3781,4825 3769,4816 3841,4876 " />
+      <!-- Arrowhead on XXXpoint 3769 4816 - 3738 4790-->
+      <polygon
+         id="polygon3036"
+         style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+         points="3750,4800 3822,4900 3861,4854 3861,4854 " />
+      <!-- Line -->
+      <polyline
+         id="polyline3038"
+         style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:bevel"
+         points="5175,3975 5175,3974 5176,3972 5177,3967 5179,3960 5182,3951 5186,3937 5190,3921 5196,3901 5202,3877 5209,3849 5217,3819 5226,3785 5235,3748 5244,3708 5253,3666 5263,3622 5272,3577 5280,3530 5289,3481 5296,3432 5303,3382 5309,3331 5314,3280 5318,3228 5320,3175 5320,3121 5319,3067 5317,3011 5312,2955 5305,2897 5295,2839 5283,2779 5267,2719 5249,2658 5228,2596 5203,2535 5175,2475 5142,2414 5107,2356 5069,2301 5030,2250 4990,2203 4949,2160 4908,2120 4866,2083 4824,2050 4781,2019 4738,1990 4695,1964 4652,1940 4609,1917 4566,1896 4522,1877 4479,1859 4437,1842 4395,1827 4354,1812 4315,1799 4277,1787 4241,1776 4208,1766 4178,1758 4150,1750 4126,1744 4106,1739 4089,1734 4075,1731 4065,1729 4165,1755 " />
+      <!-- Arrowhead on XXXpoint 4065 1729 - 4035 1721-->
+      <polygon
+         id="polygon3040"
+         style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+         points="4051,1725 4159,1784 4174,1726 4174,1726 " />
+      <!-- Line -->
+      <polyline
+         id="polyline3042"
+         style="stroke:#000000;stroke-width:7;stroke-linecap:butt;stroke-linejoin:bevel"
+         points="3225,4650 3224,4650 3222,4649 3217,4647 3210,4644 3201,4640 3187,4635 3170,4629 3149,4620 3125,4610 3096,4598 3063,4585 3026,4570 2985,4553 2942,4534 2895,4514 2845,4492 2793,4469 2739,4444 2683,4418 2626,4391 2568,4363 2510,4334 2452,4303 2393,4272 2336,4240 2278,4207 2222,4173 2167,4137 2113,4101 2060,4064 2009,4025 1960,3985 1913,3943 1867,3900 1824,3856 1783,3809 1745,3760 1710,3710 1678,3657 1650,3602 1626,3545 1605,3486 1590,3426 1580,3363 1575,3300 1576,3236 1583,3173 1596,3110 1613,3049 1634,2988 1660,2930 1689,2873 1721,2817 1757,2764 1795,2712 1835,2661 1878,2612 1924,2564 1971,2517 2019,2471 2070,2427 2122,2383 2175,2340 2229,2299 2285,2258 2341,2217 2397,2178 2454,2140 2510,2103 2567,2066 2622,2032 2676,1998 2729,1966 2779,1935 2828,1907 2874,1880 2916,1855 2956,1833 2992,1812 3024,1794 3052,1779 3076,1765 3097,1754 3113,1745 3126,1738 3136,1733 3046,1784 " />
+      <!-- Arrowhead on XXXpoint 3136 1733 - 3163 1717-->
+      <polygon
+         id="polygon3044"
+         style="fill:#000000;stroke:#000000;stroke-width:7;stroke-miterlimit:8"
+         points="3149,1725 3030,1760 3061,1811 3061,1811 " />
+      <!-- Text -->
+      <text
+         id="text3046"
+         font-size="144"
+         font-weight="normal"
+         font-style="normal"
+         y="2025"
+         x="3375"
+         xml:space="preserve"
+         style="font-size:144px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">NULL</text>
+      <!-- Text -->
+      <text
+         id="text3048"
+         font-size="144"
+         font-weight="normal"
+         font-style="normal"
+         y="3225"
+         x="3300"
+         xml:space="preserve"
+         style="font-size:144px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">READY</text>
+      <!-- Text -->
+      <text
+         id="text3050"
+         font-size="144"
+         font-weight="normal"
+         font-style="normal"
+         y="4425"
+         x="3225"
+         xml:space="preserve"
+         style="font-size:144px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">PLAYING</text>
+      <!-- Text -->
+      <text
+         id="text3052"
+         font-size="144"
+         font-weight="normal"
+         font-style="normal"
+         y="4425"
+         x="4500"
+         xml:space="preserve"
+         style="font-size:144px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">PAUSED</text>
+    </g>
+  </g>
+</svg>
diff --git a/docs/random/wtay/player.svg b/docs/random/wtay/player.svg
new file mode 100644
index 0000000000..53510e302f
--- /dev/null
+++ b/docs/random/wtay/player.svg
@@ -0,0 +1,251 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="646.72247"
+   height="373.33456"
+   id="svg2"
+   version="1.1"
+   inkscape:version="0.48.3.1 r9886"
+   sodipodi:docname="state-diagram.svg">
+  <defs
+     id="defs4" />
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.4"
+     inkscape:cx="446.39199"
+     inkscape:cy="185.85481"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     borderlayer="true"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1600"
+     inkscape:window-height="841"
+     inkscape:window-x="0"
+     inkscape:window-y="27"
+     inkscape:window-maximized="1" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-340.10968,-560.63668)">
+    <g
+       id="g3143"
+       style="fill:none;stroke-width:0.025in"
+       transform="matrix(0.07514786,0,0,0.07514786,301.40853,507.73259)">
+      <!-- Line: box -->
+      <rect
+         id="rect3145"
+         style="fill:#ffff00;stroke:#000000;stroke-width:8;stroke-linecap:butt;stroke-linejoin:miter"
+         rx="0"
+         height="1795"
+         width="2692"
+         y="3637"
+         x="6188" />
+      <!-- Line: box -->
+      <rect
+         id="rect3147"
+         style="stroke:#000000;stroke-width:8;stroke-linecap:butt;stroke-linejoin:miter"
+         rx="0"
+         height="3543"
+         width="3921"
+         y="2031"
+         x="5149" />
+      <!-- Line: box -->
+      <rect
+         id="rect3149"
+         style="stroke:#000000;stroke-width:8;stroke-linecap:butt;stroke-linejoin:miter"
+         rx="0"
+         height="3543"
+         width="2314"
+         y="2031"
+         x="2740" />
+      <!-- Line: box -->
+      <rect
+         id="rect3151"
+         style="stroke:#000000;stroke-width:8;stroke-linecap:butt;stroke-linejoin:miter"
+         rx="0"
+         height="4960"
+         width="8598"
+         y="708"
+         x="519" />
+      <!-- Line: box -->
+      <rect
+         id="rect3153"
+         style="stroke:#000000;stroke-width:8;stroke-linecap:butt;stroke-linejoin:miter"
+         rx="0"
+         height="1606"
+         width="1842"
+         y="2031"
+         x="708" />
+      <!-- Text -->
+      <text
+         id="text3155"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="4110"
+         x="6519"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">GstPlay</text>
+      <!-- Text -->
+      <text
+         id="text3157"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="4677"
+         x="6803"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">- GStreamer (glib2)</text>
+      <!-- Text -->
+      <text
+         id="text3159"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="2362"
+         x="5385"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Bonobo Component</text>
+      <!-- Text -->
+      <text
+         id="text3161"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="2834"
+         x="5385"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times"> - sliders/buttons</text>
+      <!-- Text -->
+      <text
+         id="text3163"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="3070"
+         x="5385"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">- Gtk/Gnome etc</text>
+      <!-- Text -->
+      <text
+         id="text3165"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="3307"
+         x="5385"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">- uses libgstplay</text>
+      <!-- Text -->
+      <text
+         id="text3167"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="992"
+         x="2834"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">GstMediaPlay</text>
+      <!-- Text -->
+      <text
+         id="text3169"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="1228"
+         x="2881"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">- app using components</text>
+      <!-- Text -->
+      <text
+         id="text3171"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="2267"
+         x="2834"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Bonobo component</text>
+      <!-- Text -->
+      <text
+         id="text3173"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="2740"
+         x="2834"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">- playlist etc..</text>
+      <!-- Text -->
+      <text
+         id="text3175"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="2267"
+         x="897"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">Other components</text>
+      <!-- Text -->
+      <text
+         id="text3177"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="2740"
+         x="897"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">- encoder</text>
+      <!-- Text -->
+      <text
+         id="text3179"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="2976"
+         x="897"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">- editor</text>
+      <!-- Text -->
+      <text
+         id="text3181"
+         font-size="152"
+         font-weight="normal"
+         font-style="normal"
+         y="3212"
+         x="897"
+         xml:space="preserve"
+         style="font-size:152px;font-style:normal;font-weight:normal;text-anchor:start;fill:#000000;font-family:Times">- ...</text>
+    </g>
+  </g>
+</svg>