diff --git a/docs/gst/tmpl/gstxml.sgml b/docs/gst/tmpl/gstxml.sgml
index 16b34e955f..56d5fe1081 100644
--- a/docs/gst/tmpl/gstxml.sgml
+++ b/docs/gst/tmpl/gstxml.sgml
@@ -2,11 +2,11 @@
 GstXml
 
 <!-- ##### SECTION Short_Description ##### -->
-Convert Elements into an XML presentation
+Convert Elements into an XML presentation.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-All GstElements can be serialized to an XML presentation
+All GstElements can be serialized to an XML presentation and subsequently loaded back.
 
 </para>
 
diff --git a/gst/gstxml.c b/gst/gstxml.c
index f72552a670..61c2a22613 100644
--- a/gst/gstxml.c
+++ b/gst/gstxml.c
@@ -67,7 +67,7 @@ gst_xml_init(GstXML *xml)
  * gst_xml_write:
  * @element: The element to write out
  *
- * converts the given element into an XML presentation
+ * Converts the given element into an XML presentation.
  *
  * Returns: a pointer to an XML document
  */
@@ -149,7 +149,7 @@ gst_xml_new (const guchar *fname, const guchar *root)
  * gst_xml_get_topelements:
  * @xml: The GstXML to get the elements from
  *
- * retrive a list of toplevel elements
+ * Retrive a list of toplevel elements.
  *
  * Returns: a GList of elements
  */