docs/random/ensonic/: Possible dynamic reconnection api, plus some type fixes the other two docs.

Original commit message from CVS:
* docs/random/ensonic/dynlink.txt:
* docs/random/ensonic/interfaces.txt:
* docs/random/ensonic/receipies.txt:
Possible dynamic reconnection api, plus some type fixes the other two
docs.

ChangeLog

@@ -1,3 +1,11 @@
+2007-02-13  Stefan Kost  <ensonic@users.sf.net>
+
+	* docs/random/ensonic/dynlink.txt:
+	* docs/random/ensonic/interfaces.txt:
+	* docs/random/ensonic/receipies.txt:
+	  Possible dynamic reconnection api, plus some type fixes the other two
+	  docs.
+
 2007-02-13  Sebastian Dröge  <slomo@circular-chaos.org>
 
 	* plugins/elements/gstfilesink.c: (gst_file_sink_uri_set_uri):

docs/random/ensonic/dynlink.txt

@@ -0,0 +1,42 @@
+$Id$
+
+Currently its only save to link/unlink elements/pad when pipeline is in READY.
+
+= current api =
+
+gboolean gst_element_link   (GstElement *src, GstElement *dest);
+void     gst_element_unlink (GstElement *src, GstElement *dest);
+
+gst_element_link_many, gst_element_unlink_many, gst_element_link_filtered,
+gst_element_link_pads, gst_element_unlink_pads, gst_element_link_pads_filtered
+
+GstPadLinkReturn gst_pad_link (GstPad *srcpad, GstPad *sinkpad);
+gboolean         gst_pad_unlink (GstPad *srcpad, GstPad *sinkpad);
+
+= use cases =
+
+== inserting an element ==
+
+* we have: e1 ! e2
+* we want: e1 ! e3 ! e2
+
+gst_element_insert_linked(e1, e2, e3);
+
+== removing an element ==
+
+* we have: e1 ! e2 ! e3
+* we want: e1 ! e3
+
+gst_element_remove_linked(e2);
+
+== swapping out an elelment ==
+
+* we have: e1 ! e2 ! e3
+* we want: e1 ! e4 ! e3
+
+gst_element_swap_linked(e1, e3, e4);
+
+= thoughts =
+* I don't think we need api for pads
+* Should current api check for the state?
+

docs/random/ensonic/interfaces.txt

@@ -11,20 +11,6 @@ $Id$
   ./gst-plugins/gst-libs/gst/colorbalance/colorbalance.c
   ./gst-plugins/gst-libs/gst/navigation/navigation.c
 * new general interfaces
-  * GST_TYPE_PRESET_MANAGER
-    - add preset managment
-    - API:
-      GList *get_presets();
-      void activate_preset_by_index(glong index);
-      void activate_preset_by_name(const gchar *name);
-      void add_current(const gchar *name);
-      void remove_preset_by_index(glong index);
-      void remove_preset_by_name(const gchar *name);
-    - features
-      - there should always be a default preset
-    - questions
-      - were and how do we store the presets?
-
   * GST_TYPE_UI_HINT
     - add hints to generate 'good' looking interfaces to elements
     - API:

docs/random/ensonic/receipies.txt

@@ -16,7 +16,7 @@ How to I configure the initial playback segment?
 3) set pipeline to PLAYING
 
 === problems ===
-1) would preroll the pipeline only to flush it when the seek comes
+1) would preroll the pipeline only, to flush it when the seek comes
 
 
 == async state changes ==