HGKeeper

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/

* This library is free software; you can redistribute it and/or

* modify it under the terms of the GNU Lesser General Public

* License as published by the Free Software Foundation; either

* version 2 of the License, or (at your option) any later version.

* This library is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

* Lesser General Public License for more details.

* You should have received a copy of the GNU Lesser General Public

* License along with this library; if not, see <https://www.gnu.org/licenses/>.

#include <gplugin/gplugin-private.h>

/* A GSignalAccumulator that stops emission if a handler returns FALSE */

gboolean

gplugin_boolean_accumulator(

G_GNUC_UNUSED GSignalInvocationHint *hint,

GValue *return_accu,

const GValue *handler_return,

G_GNUC_UNUSED gpointer data)

{

gboolean continue_emission;

gboolean handler_returned;

handler_returned = g_value_get_boolean(handler_return);

g_value_set_boolean(return_accu, handler_returned);

continue_emission = handler_returned;

return continue_emission;

}