gplugin/gplugin

Fix cross-referencing in gplugin docs

2021-10-06, Elliott Sales de Andrade
ef60f88bb66d
Fix cross-referencing in gplugin docs

gi-docgen already puts types on most documented things. Thus most of this is replacing the linking with normal text.

But otherwise things are linked into GLib, internally, etc.


* Improve documentation of manager
For parameters, dropped the types because gi-docgen shows them automatically. It also shows transfer full, etc., so don't write extra notes about referencing and freeing.
The types are not correctly shown on signals, which _are_ kept in docs.
Also, break up some paragraphs so that the details are not shown in the summaries on the overview page for the Manager.
* Clean up loader docs
Most of the links are not needed, so this just makes them normal text.
* Fix doc cross-references in plugin info
Like before, most of this is actually _removing_ extra cross-references, but there are still one or two left.
* Clean up cross references in plugin interface
* Fix cross-referencing in top-level functions

Testing Done:
Compiled and looked at docs in the browser.

Reviewed at https://reviews.imfreedom.org/r/999/
if get_option('gtk3')
if not get_option('install-gplugin-gtk3-viewer')
summary('gplugin-gtk3-viewer',
'You have disabled installation of gplugin-gtk-viewer which is a ' +
'very useful diagnostics tool.',
section : 'Warnings')
endif
gplugin_gtk3_viewer_resources = gnome.compile_resources(
'gplugin-gtk-viewer-resources',
'data/gplugin-gtk-viewer.gresource.xml',
c_name: 'gplugin_gtk_viewer',
source_dir: 'data')
gplugin_gtk3_viewer = executable('gplugin-gtk3-viewer',
'gplugin-gtk-viewer.c',
'gplugin-gtk-viewer-window.c',
'gplugin-gtk-viewer-window.h',
dependencies : [gplugin_dep, gplugin_gtk3_dep],
install : get_option('install-gplugin-gtk3-viewer')
)
if get_option('help2man')
gplugin_gtk_viewer_man = custom_target('gplugin-gtk3-viewer.1',
command : [help2man,
'--name=View installed plugins', '--section=1',
'--help-option=--help-all', '--no-info',
'--output', '@OUTPUT@',
gplugin_gtk3_viewer],
output : 'gplugin-gtk3-viewer.1',
install : get_option('install-gplugin-gtk3-viewer'),
install_dir : get_option('mandir') / 'man1')
endif
endif