docs: add link to python porting doc and app dev manual to porting-to-1.0.txt
[platform/upstream/gstreamer.git] / docs / random / porting-to-1.0.txt
index 9333d1b..a464e95 100644 (file)
@@ -1,8 +1,10 @@
-The 0.11 porting guide
-----------------------
+GStreamer 0.10 to 1.0 porting guide
+-----------------------------------
+
+PREFACE
 
 * All deprecated methods were removed. Recompile against 0.10 with
-  DISABLE_DEPRECATED and fix issues before attempting to port to 0.11.
+  DISABLE_DEPRECATED and fix issues before attempting to port to 1.0.
 
 * API changes are usually easy to spot, because the compiler will
   generate a warning, at least if number of arguments or types differ
@@ -10,6 +12,16 @@ The 0.11 porting guide
 * Other changes are a bit more subtle. See checklist at the bottom
   for some "soft" changes which the compiler will not warn about.
 
+* python developers may find https://wiki.ubuntu.com/Novacut/GStreamer1.0
+  useful
+
+* application developers may first want to have a look at the list of changes
+  affecting applications in the Application Development Manual:
+  http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/chapter-porting-1.0.html
+
+
+CHANGES
+
 * GST_BOILERPLATE is gone, use G_DEFINE_TYPE instead.
 
 * various methods take a gsize instead of a guint when talking about memory
@@ -18,8 +30,8 @@ The 0.11 porting guide
 * multifdsink, tcpclientsink, tcpclientsrc, tcpserversrc the protocol property
   is removed, use gdppay and gdpdepay.
 
-* Presets and plugins moved to $XDG_DATA_HOME/gstreamer-0.11/ root
-  directory. Registry moved to $XDG_CACHE_HOME/gstreamer-0.11/.
+* Presets and plugins moved to $XDG_DATA_HOME/gstreamer-1.0/ root
+  directory. Registry moved to $XDG_CACHE_HOME/gstreamer-1.0/.
   XDG_CACHE_HOME usually points to $HOME/.cache and XDG_DATA_HOME
   usually is $HOME/.local/share/.
 
@@ -207,8 +219,8 @@ The 0.11 porting guide
 
     The GST_MINI_OBJECT_READONLY flag was removed as it used to mark the
     memory in buffers as READONLY. Marking memory READONLY can now be done
-    with the GstMemory API. Writability of miniobjects is now only done by using
-    the refcount.
+    with the GstMemory API. Writability of miniobjects is now either done
+    by using the refcount or by using exclusive locking.
 
 * GstBuffer
     A GstBuffer is now a simple boxed type this means that subclassing is not