Bug 145975 – [GTK] devhelp is broken

• Status: RESOLVED
• Resolution: FIXED
• Component: WebKitGTK

[Michael Catanzaro]

Devhelp and Builder's devhelp plugin cannot load our devhelp. Not sure if it has broken again, or if we messed up the last time we tried to fix this:

Devhelp[925]:  WARNING: Failed to read '/usr/share/gtk-doc/html/webkit2gtk-4.0/webkit2gtk-4.0.devhelp2': Invalid namespace '' at line 3, column 1

Line 3, column 1 is a space. The first three lines of the file are:

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<book xmlns="" title="WebKit2GTK+ Reference Manual" link="index.html" author="" name="webkit2gtk-4.0" version="2" language="c">
  <chapters>

I'm not sure what's wrong, but I do notice that other devhelp files have this on the second line of the file:

<!DOCTYPE book PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "">

I wonder why ours doesn't.

[Michael Catanzaro]

Created attachment 255553 [details]
Invalid devhelp file (from 2.8.3)

[Michael Catanzaro]

Created attachment 255554 [details]
Invalid webkitdomgtk-4.0.devhelp2 from 2.8.3

[Michael Catanzaro]

Looks like gudev.devhelp2 and libudev.devhelp2 have this same problem:

(devhelp:9389): Devhelp-WARNING **: Failed to read '/usr/share/gtk-doc/html/gudev/gudev.devhelp2': Invalid namespace '' at line 3, column 1

(devhelp:9389): Devhelp-WARNING **: Failed to read '/usr/share/gtk-doc/html/webkitdomgtk-4.0/webkitdomgtk-4.0.devhelp2': Invalid namespace '' at line 3, column 1

(devhelp:9389): Devhelp-WARNING **: Failed to read '/usr/share/gtk-doc/html/libudev/libudev.devhelp2': Invalid namespace '' at line 3, column 1

(devhelp:9389): Devhelp-WARNING **: Failed to read '/usr/share/gtk-doc/html/webkit2gtk-4.0/webkit2gtk-4.0.devhelp2': Invalid namespace '' at line 3, column 1

[Sébastien Wilmet]

You can close this bug, it was for the xmlns attribute. I see that you've fixed it correctly. And Devhelp shows a more useful warning message now.

[Michael Catanzaro]

I'm sure it was fixed at some point in the past, but our documentation is not being loaded at all on Fedora 28.

[Michael Catanzaro]

(In reply to Michael Catanzaro from comment #5)
> I'm sure it was fixed at some point in the past, but our documentation is
> not being loaded at all on Fedora 28.

I think that's probably bug #185468. Closing this.