GNOME Bugzilla – Bug 644666
pygobject & pygtk reference documentation hard to use with newer browsers
Last modified: 2014-01-26 22:20:00 UTC
The reference documentation for PyGObject and PyGTK as hosted on library.gnome.org contain <br></br> tags in the "Synopsis" sections of the classes documented in those projects. This is being rendered as two newlines instead of a single newline with newer browsers, making the reference docs hard to use. I suspect library.gnome.org does not use the xsl stylesheet files distributed with PyGObject as the reference docs generated by ./configure && make for both PyGObject and PyGTK simply have <br> instead of <br></br>. Looking over [1] I do not see where the <br></br> is being generated though... Note: I originally reported this as a Firefox 4 beta bug [2] with [3] as an example, but looking at the discussion that follows that bug report other newer browser version (chrome, ie9) seem to have the same issue. [1] http://git.gnome.org/browse/library-web [2] https://bugzilla.mozilla.org/show_bug.cgi?id=641239 [3] http://library.gnome.org/devel/pygtk/2.22/class-gtkwidget.html
Created attachment 183295 [details] correct rendering
Created attachment 183296 [details] problematic rendering
Umm, perhaps we should investigate whether changing those unclosed <br> tags should be converted to the more xml compliant </ br>. Maybe the closing tags are being generated by the browsers when working on an xhtml mode or something like it that would expect closing tags.
Workaround the issue as it's unlikely to be resolved. commit 21bd9af2cd1aee0a83db956009ecb3d90fa6c413 Author: Frédéric Péters <fpeters@0d.be> Date: Sun Jan 26 22:17:32 2014 +0000 conceal consecutive line breaks https://bugzilla.gnome.org/show_bug.cgi?id=644666