Arch Linux

Please read this before reporting a bug:
https://wiki.archlinux.org/title/Bug_reporting_guidelines

Do NOT report bugs when a package is just outdated, or it is in the AUR. Use the 'flag out of date' link on the package page, or the Mailing List.

REPEAT: Do NOT report bugs for outdated packages!
Tasklist

FS#79095 - [glib2-docs] still using gtk-doc instead of gi-docgen

Attached to Project: Arch Linux
Opened by Hugo Parente Lima (hugo.pl) - Thursday, 13 July 2023, 19:14 GMT
Last edited by Toolybird (Toolybird) - Friday, 14 July 2023, 23:38 GMT
Task Type Bug Report
Category Packages: Core
Status Closed
Assigned To No-one
Architecture All
Severity Low
Priority Normal
Reported Version
Due in Version Undecided
Due Date Undecided
Percent Complete 100%
Votes 0
Private No

Details

Description:

GTK moved to use gi-docgen for all documentation, including glib as can be seen on https://docs.gtk.org/glib/index.html,
however ArchLinux package still generating documentation using the old gtk-doc.

The package gtk4-docs is using gi-docgen as well.


Additional info:
* core/glib2-docs 2.76.4-1

Steps to reproduce:
Just install the package and see that the documentation was generated with gtk-doc and installed on:

/usr/share/gtk-doc/html/glib
/usr/share/gtk-doc/html/gobject
/usr/share/gtk-doc/html/gio

instead of:

/usr/doc/glib2
/usr/doc/gobject
/usr/doc/gio
This task depends upon

Closed by  Toolybird (Toolybird)
Friday, 14 July 2023, 23:38 GMT
Reason for closing:  Not a bug
Additional comments about closing:  See comments
Comment by Toolybird (Toolybird) - Thursday, 13 July 2023, 22:34 GMT
> however ArchLinux package still generating documentation using the old gtk-doc

And so is Fedora, Debian, etc, etc. Have you tested building with gi-docgen?
Comment by Hugo Parente Lima (hugo.pl) - Friday, 14 July 2023, 23:33 GMT
The answer is here: https://discourse.gnome.org/t/how-to-compile-glib-gio-documentation-with-the-new-style/10085

TL;DR;

> GLib does not use gi-docgen, and it does not ship the introspection data needed to run gi-docgen.

So this bug must be closed since and the documentation I'm looking would need to be provided by other package anyway.

Loading...