[gtk-doc] mkdb: format and extend function comment

[Stefan Kost <stefkost src gnome org>]

commit 25e536de87f2f98b6482c42a8a452b101545a47d
Author: Stefan Kost <ensonic users sf net>
Date:   Tue Mar 29 21:28:46 2011 +0300

    mkdb: format and extend function comment

 gtkdoc-mkdb.in |    9 ++++++---
 1 files changed, 6 insertions(+), 3 deletions(-)
---
diff --git a/gtkdoc-mkdb.in b/gtkdoc-mkdb.in
index 313c16b..4c13c7d 100755
--- a/gtkdoc-mkdb.in
+++ b/gtkdoc-mkdb.in
@@ -4571,8 +4571,12 @@ sub IsEmptyDoc {
 }
 
 
-# This converts blank lines to "</para><para>", but only outside CDATA and
-# <programlisting> tags.
+#############################################################################
+# Function    : ConvertBlankLines
+# Description : Converts blank lines to "</para><para>", but only outside CDATA
+#               and <programlisting> tags.
+# Arguments   : the doc-string, the symbol name
+#############################################################################
 sub ConvertBlankLines {
     return &ModifyXMLElements ($_[0], $_[1],
 			       "<!\\[CDATA\\[|<programlisting[^>]*>|\\|\\[",
@@ -4580,7 +4584,6 @@ sub ConvertBlankLines {
 			       \&ConvertBlankLinesCallback);
 }
 
-
 sub ConvertBlankLinesEndTag {
   if ($_[0] eq "<!\[CDATA\[") {
     return "]]>";