build: Add a Meta Toolkit private library

Currently, Meta/Cogl/Clutter makes use of cairo_rectangle_int_t despite
the existance of MetaRectangle.

In order to make MetaRectangle usable in Cogl/Clutter as well, Mtk would
provide such base types that are shared across the various private
libraries

Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3128>

doc/reference/cally/meson.build

@@ -14,6 +14,7 @@ custom_target('cally-doc',
     gidocgen,
     'generate',
     gidocgen_common_args,
+    '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../mtk/mtk'),
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../cogl/cogl'),
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../cogl/cogl-pango'),
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../clutter/clutter'),
@@ -23,6 +24,7 @@ custom_target('cally-doc',
     '@INPUT1@',
   ],
   depends: [
+    libmutter_mtk_gir[0],
     libmutter_cogl_gir[0],
     libmutter_cogl_pango_gir[0],
     libmutter_clutter_gir[0],

doc/reference/clutter/meson.build

@@ -14,6 +14,7 @@ custom_target('clutter-doc',
     gidocgen,
     'generate',
     gidocgen_common_args,
+    '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../mtk/mtk'),
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../cogl/cogl'),
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../cogl/cogl-pango'),
     '--config=@INPUT0@',
@@ -22,6 +23,7 @@ custom_target('clutter-doc',
     '@INPUT1@',
   ],
   depends: [
+    libmutter_mtk_gir[0],
     libmutter_cogl_pango_gir[0],
     libmutter_cogl_gir[0],
   ],

doc/reference/meson.build

@@ -25,3 +25,4 @@ subdir('clutter')
 subdir('cogl')
 subdir('cogl-pango')
 subdir('meta')
+subdir('mtk')

doc/reference/meta/meson.build

@@ -14,6 +14,7 @@ custom_target('meta-doc',
     gidocgen,
     'generate',
     gidocgen_common_args,
+    '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../mtk/mtk'),
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../clutter/clutter'),
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../cogl/cogl'),
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../cogl/cogl-pango'),
@@ -23,6 +24,7 @@ custom_target('meta-doc',
     '@INPUT1@',
   ],
   depends: [
+    libmutter_mtk_gir[0],
     libmutter_clutter_gir[0],
     libmutter_cally_gir[0],
     libmutter_cogl_pango_gir[0],

doc/reference/mtk/meson.build

@@ -0,0 +1,24 @@
+mtk_toml = configure_file(
+  input: 'mtk.toml.in',
+  output: 'mtk.toml',
+  configuration: toml_conf,
+  install: true,
+  install_dir: docs_dir / 'mtk',
+)
+
+custom_target('mtk-doc',
+  input: [ mtk_toml, libmutter_mtk_gir[0] ],
+  output: 'mtk',
+  command: [
+    gidocgen,
+    'generate',
+    gidocgen_common_args,
+    '--config=@INPUT0@',
+    '--output-dir=@OUTPUT@',
+    '--content-dir=@0@'.format(meson.current_source_dir()),
+    '@INPUT1@',
+  ],
+  build_by_default: true,
+  install: true,
+  install_dir: docs_dir,
+)

doc/reference/mtk/mtk.toml.in

@@ -0,0 +1,34 @@
+[library]
+version = "@version@"
+browse_url = "https://gitlab.gnome.org/GNOME/mutter/"
+repository_url = "https://gitlab.gnome.org/GNOME/mutter.git"
+website_url = "https://blogs.gnome.org/shell-dev/"
+docs_url = "https://docs.gtk.org/"
+authors = "Mutter Development Team"
+license = "GPL-2.0-or-later"
+description = "Mutter Toolkit Private Library"
+dependencies = [ "GObject-2.0" ]
+devhelp = true
+search_index = true
+
+  [dependencies."GObject-2.0"]
+  name = "GObject"
+  description = "The base type system library"
+  docs_url = "https://docs.gtk.org/gobject/"
+
+[theme]
+name = "basic"
+show_index_summary = true
+show_class_hierarchy = true
+
+[source-location]
+base_url = "https://gitlab.gnome.org/GNOME/mutter/-/blob/@vcs_tag@/"
+
+[extra]
+# The same order will be used when generating the index
+content_files = [
+]
+content_images = [
+]
+urlmap_file = "urlmap.js"
+

doc/reference/mtk/urlmap.js

@@ -0,0 +1,7 @@
+// SPDX-FileCopyrightText: 2021 GNOME Foundation
+// SPDX-License-Identifier: LGPL-2.1-or-later
+
+// A map between namespaces and base URLs for their online documentation
+baseURLs = [
+    [ 'GObject', 'https://docs.gtk.org/gobject/' ],
+]