gtk3 documentation

[Patrick Welche <prlw1%talktalk.net@localhost>]

Why was gtk3 documentation building enabled in the last update?

Upstream doesn't build it by default:

# Documentation and introspection
option('gtk_doc', type: 'boolean', value: 'false',
  description : 'Build API reference with gtk-doc')
option('man', type: 'boolean', value: 'false',
  description : 'Build man pages for installed tools')

It is also not harmless:

Building documentation for gdk3
ERROR: Error in gtkdoc helper script:

ERROR: ['/usr/pkg/bin/gtkdoc-scan', '--module=gdk3', '--source-dir=/tmp/pkgsrc/x11/gtk3/work.x86_64/gtk+-3.24.36/gdk/.', '--source-dir=/tmp/pkgsrc/x11/gtk3/work.x86_64/gtk+-3.24.36/output/gdk/.', '--source-dir=/tmp/pkgsrc/x11/gtk3/work.x86_64/gtk+-3.24.36/gdk/x11', '--source-dir=/tmp/pkgsrc/x11/gtk3/work.x86_64/gtk+-3.24.36/output/gdk/x11', '--source-dir=/tmp/pkgsrc/x11/gtk3/work.x86_64/gtk+-3.24.36/gdk/wayland', '--source-dir=/tmp/pkgsrc/x11/gtk3/work.x86_64/gtk+-3.24.36/output/gdk/wayland', '--ignore-decorators=_GDK_EXTERN|G_GNUC_WARN_UNUSED_RESULT', '--ignore-headers=gdkintl.h gdkmarshalers.h gdkkeysyms.h gdkinternals.h gdkprivate.h gdk-private.h gdkapplaunchcontextprivate.h gdkcursorprivate.h gdkdevicemanagerprivate.h gdkdeviceprivate.h gdkdisplaymanagerprivate.h gdkdisplayprivate.h gdkdndprivate.h gdkframeclockprivate.h gdkglcontextprivate.h gdkkeysprivate.h gdkscreenprivate.h gdkseatdefaultprivate.h gdkseatprivate.h gdkvisualprivate.h keyname-table.h win32 x11 quartz broadway wayland'] failed with status 1
Traceback (most recent call last):
  File "/usr/pkg/bin/gtkdoc-scan", line 59, in <module>
    scan.Run(options)
  File "/usr/pkg/share/gtk-doc/python/gtkdoc/scan.py", line 200, in Run
    ScanHeaders(dir, section_list, decl_list, get_types, seen_headers, options)
  File "/usr/pkg/share/gtk-doc/python/gtkdoc/scan.py", line 350, in ScanHeaders
    ScanHeader(fullname, section_list, decl_list, get_types,
  File "/usr/pkg/share/gtk-doc/python/gtkdoc/scan.py", line 404, in ScanHeader
    input_lines = hdr.readlines()
  File "/usr/pkg/lib/python3.10/codecs.py", line 322, in decode
    (result, consumed) = self._buffer_decode(data, self.errors, final)
UnicodeDecodeError: 'utf-8' codec can't decode byte 0x80 in position 768: invalid start byte


Cheers,

Patrick