[GTK] Local cross references are broken in API documentation
authorcarlosgc@webkit.org <carlosgc@webkit.org@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Fri, 20 Apr 2018 10:33:30 +0000 (10:33 +0000)
committercarlosgc@webkit.org <carlosgc@webkit.org@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Fri, 20 Apr 2018 10:33:30 +0000 (10:33 +0000)
commitfaaec8cfb216e11235a4af780a826061f440eb01
tree376979d98403edb017fd14b203eeb9bb68cccc50
parent867d3db6d7c2a5d3dfc0941a0a83b68ef8f89c0d
[GTK] Local cross references are broken in API documentation
https://bugs.webkit.org/show_bug.cgi?id=184771

Reviewed by Michael Catanzaro.

.:

Update the documentation html paths and install the JSC GLib API too.

* Source/PlatformGTK.cmake:

Tools:

The problem is that gtkdoc-fixxref expects the links to be in the form html/modulename (like the installed
ones), but we generate the documentation as modulename/html. So, links to WebKitDOM or JSC are generated as
../html/Foo. The rebase command considers html to be the module name in this case, creating broken links in all
the cases.

* gtk/gtkdoc.py:
(GTKDoc._copy_doc_files_to_output_dir): We don't have any html dir in the source tree so, we are not copying
anything here.
(GTKDoc._run_gtkdoc_mkhtml): Create the html dir here using html/modulename instead now.
(GTKDoc._run_gtkdoc_fixxref): Pass the new directory as module dir to gtkdoc-fixxref and fix several links for
which gtkdoc-fixxref always uses absolute paths.
* gtk/manifest.txt.in: Update the documentation html paths and include the JSC GLib API in the tarball too.

git-svn-id: https://svn.webkit.org/repository/webkit/trunk@230837 268f45cc-cd09-0410-ab3c-d52691b4dbfc
ChangeLog
Source/PlatformGTK.cmake
Tools/ChangeLog
Tools/gtk/gtkdoc.py
Tools/gtk/manifest.txt.in