From 6c3b7a487b82090b125614ea983e47d4d8c10537 Mon Sep 17 00:00:00 2001
From: Emmanuele Bassi <ebassi@gnome.org>
Date: Tue, 27 Apr 2021 12:08:52 +0100
Subject: meson: Build the API reference

The Meson build system should build the API reference using gtk-doc,
like the Autotools build does.

The option is called `gtk_doc`, which matches the existing practices in
various projects using Meson and gtk-doc.
---
 doc/public/meson.build    | 157 ++++++++++++++++++++++++++++++++++++++++++++++
 doc/public/version.xml.in |   1 +
 2 files changed, 158 insertions(+)
 create mode 100644 doc/public/meson.build
 create mode 100644 doc/public/version.xml.in

(limited to 'doc')

diff --git a/doc/public/meson.build b/doc/public/meson.build
new file mode 100644
index 000000000..2c27105b4
--- /dev/null
+++ b/doc/public/meson.build
@@ -0,0 +1,157 @@
+gnome = import('gnome')
+
+ignore_headers = [
+  # Sub-directories
+  'drm',
+  'win32',
+
+  # Internal headers
+  'cairoint.h',
+  'cairo-features.h',
+  'cairo-features-win32.h',
+
+  # Inlined API
+  'cairo-box-inline.h',
+  'cairo-clip-inline.h',
+  'cairo-combsort-inline.h',
+  'cairo-contour-inline.h',
+  'cairo-error-inline.h',
+  'cairo-image-surface-inline.h',
+  'cairo-line-inline.h',
+  'cairo-list-inline.h',
+  'cairo-pattern-inline.h',
+  'cairo-recording-surface-inline.h',
+  'cairo-surface-inline.h',
+  'cairo-surface-observer-inline.h',
+  'cairo-surface-snapshot-inline.h',
+  'cairo-surface-subsurface-inline.h',
+
+  # Private headers
+  'cairo-analysis-surface-private.h',
+  'cairo-arc-private.h',
+  'cairo-array-private.h',
+  'cairo-atomic-private.h',
+  'cairo-backend-private.h',
+  'cairo-boxes-private.h',
+  'cairo-cache-private.h',
+  'cairo-clip-private.h',
+  'cairo-compiler-private.h',
+  'cairo-composite-rectangles-private.h',
+  'cairo-compositor-private.h',
+  'cairo-contour-private.h',
+  'cairo-damage-private.h',
+  'cairo-default-context-private.h',
+  'cairo-deprecated.h',
+  'cairo-device-private.h',
+  'cairo-error-private.h',
+  'cairo-fixed-private.h',
+  'cairo-fixed-type-private.h',
+  'cairo-fontconfig-private.h',
+  'cairo-freed-pool-private.h',
+  'cairo-freelist-private.h',
+  'cairo-freelist-type-private.h',
+  'cairo-ft-private.h',
+  'cairo-gstate-private.h',
+  'cairo-hash-private.h',
+  'cairo-image-info-private.h',
+  'cairo-image-surface-private.h',
+  'cairo-line-private.h',
+  'cairo-list-private.h',
+  'cairo-malloc-private.h',
+  'cairo-mempool-private.h',
+  'cairo-mutex-impl-private.h',
+  'cairo-mutex-list-private.h',
+  'cairo-mutex-private.h',
+  'cairo-mutex-type-private.h',
+  'cairo-output-stream-private.h',
+  'cairo-paginated-private.h',
+  'cairo-paginated-surface-private.h',
+  'cairo-path-fixed-private.h',
+  'cairo-path-private.h',
+  'cairo-pattern-private.h',
+  'cairo-pdf-operators-private.h',
+  'cairo-pdf-shading-private.h',
+  'cairo-pdf-surface-private.h',
+  'cairo-pixman-private.h',
+  'cairo-private.h',
+  'cairo-ps-surface-private.h',
+  'cairo-quartz-private.h',
+  'cairo-recording-surface-private.h',
+  'cairo-reference-count-private.h',
+  'cairo-region-private.h',
+  'cairo-rtree-private.h',
+  'cairo-scaled-font-private.h',
+  'cairo-scaled-font-subsets-private.h',
+  'cairo-script-private.h',
+  'cairo-slope-private.h',
+  'cairo-spans-compositor-private.h',
+  'cairo-spans-private.h',
+  'cairo-stroke-dash-private.h',
+  'cairo-surface-backend-private.h',
+  'cairo-surface-clipper-private.h',
+  'cairo-surface-fallback-private.h',
+  'cairo-surface-observer-private.h',
+  'cairo-surface-offset-private.h',
+  'cairo-surface-private.h',
+  'cairo-surface-snapshot-private.h',
+  'cairo-surface-subsurface-private.h',
+  'cairo-surface-wrapper-private.h',
+  'cairo-svg-surface-private.h',
+  'cairo-tag-attributes-private.h',
+  'cairo-tag-stack-private.h',
+  'cairo-tee-surface-private.h',
+  'cairo-time-private.h',
+  'cairo-traps-private.h',
+  'cairo-tristrip-private.h',
+  'cairo-truetype-subset-private.h',
+  'cairo-type1-private.h',
+  'cairo-type3-glyph-surface-private.h',
+  'cairo-types-private.h',
+  'cairo-user-font-private.h',
+  'cairo-wideint-private.h',
+  'cairo-wideint-type-private.h',
+  'cairo-xcb-private.h',
+  'cairo-xlib-private.h',
+  'cairo-xlib-surface-private.h',
+  'cairo-xlib-xrender-private.h',
+  'test-compositor-surface-private.h',
+]
+
+ignore_decorators = [
+  'cairo_public',
+  'cairo_private',
+]
+
+docpath = get_option('prefix') / get_option('datadir') / 'gtk-doc/html'
+version_conf = configuration_data()
+version_conf.set('CAIRO_VERSION', meson.project_version())
+configure_file(
+  input: 'version.xml.in',
+  output: 'version.xml',
+  configuration: version_conf
+)
+
+gnome.gtkdoc('cairo',
+  main_xml: 'cairo-docs.xml',
+  namespace: 'cairo',
+  mode: 'sgml',
+  src_dir: doc_srcdir,
+  dependencies: libcairo_dep,
+  scan_args: [
+    '--ignore-decorators=' + '|'.join(ignore_decorators),
+    '--ignore-headers=' + ' '.join(ignore_headers),
+  ],
+  content_files: [
+    'language-bindings.xml',
+  ],
+  expand_content_files: [
+    'language-bindings.xml',
+  ],
+  html_assets: [
+  ],
+  fixxref_args: [
+    '--html-dir=' + docpath,
+  ],
+  install: true,
+  check: true,
+)
diff --git a/doc/public/version.xml.in b/doc/public/version.xml.in
new file mode 100644
index 000000000..6bd185791
--- /dev/null
+++ b/doc/public/version.xml.in
@@ -0,0 +1 @@
+@CAIRO_VERSION@
-- 
cgit v1.2.1