Linking to a section in a DocBook file is broken

Submitted by Volker Sobek @vsobek

Link to original bug (#728283)

Description

While looking at the remaining non-markdown links in the glib docs (the .h files still have some) I stumbled across this: All links of the form

<link linkend="extending-gio">Extending GIO</link>

seem to be broken for many versions (at least in every version available at https://developer.gnome.org/gio/).

In the current 2.40.x version it became obvious since in the .h files these links are not converted to markdown links yet (so they show up literally with '<link...' while in previous versions the link was just ignored during the doc generation since it didn't exist.

The errors when generating the docs look like: html/GVfs.html:350: warning: no link for: 'extending-gio' -> (Extending GIO).