gtk-doc r675 - trunk

[stefkost svn gnome org]

Author: stefkost
Date: Thu Feb  5 15:04:08 2009
New Revision: 675
URL: http://svn.gnome.org/viewvc/gtk-doc?rev=675&view=rev

Log:
	* TODO:
	  Some planning.
	* gtkdoc-mkdb.in:
	  Single tabs are rendered inconsistently in browsers. Replace them with
	  a  .



Modified:
   trunk/ChangeLog
   trunk/TODO
   trunk/gtkdoc-mkdb.in

Modified: trunk/TODO
==============================================================================
--- trunk/TODO	(original)
+++ trunk/TODO	Thu Feb  5 15:04:08 2009
@@ -66,6 +66,9 @@
     - fo.dtd : http://www.renderx.com/Tests/validator/fo.zip
 * single page
   xsltproc  --nonet --xinclude -o gtk-docs.html /home/ensonic/projects/gtk-doc/gtk-doc-single.xsl  gtk-docs.sgml
+  * need to check if we can pass the style-sheet class as a parameter (--stringparam gtkdoc.stylesheet=(chunk|docbook))
+  * we might also need to reflow some things, as gtk-doc.xsl also runs the devhelp/devhelp2 generation
+    - but then the urls in the devhelp file, refer to the chunked html anyway
 * pdf
   * xmlto via passivetex
     xmlto --skip-validation pdf tester-docs.xml

Modified: trunk/gtkdoc-mkdb.in
==============================================================================
--- trunk/gtkdoc-mkdb.in	(original)
+++ trunk/gtkdoc-mkdb.in	Thu Feb  5 15:04:08 2009
@@ -2206,6 +2206,8 @@
     $text =~ s/&/&/g;	# Do this first, or the others get messed up.
     $text =~ s/</&lt;/g;
     $text =~ s/>/&gt;/g;
+    # browers render single tabs inconsistently
+    $text =~ s/([^\s])\t([^\s])/$1&nbsp;$2/g;
     return $text;
 }
 
@@ -3292,6 +3294,7 @@
 	# We're in a comment block. Check if we've found the end of it.
 	if (m%^\s*\*+/%) {
 	    if (!$symbol) {
+		# maybe its not even meant to be a gtk-doc comment?
 		&LogWarning ($file, $., "Symbol name not found at the start of the comment block.");
 	    } else {
 		# Add the return value description onto the end of the params.
@@ -3405,7 +3408,7 @@
 		$symbol = $1;
 		#print "SECTION DOCS found in source for : '$symbol'\n";
 		$ignore_broken_returns = 1;
-	    } elsif (m%^\s*([\w:-]*\w)\s*:?%) {
+	    } elsif (m%^\s*([\w:-]*\w)\s*:?\s*%) {
 		$symbol = $1;
 		#print "SYMBOL DOCS found in source for : '$symbol'\n";
 	    }