From 86bef7fdb8f8714e37f47d21535d664038577610 Mon Sep 17 00:00:00 2001
From: Wim Taymans <wim.taymans@gmail.com>
Date: Sat, 7 Jul 2001 15:10:29 +0000
Subject: [PATCH] Added docs on library init.

Original commit message from CVS:
Added docs on library init.
---
 docs/manual/gstreamer-manual.sgml |  3 +++
 docs/manual/init.sgml             | 38 +++++++++++++++++++++++++++++++
 docs/manual/utility.sgml          | 14 ++++++++++++
 3 files changed, 55 insertions(+)
 create mode 100644 docs/manual/init.sgml

diff --git a/docs/manual/gstreamer-manual.sgml b/docs/manual/gstreamer-manual.sgml
index 7c718c155d..43e6c9ad86 100644
--- a/docs/manual/gstreamer-manual.sgml
+++ b/docs/manual/gstreamer-manual.sgml
@@ -3,6 +3,7 @@
 <!ENTITY MOTIVATION SYSTEM "motivation.sgml">
 <!ENTITY GOALS SYSTEM "goals.sgml">
 
+<!ENTITY INIT SYSTEM "init.sgml">
 <!ENTITY ELEMENTS SYSTEM "elements.sgml">
 <!ENTITY PADS SYSTEM "pads.sgml">
 <!ENTITY CONNECTIONS SYSTEM "connections.sgml">
@@ -98,6 +99,8 @@
     </partintro>
 
 <!-- ############ Basic concepts - chapter ############# -->
+      &INIT;
+
       &ELEMENTS;
 
       &PLUGINS;
diff --git a/docs/manual/init.sgml b/docs/manual/init.sgml
new file mode 100644
index 0000000000..985dcc2149
--- /dev/null
+++ b/docs/manual/init.sgml
@@ -0,0 +1,38 @@
+<chapter id="cha-initialisation">
+  <title>Initializing <application>GStreamer</application></title>
+  <para> 
+    When writing a <application>GStreamer</application> application, you can
+    simply include gst/gst.h to get access to the library functions.
+  </para> 
+  <para> 
+    Before the <application>GStreamer</application> libraries can be used
+    gst_init () has to be performed from the main app. this call will perform
+    first initialisation and will parse the GStreamer specific command line 
+    options. 
+  </para>
+  <para> 
+    A typical program would start like this:
+  </para>
+
+  <programlisting>
+#include &lt;gst/gst.h&gt;
+
+...
+
+int
+main (int argc, char *argv[])
+{
+  ...
+  gst_init (&amp;argc, &amp;argv);
+  ...
+}
+  </programlisting>
+  <para>
+    It is also possible to call the gst_init method with two NULL argumants.
+  </para>
+  <para> 
+    Use the GST_VERSION_MAJOR, GST_VERSION_MINOR and GST_VERSION_MICRO macros to
+    get the <application>GStreamer</application> version you are building against.
+  </para>
+
+</chapter>
diff --git a/docs/manual/utility.sgml b/docs/manual/utility.sgml
index ca5a39b1c3..85b304ec6b 100644
--- a/docs/manual/utility.sgml
+++ b/docs/manual/utility.sgml
@@ -63,6 +63,20 @@
       </listitem>
     </itemizedlist>
   </para> 
+  <para> 
+    One usually sets object properties using g_object_set (). The problem with this
+    method is that you need to know the type of the property. A convenience function,
+    gst_utils_set_object_arg () is therefore provided so that you can always set 
+    the property with a string value. for example:
+  </para>
+  <programlisting>
+  gst_util_set_object_arg (someobject, "int_property", "1000");
+  </programlisting>
+  <para>
+    Will do The Right Thing(tm), converting the string to the type of the property when
+    needed.
+  </para>
+
   <para> 
     There is also another utility function that can be used to dump a block
     of memory on the console. This function is very usefull for plugin
-- 
2.34.1