Control: tags -1 + upstream

On Thu, 21 Nov 2019 at 19:49:37 +0100, Helmut Grohne wrote:
> libpsl recently (within the last seven days) started to FTBFS in
> unstable:
> | warning: failed to load external entity "../xml/tree_index.sgml"
> | ../libpsl-docs.sgml:27: element include: XInclude error : could not load 
> ../xml/tree_index.sgml, and no fallback was found

This is very likely to be a regression with gtk-doc 1.3x (1.30 I think?),
and will affect upstream builds equally. gtk-doc stopped generating files
that would previously have been generated empty. This is a deliberate
change by upstream (https://gitlab.gnome.org/GNOME/gtk-doc/issues/103)
so it is unlikely to be reverted.

The GNOME team tried to file bugs for this while gtk-doc 1.32 was only
in experimental, but the mass-rebuild must have missed libpsl.

Library maintainers can either solve this class of bug by not
attempting to include the object tree at all, which for example is
appropriate if the library does not include any GObject subclasses:
https://gitlab.freedesktop.org/gstreamer/gst-libav/merge_requests/40

or by adding an empty <xi:fallback/> inside the <xi:include> element
for ../xml/tree_index.sgml (meaning "if you can't, substitute the empty
string instead") to return to the previous behaviour, similar to this
in GTK's documentation:

  <index id="api-index-3-24" role="3.24">
    <title>Index of new symbols in 3.24</title>
    <xi:include href="xml/api-index-3.24.xml"><xi:fallback /></xi:include>
  </index>

Regards,
    smcv

Reply via email to