GitLab

mkdb: Make transfer annotation tooltips less ambiguous

See merge request !44

Ignore deprecation warnings when scanning types

See merge request !62

meson: use lib/cmake instead of share/cmake

See merge request !60

autotools support: add the *.actions file to SCANOBJ_FILES

See merge request !61

We annotate deprecated types, which means we get compiler warnings when
scanning them. This, coupled to -Werror or similar mechanisms, breaks
the build when generating the documentation.

It fixes `make distcheck` in projects like gspell which still use the
Autotools.

The `make distcheck` error was:
ERROR: files left in build directory after distclean:
./docs/reference/gspell-1.0.actions

This commit in gtk-doc permits to remove the following workaround in
gspell:
gspell@f22493b8

share/cmake has a particular structure (Help, Modules, Templates), while
lib/cmake is for custom macros.

Use lib/cmake like the autotools install did.

automake complains about such things.

help: Fix link to wiki.gnome.org

See merge request !57

tests: Pass address-sanitizer options when building GObject scanner

See merge request !54

Gtk doc for gtk4

See merge request !59

Use char, int, float, double, instead of their
g-prefixed counterparts. This follows the GTK4
api style changes.

gtk-doc uses informaltable elements for formatting
the function listings in reference pages, while
pandoc-generated docbook uses informaltable elements
for regular tables. Thankfully, they end up with
different border attributes in the html, so we can
use that to style them differently.

GTK 4 added its own variant of G_DECLARE_
under the name of GDK_DECLARE_INTERNAL_TYPE.
Recognize it.

The "Abstract" looks irritating in the otherwise
very minimal output we produce. Just leave it out.

Add tests for signal, property and action syntax
as symbols in doc comments. And make the remaining
tests robust enough to survive the addition.

This is building on the work in the previous commit. The syntax chosen
for doc comments is Class|action. We also need to allow periods in symbols,
since those are commonly used to separate prefixes in action names.

Here is a typical doc comment for an action:

  /**
   * GtkColorChooserWidget|color.select:
   * @red: the red value, between 0 and 1
   * @green: the green value, between 0 and 1
   * @blue: the blue value, between 0 and 1
   * @alpha: the alpha value, between 0 and 1
   *
   * Emits the #GtkColorChooser::color-activated signal for
   * the given color.
   */

GTK4 can define actions for widget classes.
Write these out to a .actions file.

scangobj: Don't sort an absence of signals/properties

Closes #125

See merge request !53

mkhtml2: Fix apparent typo "os.getcmd()"

See merge request !50

A link has been changed on wiki.gnome.org (the + has been dropped from GTK)
and needed to be updated here.

build: Distribute more files from git in official release tarballs

Closes #109

See merge request !55

This allows the Autotools dist tarball to continue to be used as the
official release artifact, while still allowing distributors to try
Meson builds.

To help to debug this if it fails, the meson-build step records a
list of all files in git (ideally we'd use 'meson dist' but the
container image doesn't currently include git, so this is the next
best thing), while the meson-from-tarball step records a list of all
files in the tarball. They are in a normalized order that can be diff'ed.

Tests: #109

Signed-off-by: Simon McVittie <smcv@debian.org>

Signed-off-by: Simon McVittie <smcv@debian.org>

Many of these are necessary for the Meson build, and some merely seem
potentially useful.

Resolves: #109

Signed-off-by: Simon McVittie <smcv@debian.org>

Run tests under Meson again

See merge request !52

Install the same files with Meson as with Autotools

See merge request !48

This allows a Meson build with -Db_sanitize=address,undefined to
succeed (when combined with !52 to make the tests pass).

Reproduces: #125

Signed-off-by: Simon McVittie <smcv@debian.org>

qsort (NULL, 0, ...) is formally considered to be undefined behaviour,
and is diagnosed as such by the undefined behaviour sanitizer.

Resolves: #125

Signed-off-by: Simon McVittie <smcv@debian.org>

This reverts commit 1f0a7303.

Two tests rely on symbols in <SUBSECTION Private> and
<SUBSECTION Standard> being ignored. The Autotools build automatically
copies -sections.txt into the build directory where gtk-doc will find
it, but the Meson build does not, resulting in gtk-doc generating a
new -sections.txt that does not know which symbols to ignore, and
complaining that the private symbols are now undocumented.
Signed-off-by: Simon McVittie <smcv@debian.org>

Otherwise tests will fail when we can't load external entities from it.
Signed-off-by: Simon McVittie <smcv@debian.org>

os.getcwd() would make sense here.

This call isn't actually reached in practice, because the
gtkdoc-mkhtml2 script entry point always passes something for
options.output_dir, even if it's ".".
Signed-off-by: Simon McVittie <smcv@debian.org>