GNOME Bugzilla – Bug 783181
404 on "Index of deprecated symbols" / "new symbols since 2.xx" in glib 2.52 docs
Last modified: 2017-10-27 11:14:28 UTC
Compare the links between index and annotation glossary in https://developer.gnome.org/glib/2.50/ https://developer.gnome.org/glib/2.52/ Also the next link in https://developer.gnome.org/glib/2.52/api-index-full.html points to https://developer.gnome.org/glib/2.52/api-index-deprecated.html Which is a 404. Same thing applies with unstable
I can’t see anything which has changed in GLib’s documentation templates or configuration between 2.50 and 2.52 which could have caused this, so I’m guessing it’s a gtk-doc bug.
I just build the glib docs from git-head with gtk-doc from git head and stable (1.25) and the look good (no missing links). I guess someone needs to rebuild and re-upload the docs for 2.52
(In reply to Stefan Sauer (gstreamer, gtkdoc dev) from comment #2) > I guess someone needs to rebuild and re-upload the docs for 2.52 Matthias?
The glib 2.54 docs still have this issue, so I guess it wasn't a matter of requiring a re-upload
Indeed, I’ve just built the docs locally for GLib git master, with gtk-doc git master (1.26.1, 95a93122a2934e618024f291620edd9c9a3c4e3b), and I’m seeing the same problem: • api-index-deprecated.html is missing, but a new file ‘deprecated.html’ seems to be present with the right content; it’s linked to from a few pages, but api-index-full.html still links to api-index-deprecated.html • api-index-$versions.html are all missing (linked to from some pages, but the HTML pages are not generated or installed) These links are not something configured in GLib: the only references it has to `api-index-*` are <xi:include>s in docs/reference/glib/glib-docs.xml: https://git.gnome.org/browse/glib/tree/docs/reference/glib/glib-docs.xml Looks to me like it is a gtk-doc bug.
The file 'deprecated.html' is not new. It is created from https://git.gnome.org/browse/glib/tree/docs/reference/glib/glib-docs.xml#n124 For me the index files are created: ll {xml,html}/api-index-deprecated* -rw-r----- 1 ensonic eng 42040 Oct 26 21:38 html/api-index-deprecated.html -rw-r----- 1 ensonic eng 32554 May 14 21:28 xml/api-index-deprecated.xml Same for the index files: ll {html,xml}/api-index-2* -rw-r----- 1 ensonic eng 10189 Oct 26 21:56 html/api-index-2-10.html -rw-r----- 1 ensonic eng 21387 Oct 26 21:56 html/api-index-2-12.html -rw-r----- 1 ensonic eng 38729 Oct 26 21:56 html/api-index-2-14.html -rw-r----- 1 ensonic eng 20797 Oct 26 21:56 html/api-index-2-16.html -rw-r----- 1 ensonic eng 6208 Oct 26 21:56 html/api-index-2-18.html -rw-r----- 1 ensonic eng 4918 Oct 26 21:56 html/api-index-2-20.html -rw-r----- 1 ensonic eng 11318 Oct 26 21:56 html/api-index-2-22.html -rw-r----- 1 ensonic eng 23901 Oct 26 21:56 html/api-index-2-24.html -rw-r----- 1 ensonic eng 23241 Oct 26 21:56 html/api-index-2-26.html -rw-r----- 1 ensonic eng 7401 Oct 26 21:56 html/api-index-2-28.html -rw-r----- 1 ensonic eng 7383 Oct 26 21:56 html/api-index-2-2.html -rw-r----- 1 ensonic eng 15801 Oct 26 21:56 html/api-index-2-30.html -rw-r----- 1 ensonic eng 20009 Oct 26 21:56 html/api-index-2-32.html -rw-r----- 1 ensonic eng 6973 Oct 26 21:56 html/api-index-2-34.html -rw-r----- 1 ensonic eng 7271 Oct 26 21:56 html/api-index-2-36.html -rw-r----- 1 ensonic eng 7012 Oct 26 21:56 html/api-index-2-38.html -rw-r----- 1 ensonic eng 9661 Oct 26 21:56 html/api-index-2-40.html -rw-r----- 1 ensonic eng 2464 Oct 26 21:56 html/api-index-2-42.html -rw-r----- 1 ensonic eng 7326 Oct 26 21:56 html/api-index-2-44.html -rw-r----- 1 ensonic eng 4254 Oct 26 21:56 html/api-index-2-46.html -rw-r----- 1 ensonic eng 4483 Oct 26 21:56 html/api-index-2-48.html -rw-r----- 1 ensonic eng 23611 Oct 26 21:56 html/api-index-2-4.html -rw-r----- 1 ensonic eng 7691 Oct 26 21:56 html/api-index-2-50.html -rw-r----- 1 ensonic eng 2479 Oct 26 21:56 html/api-index-2-52.html -rw-r----- 1 ensonic eng 3794 Oct 26 21:56 html/api-index-2-54.html -rw-r----- 1 ensonic eng 28499 Oct 26 21:56 html/api-index-2-6.html -rw-r----- 1 ensonic eng 9512 Oct 26 21:56 html/api-index-2-8.html -rw-r----- 1 ensonic eng 6876 Oct 26 21:55 xml/api-index-2.10.xml -rw-r----- 1 ensonic eng 16131 Oct 26 21:55 xml/api-index-2.12.xml -rw-r----- 1 ensonic eng 30451 Oct 26 21:55 xml/api-index-2.14.xml -rw-r----- 1 ensonic eng 16188 Oct 26 21:55 xml/api-index-2.16.xml -rw-r----- 1 ensonic eng 3503 Oct 26 21:55 xml/api-index-2.18.xml -rw-r----- 1 ensonic eng 2646 Oct 26 21:55 xml/api-index-2.20.xml -rw-r----- 1 ensonic eng 7696 Oct 26 21:55 xml/api-index-2.22.xml -rw-r----- 1 ensonic eng 19754 Oct 26 21:55 xml/api-index-2.24.xml -rw-r----- 1 ensonic eng 18837 Oct 26 21:55 xml/api-index-2.26.xml -rw-r----- 1 ensonic eng 4692 Oct 26 21:55 xml/api-index-2.28.xml -rw-r----- 1 ensonic eng 4225 Oct 26 21:55 xml/api-index-2.2.xml -rw-r----- 1 ensonic eng 11060 Oct 26 21:55 xml/api-index-2.30.xml -rw-r----- 1 ensonic eng 14785 Oct 26 21:55 xml/api-index-2.32.xml -rw-r----- 1 ensonic eng 4237 Oct 26 21:55 xml/api-index-2.34.xml -rw-r----- 1 ensonic eng 4340 Oct 26 21:55 xml/api-index-2.36.xml -rw-r----- 1 ensonic eng 4545 Oct 26 21:55 xml/api-index-2.38.xml -rw-r----- 1 ensonic eng 6352 Oct 26 21:55 xml/api-index-2.40.xml -rw-r----- 1 ensonic eng 880 Oct 26 21:55 xml/api-index-2.42.xml -rw-r----- 1 ensonic eng 4512 Oct 26 21:55 xml/api-index-2.44.xml -rw-r----- 1 ensonic eng 2307 Oct 26 21:55 xml/api-index-2.46.xml -rw-r----- 1 ensonic eng 2369 Oct 26 21:55 xml/api-index-2.48.xml -rw-r----- 1 ensonic eng 17587 Oct 26 21:55 xml/api-index-2.4.xml -rw-r----- 1 ensonic eng 4723 Oct 26 21:55 xml/api-index-2.50.xml -rw-r----- 1 ensonic eng 1003 Oct 26 21:55 xml/api-index-2.52.xml -rw-r----- 1 ensonic eng 1890 Oct 26 21:55 xml/api-index-2.54.xml -rw-r----- 1 ensonic eng 819 Oct 26 21:55 xml/api-index-2.56.xml -rw-r----- 1 ensonic eng 21579 Oct 26 21:55 xml/api-index-2.6.xml -rw-r----- 1 ensonic eng 5937 Oct 26 21:55 xml/api-index-2.8.xml I have not fixed anything related to index generation since then.
Can this be a dupe of #785139 ?
https://bugzilla.gnome.org/show_bug.cgi?id=785139 Please let me know what linux and which versions of the docbook stylesheets.
(In reply to Stefan Sauer (gstreamer, gtkdoc dev) from comment #8) > Please let me know what linux and which versions of the docbook stylesheets. I’m on Fedora 26, with docbook-style-xsl-1.79.2-4.fc26.src.rpm. I suspect Matthias is as well, which would explain the same problems appearing in the online docs (since he generates the tarballs). Indeed, if I list the xml/ directory, the api-*.xml files are all present. They’re just missing in the html/ directory. This definitely looks like a dupe of bug #785139. *** This bug has been marked as a duplicate of bug 785139 ***