Linker errors when trying to build docs for 'shell'

[cmcl]

 * Xreader version (xreader 3.3.0)
 * Distribution - (Mint 20.3 Una)

Issue

I have encountered an error when trying to build the documentation for help/reference/shell:

Building documentation for libxreaderview
/home/cmcl/projects/linux-mint-sandbox/xreader/libview/ev-view.c:6024: warning: Parameter description for ev_view_set_page_cache_size::view is missing in source code comment block.
/home/cmcl/projects/linux-mint-sandbox/xreader/libview/ev-view.c:6024: warning: Parameter description for ev_view_set_page_cache_size::cache_size is missing in source code comment block.
./libxreaderview-sections.txt:3: warning: No declaration found for EvAnnotationWindow.
./libxreaderview-sections.txt:4: warning: No declaration found for EvAnnotationWindowClass.
./libxreaderview-sections.txt:5: warning: No declaration found for ev_annotation_window_new.
./libxreaderview-sections.txt:6: warning: No declaration found for ev_annotation_window_get_annotation.
./libxreaderview-sections.txt:7: warning: No declaration found for ev_annotation_window_set_annotation.
./libxreaderview-sections.txt:8: warning: No declaration found for ev_annotation_window_is_open.
./libxreaderview-sections.txt:9: warning: No declaration found for ev_annotation_window_get_rectangle.
./libxreaderview-sections.txt:10: warning: No declaration found for ev_annotation_window_set_rectangle.
./libxreaderview-sections.txt:11: warning: No declaration found for ev_annotation_window_grab_focus.
./libxreaderview-sections.txt:12: warning: No declaration found for ev_annotation_window_ungrab_focus.
unknown:0: warning: Value descriptions for EvViewSelectionMode are missing in source code comment block.
./libxreaderview-sections.txt:36: warning: No declaration found for ev_view_set_presentation.
./libxreaderview-sections.txt:37: warning: No declaration found for ev_view_get_presentation.
./libxreaderview-sections.txt:65: warning: No declaration found for EvPageCache.
./libxreaderview-sections.txt:66: warning: No declaration found for EvPageCacheClass.
./libxreaderview-sections.txt:67: warning: No declaration found for ev_page_cache_new.
./libxreaderview-sections.txt:68: warning: No declaration found for ev_page_cache_set_page_range.
./libxreaderview-sections.txt:69: warning: No declaration found for ev_page_cache_get_flags.
./libxreaderview-sections.txt:70: warning: No declaration found for ev_page_cache_set_flags.
./libxreaderview-sections.txt:71: warning: No declaration found for ev_page_cache_get_link_mapping.
./libxreaderview-sections.txt:72: warning: No declaration found for ev_page_cache_get_image_mapping.
./libxreaderview-sections.txt:73: warning: No declaration found for ev_page_cache_get_form_field_mapping.
./libxreaderview-sections.txt:74: warning: No declaration found for ev_page_cache_get_annot_mapping.
./libxreaderview-sections.txt:75: warning: No declaration found for ev_page_cache_get_text_mapping.
unknown:0: warning: Field descriptions for struct EvJobClass are missing in source code comment block.
unknown:0: warning: Field descriptions for struct EvJobFontsClass are missing in source code comment block.
unknown:0: warning: Field descriptions for struct EvJobFindClass are missing in source code comment block.
unknown:0: warning: Value descriptions for EvJobRunMode are missing in source code comment block.
unknown:0: warning: Value descriptions for EvJobPageDataFlags are missing in source code comment block.
unknown:0: warning: Value descriptions for EvSizingMode are missing in source code comment block.
./libxreaderview-sections.txt:323: warning: No declaration found for ev_view_selection_mode_get_type.
./libxreaderview-sections.txt:324: warning: No declaration found for EV_TYPE_VIEW_SELECTION_MODE.
unknown:0: warning: Value descriptions for EvJobPriority are missing in source code comment block.
./libxreaderview-sections.txt:336: warning: No declaration found for EvViewCursor.
./libxreaderview-sections.txt:337: warning: No declaration found for ev_view_cursor_new.
See libxreaderview-undeclared.txt for the list of undeclared symbols.
./libxreaderview-unused.txt:1: warning: 62 unused declarations. They should be added to libxreaderview-sections.txt in the appropriate place.

html/EvJob.html:540: warning: no link for: "EvDocument" -> (<span class="type">EvDocument</span>).
html/EvJob.html:577: warning: no link for: "EvRectangle" -> (<span class="type">EvRectangle</span>).
html/EvJob.html:578: warning: no link for: "EvSelectionStyle" -> (<span class="type">EvSelectionStyle</span>).
html/libxreaderview-ev-view.html:399: warning: no link for: "EvLinkAction" -> (<span class="type">EvLinkAction</span>).
html/libxreaderview-ev-view.html:501: warning: no link for: "EvLink" -> (<span class="type">EvLink</span>).
html/libxreaderview-ev-view.html:580: warning: no link for: "EvAnnotation" -> (<span class="type">EvAnnotation</span>).

Running custom install script '/usr/bin/meson --internal gtkdoc --sourcedir=/home/cmcl/projects/linux-mint-sandbox/xreader --builddir=/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build --subdir=help/reference/shell --headerdirs=/home/cmcl/projects/linux-mint-sandbox/xreader/libview@@/home/cmcl/projects/linux-mint-sandbox/xreader/shell --mainfile=xreader-docs.xml --modulename=xreader --moduleversion= --mode=xml --gtkdoc-scan=/usr/bin/gtkdoc-scan --gtkdoc-scangobj=/usr/bin/gtkdoc-scangobj --gtkdoc-mkdb=/usr/bin/gtkdoc-mkdb --gtkdoc-mkhtml=/usr/bin/gtkdoc-mkhtml --gtkdoc-fixxref=/usr/bin/gtkdoc-fixxref --gobjects-types-file=/home/cmcl/projects/linux-mint-sandbox/xreader/help/reference/shell/xreader.types --fixxrefargs=--extra-dir=/usr/share/gtk-doc/html/glib@@--extra-dir=/usr/share/gtk-doc/html/gio@@--extra-dir=/usr/share/gtk-doc/html/gdk@@--extra-dir=/usr/share/gtk-doc/html/gdk-pixbuf@@--extra-dir=/usr/share/gtk-doc/html/gtk --mkdbargs=--xml-mode@@--output-format=xml@@--name-space=ev --content-files= --ignore-headers=ev-annotation-window.h@@ev-link-accessible.h@@ev-loading-window.h@@ev-page-cache.h@@ev-pixbuf-cache.h@@ev-timeline.h@@ev-transition-animation.h@@ev-view-accessible.h@@ev-view-cursor.h@@ev-view-private.h --installdir=xreader --cc=ccache cc --ld=cc --cflags=-I/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libdocument/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/libdocument/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libview/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/libview/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/help/reference/shell/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/help/reference/shell/. -pthread -I/usr/include/gail-3.0 -I/usr/include/gtk-3.0 -I/usr/include/at-spi2-atk/2.0 -I/usr/include/at-spi-2.0 -I/usr/include/dbus-1.0 -I/usr/lib/x86_64-linux-gnu/dbus-1.0/include -I/usr/include/gio-unix-2.0 -I/usr/include/cairo -I/usr/include/pango-1.0 -I/usr/include/fribidi -I/usr/include/harfbuzz -I/usr/include/atk-1.0 -I/usr/include/pixman-1 -I/usr/include/uuid -I/usr/include/freetype2 -I/usr/include/libpng16 -I/usr/include/gdk-pixbuf-2.0 -I/usr/include/libmount -I/usr/include/blkid -I/usr/include/glib-2.0 -I/usr/lib/x86_64-linux-gnu/glib-2.0/include -I/usr/include/gtk-3.0/unix-print -I/usr/include/webkitgtk-4.0 -I/usr/include/libsoup-2.4 -I/usr/include/libxml2 -I/usr/include/libsecret-1 -I/usr/include/xapp \'-DDATADIR="/home/cmcl/projects/linux-mint-sandbox/share"\' \'-DLIBDIR="/home/cmcl/projects/linux-mint-sandbox/lib/x86_64-linux-gnu"\' \'-DBINDIR="/home/cmcl/projects/linux-mint-sandbox/bin"\' \'-DEV_BACKENDSDIR="/home/cmcl/projects/linux-mint-sandbox/lib/x86_64-linux-gnu/xreader/3/backends"\' \'-DXREADERDATADIR="/home/cmcl/projects/linux-mint-sandbox/share/xreader"\' -Werror=implicit-function-declaration -DENABLE_EPUB -Wno-deprecated-declarations -Wno-deprecated -Wno-declaration-after-statement \'-DXREADER_LOCALE_DIR="/home/cmcl/projects/linux-mint-sandbox/share/locale"\' -DXREADER_COMPILATION -DHAVE_CONFIG_H --ldflags=-L/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libview -Wl,-rpath,/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libview -L/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libdocument -Wl,-rpath,/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libdocument -lxreaderview -lxreaderdocument -lgailutil-3 -lgtk-3 -lgdk-3 -lpangocairo-1.0 -lpango-1.0 -lharfbuzz -latk-1.0 -lcairo-gobject -lcairo -lgdk_pixbuf-2.0 -lgio-2.0 -lgobject-2.0 -lglib-2.0 -lm -lwebkit2gtk-4.0 -lsoup-2.4 -ljavascriptcoregtk-4.0 -lgmodule-2.0 -pthread -lsecret-1 -lxapp'
Building documentation for xreader
ERROR: Error in gtkdoc helper script:

ERROR: ['/usr/bin/gtkdoc-scangobj', '--types=/home/cmcl/projects/linux-mint-sandbox/xreader/help/reference/shell/xreader.types', '--module=xreader', '--run=', '--cflags=-I/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libdocument/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/libdocument/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libview/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/libview/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/help/reference/shell/. -I/home/cmcl/projects/linux-mint-sandbox/xreader/help/reference/shell/. -pthread -I/usr/include/gail-3.0 -I/usr/include/gtk-3.0 -I/usr/include/at-spi2-atk/2.0 -I/usr/include/at-spi-2.0 -I/usr/include/dbus-1.0 -I/usr/lib/x86_64-linux-gnu/dbus-1.0/include -I/usr/include/gio-unix-2.0 -I/usr/include/cairo -I/usr/include/pango-1.0 -I/usr/include/fribidi -I/usr/include/harfbuzz -I/usr/include/atk-1.0 -I/usr/include/pixman-1 -I/usr/include/uuid -I/usr/include/freetype2 -I/usr/include/libpng16 -I/usr/include/gdk-pixbuf-2.0 -I/usr/include/libmount -I/usr/include/blkid -I/usr/include/glib-2.0 -I/usr/lib/x86_64-linux-gnu/glib-2.0/include -I/usr/include/gtk-3.0/unix-print -I/usr/include/webkitgtk-4.0 -I/usr/include/libsoup-2.4 -I/usr/include/libxml2 -I/usr/include/libsecret-1 -I/usr/include/xapp \'-DDATADIR="/home/cmcl/projects/linux-mint-sandbox/share"\' \'-DLIBDIR="/home/cmcl/projects/linux-mint-sandbox/lib/x86_64-linux-gnu"\' \'-DBINDIR="/home/cmcl/projects/linux-mint-sandbox/bin"\' \'-DEV_BACKENDSDIR="/home/cmcl/projects/linux-mint-sandbox/lib/x86_64-linux-gnu/xreader/3/backends"\' \'-DXREADERDATADIR="/home/cmcl/projects/linux-mint-sandbox/share/xreader"\' -Werror=implicit-function-declaration -DENABLE_EPUB -Wno-deprecated-declarations -Wno-deprecated -Wno-declaration-after-statement \'-DXREADER_LOCALE_DIR="/home/cmcl/projects/linux-mint-sandbox/share/locale"\' -DXREADER_COMPILATION -DHAVE_CONFIG_H', '--ldflags=-L/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libview -Wl,-rpath,/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libview -L/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libdocument -Wl,-rpath,/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libdocument -lxreaderview -lxreaderdocument -lgailutil-3 -lgtk-3 -lgdk-3 -lpangocairo-1.0 -lpango-1.0 -lharfbuzz -latk-1.0 -lcairo-gobject -lcairo -lgdk_pixbuf-2.0 -lgio-2.0 -lgobject-2.0 -lglib-2.0 -lm -lwebkit2gtk-4.0 -lsoup-2.4 -ljavascriptcoregtk-4.0 -lgmodule-2.0 -pthread -lsecret-1 -lxapp', '--cc=ccache cc', '--ld=cc', '--output-dir=/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/help/reference/shell'] failed with status 1
/usr/bin/ld: xreader-scan.o: in function `get_object_types':
xreader-scan.c:(.text+0x1e): undefined reference to `egg_find_bar_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x42): undefined reference to `ev_application_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x66): undefined reference to `ev_file_monitor_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x8a): undefined reference to `ev_history_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0xae): undefined reference to `ev_message_area_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0xd2): undefined reference to `ev_metadata_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0xf6): undefined reference to `ev_open_recent_action_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x11a): undefined reference to `ev_page_action_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x13e): undefined reference to `ev_page_action_widget_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x162): undefined reference to `ev_password_view_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x186): undefined reference to `ev_progress_message_area_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x1aa): undefined reference to `ev_properties_dialog_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x1ce): undefined reference to `ev_properties_fonts_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x1f2): undefined reference to `ev_properties_license_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x216): undefined reference to `ev_sidebar_attachments_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x23a): undefined reference to `ev_sidebar_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x25e): undefined reference to `ev_sidebar_layers_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x282): undefined reference to `ev_sidebar_links_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x2a6): undefined reference to `ev_sidebar_page_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x2ca): undefined reference to `ev_sidebar_thumbnails_get_type'
/usr/bin/ld: xreader-scan.c:(.text+0x2ee): undefined reference to `ev_window_get_type'
collect2: error: ld returned 1 exit status
2022-05-26 23:51:22,188:scangobj.py:execute_command:1199:WARNING:Linking scanner failed: 1, command: cc xreader-scan.o -L/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libview -Wl,-rpath,/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libview -L/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libdocument -Wl,-rpath,/home/cmcl/projects/linux-mint-sandbox/xreader/debian/build/libdocument -lxreaderview -lxreaderdocument -lgailutil-3 -lgtk-3 -lgdk-3 -lpangocairo-1.0 -lpango-1.0 -lharfbuzz -latk-1.0 -lcairo-gobject -lcairo -lgdk_pixbuf-2.0 -lgio-2.0 -lgobject-2.0 -lglib-2.0 -lm -lwebkit2gtk-4.0 -lsoup-2.4 -ljavascriptcoregtk-4.0 -lgmodule-2.0 -pthread -lsecret-1 -lxapp -o xreader-scan

FAILED: meson-install 
/usr/bin/meson install --no-rebuild
ninja: build stopped: subcommand failed.

Steps to reproduce

I'm starting from unmodified master branch with the following meson configuration:

meson debian/build --prefix=/home/cmcl/projects/linux-mint-sandbox --buildtype=plain -D deprecated_warnings=false -D docs=true -D djvu=true -D dvi=true -D t1lib=false -D pixbuf=true -D comics=true -D introspection=true && ninja -C debian/build && ninja -C debian/build install

Other information

• Commenting out subdir('reference/shell') in help/meson.build successfully builds the remaining docs;
• I tried messing around with the dependencies (including libshell in link_with for xreader_doc_deps) and adding shell_sources to the src_dir value of gnome.gtkdoc in help/reference/shell/meson.build, to no avail.

[okaestne]

In evince they recently removed the whole reference/shell subdir. Can't tell how much the code bases really diverged, but this might be the to-go "solution" here.