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/
There are a few notes about building on OSX.
First off, building has *ONLY* been tested against homebrew. If you want to
support fink or macports, please let me know and I will merge your pull
request.
Currently there is no known way to build the Perl loader on MacOS. So you
**MUST** run meson with `-Dperl5=false`.
## Lua
For the Lua loader to work, you need to install `lgi` from luarocks either
systemwide for lua 5.1 as `lgi` does not currently work with lua 5.4 which is
the default in homebrew.
To make this work, you'll need to install both `lua@5.1` and `luarocks` via
`brew install lua@5.1 luarocks`. Once those are installed, you'll need to
create `/usr/local/etc/luarocks/config-5.1.lua` with the following contents.
```
-- LuaRocks configuration
rocks_trees = {
{ name = "user", root = home .. "/.luarocks" };
{ name = "system", root = "/usr/local" };
}
lua_interpreter = "lua5.1";
variables = {
LUA_DIR = "/usr/local/opt/lua@5.1";
LUA_BINDIR = "/usr/local/opt/lua@5.1/bin";
}
```
Once that is done, you can then finally install `lgi` with the following
command.
```
luarocks --lua-version=5.1 install lgi
```
## Python3
If you're using homebrew, you need to install `pygobject3`.