44.rc: fail to build with -Dgtk_doc=true
Affected version
44.rc
Bug summary
Hi, I am trying to build 44.rc on NixOS with -Dgtk_doc=true
and the build fails with:
Build log
ERROR: Error in gtkdoc helper script:
ERROR: ['/nix/store/y8yavwpnzpg3ig64y1ja21kgssyh3qif-gtk-doc-1.33.2/bin/gtkdoc-mkhtml', '--path=/build/gnome-shell-44.rc/docs/reference/shell:/build/gnome-shell-44.rc/build/docs/reference/shell', 'shell', '../shell-docs.sgml'] failed with status 6
warning: failed to load external entity "../xml/shell-embedded-window.xml"
../shell-docs.sgml:34: element include: XInclude error : could not load ../xml/shell-embedded-window.xml, and no fallback was found
warning: failed to load external entity "../xml/shell-gtk-embed.xml"
../shell-docs.sgml:35: element include: XInclude error : could not load ../xml/shell-gtk-embed.xml, and no fallback was found
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
../doc-gen-org.gnome.Shell.SearchProvider.xml:4: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
]>
^
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
../doc-gen-org.gnome.Shell.SearchProvider2.xml:4: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
]>
^
--- stderr ---
FAILED: install script '/nix/store/xwdx5di5i7flk1s7fm95nqrg8qvk6nkk-meson-1.0.0/bin/meson --internal gtkdoc --sourcedir=/build/gnome-shell-44.rc --builddir=/build/gnome-shell-44.rc/build --subdir=docs/reference/shell --headerdirs=/build/gnome-shell-44.rc/src@@/build/gnome-shell-44.rc/build/src --mainfile=shell-docs.sgml --modulename=shell --moduleversion= --mode=auto --gtkdoc-scan=/nix/store/y8yavwpnzpg3ig64y1ja21kgssyh3qif-gtk-doc-1.33.2/bin/gtkdoc-scan --gtkdoc-scangobj=/nix/store/y8yavwpnzpg3ig64y1ja21kgssyh3qif-gtk-doc-1.33.2/bin/gtkdoc-scangobj --gtkdoc-mkdb=/nix/store/y8yavwpnzpg3ig64y1ja21kgssyh3qif-gtk-doc-1.33.2/bin/gtkdoc-mkdb --gtkdoc-mkhtml=/nix/store/y8yavwpnzpg3ig64y1ja21kgssyh3qif-gtk-doc-1.33.2/bin/gtkdoc-mkhtml --gtkdoc-fixxref=/nix/store/y8yavwpnzpg3ig64y1ja21kgssyh3qif-gtk-doc-1.33.2/bin/gtkdoc-fixxref --htmlargs= --scanargs=--ignore-headers=gactionmuxer.h gactionobservable.h gactionobserver.h shell-network-agent.h calendar-server hotplug-sniffer st tray --scanobjsargs= --gobjects-types-file= --fixxrefargs= --mkdbargs= --html-assets= --content-files= --expand-content-files= --ignore-headers= --installdir= --cc=gcc --ld=gcc' exit code 1, stopped
FAILED: meson-internal__install
/nix/store/xwdx5di5i7flk1s7fm95nqrg8qvk6nkk-meson-1.0.0/bin/meson install --no-rebuild
ninja: build stopped: subcommand failed.
It looks like ../shell-docs.sgml:xx: element include: XInclude error : could not load xxx, and no fallback was found
is the reason, after doing this it seems to build again:
diff --git a/docs/reference/shell/shell-docs.sgml b/docs/reference/shell/shell-docs.sgml
index af2d543..04255cd 100644
--- a/docs/reference/shell/shell-docs.sgml
+++ b/docs/reference/shell/shell-docs.sgml
@@ -31,8 +31,6 @@
</chapter>
<chapter>
<title>Tray Icons</title>
- <xi:include href="xml/shell-embedded-window.xml"/>
- <xi:include href="xml/shell-gtk-embed.xml"/>
<xi:include href="xml/shell-tray-icon.xml"/>
<xi:include href="xml/shell-tray-manager.xml"/>
</chapter>
Probably this is related to !2590 (merged) which removes src/shell-embedded-window.*
and src/shell-gtk-embed.*
(cc @carlosg), assuming we are using gtk-doc
to generate the docs?
Steps to reproduce
- Build 44.rc with
-Dgtk_doc=true
What happened
Build fails
What did you expect to happen
Build succeed
Relevant logs, screenshots, screencasts etc.
See above
Thanks for reading!
Edited by Bobby Rong