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/
option(
'doc',
type : 'boolean', value : true, yield : true,
description : 'build documentation with gtk-doc'
)
option(
'introspection',
type : 'boolean', value : true, yield : true,
description : 'Whether or not to build a GObject Introspection type library'
)
option(
'devenv-config-dir',
type : 'string',
description : 'config directory for running a devenv (defaults to a subdirectory of buildroot)'
)
option(
'gtk3',
type : 'boolean', value : true,
description : 'Whether or not to build the GTK3 library'
)
option(
'gtk4',
type : 'boolean', value : true,
description : 'Whether or not to build the GTK4 library'
)
option(
'help2man',
type : 'boolean', value : true,
description : 'Whether or not to build man pages from --help output'
)
option(
'install-gplugin-gtk3-viewer',
type : 'boolean', value : true,
description : 'Whether or not to install the gtk3 viewer application'
)
option(
'install-gplugin-query',
type : 'boolean', value : true,
description : 'Whether or not to install the query application'
)
option(
'lua',
type : 'boolean', value : true,
description : 'Whether or not to build the Lua plugin loader'
)
option(
'nls',
type : 'boolean', value : true,
description : 'Install translation files'
)
option(
'perl5',
type : 'boolean', value : true,
description : 'Whether or not to build the Perl plugin loader'
)
option(
'python3',
type : 'boolean', value : true,
description : 'Whether or not to build the Python 3.x plugin loader'
)
option(
'rs',
type : 'boolean', value : false,
description : 'Whether or not to create the rust bindings.'
)
option(
'tcc',
type : 'boolean', value : false,
description : 'Whether or not to build the TCC plugin loader'
)
option(
'vapi',
type : 'boolean', value : true,
description : 'Whether or not to build vapi files for gplugin'
)