From 9de2b14bc03c9f3352ae07b5eece266f6292c0cc Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Sat, 20 Mar 2021 22:58:59 +0000 Subject: docs: Generate the GdkPixdata API reference Different introspection file, different API reference. --- docs/gdk-pixdata.toml.in | 41 +++++++++++++++++++++++++++++++++++++++++ docs/meson.build | 24 ++++++++++++++++++++++-- docs/urlmap.js | 1 + 3 files changed, 64 insertions(+), 2 deletions(-) create mode 100644 docs/gdk-pixdata.toml.in (limited to 'docs') diff --git a/docs/gdk-pixdata.toml.in b/docs/gdk-pixdata.toml.in new file mode 100644 index 000000000..47f37cb25 --- /dev/null +++ b/docs/gdk-pixdata.toml.in @@ -0,0 +1,41 @@ +# SPDX-FileCopyrightText: 2021 GNOME Foundation +# +# SPDX-License-Identifier: CC0-1.0 + +[library] +name = "gdk-pixdata" +version = "@VERSION@" +browse_url = "https://gitlab.gnome.org/GNOME/gdk-pixbuf/" +repository_url = "https://gitlab.gnome.org/GNOME/gdk-pixbuf.git" +website_url = "https://www.gtk.org" +authors = "GTK Development Team" +license = "GPL-2.1-or-later" +description = "Inline image data" +dependencies = [ "gobject", "gio", "gdk-pixbuf" ] +devhelp = true +search_index = true + + [dependencies.gobject] + name = "GObject" + description = "The base type system library" + docs_url = "https://developer.gnome.org/gobject/stable" + + [dependencies.gio] + name = "GIO" + description = "GObject Interfaces and Objects" + docs_url = "https://developer.gnome.org/gio/stable" + + [dependencies."gdk-pixbuf"] + name = "GdkPixbuf" + description = "Image loading library" + docs_url = "../gdk-pixbuf/index.html" + +[theme] +name = "basic" +show_index_summary = true + +[source-location] +base_url = "https://gitlab.gnome.org/GNOME/gdk-pixbuf/-/blob/master/" + +[extra] +urlmap_file = "urlmap.js" diff --git a/docs/meson.build b/docs/meson.build index d4c5fe5ea..c9a16a49b 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -7,7 +7,8 @@ gidocgen_dep = dependency('gi-docgen', toml_conf = configuration_data() toml_conf.set('VERSION', meson.project_version()) -toml = configure_file(input: 'gdk-pixbuf.toml.in', output: 'gdk-pixbuf.toml', configuration: toml_conf) +pixbuf_toml = configure_file(input: 'gdk-pixbuf.toml.in', output: 'gdk-pixbuf.toml', configuration: toml_conf) +pixdata_toml = configure_file(input: 'gdk-pixdata.toml.in', output: 'gdk-pixdata.toml', configuration: toml_conf) gidocgen = find_program('gi-docgen', required: get_option('gtk_doc')) @@ -25,7 +26,7 @@ endif if build_docs custom_target('gdk-pixbuf-doc', - input: [ toml, gdkpixbuf_gir[0] ], + input: [ pixbuf_toml, gdkpixbuf_gir[0] ], output: 'gdk-pixbuf', command: [ gidocgen, @@ -43,6 +44,25 @@ if build_docs install: true, install_dir: docs_dir, ) + + custom_target('gdk-pixdata-doc', + input: [ pixdata_toml, gdkpixdata_gir[0] ], + output: 'gdk-pixdata', + command: [ + gidocgen, + 'generate', + '--quiet', + '--add-include-path=@0@'.format(meson.current_build_dir() / '../gdk-pixbuf'), + '--config=@INPUT0@', + '--output-dir=@OUTPUT@', + '--no-namespace-dir', + '--content-dir=@0@'.format(meson.current_source_dir()), + '@INPUT1@', + ], + build_by_default: true, + install: true, + install_dir: docs_dir, + ) endif xsltproc = find_program('xsltproc', required: false) diff --git a/docs/urlmap.js b/docs/urlmap.js index eaf2de988..caaee10f0 100644 --- a/docs/urlmap.js +++ b/docs/urlmap.js @@ -10,4 +10,5 @@ baseURLs = [ [ 'Gtk', 'https://gnome.pages.gitlab.gnome.org/gtk/gtk4/' ], [ 'Pango', 'https://gnome.pages/gitlab.gnome.org/pango/pango/' ], [ 'PangoCairo', 'https://gnome.pages.gitlab.gnome.org/pango/pangocairo/' ], + [ 'GdkPixbuf', 'https://gnome.pages.gitlab.gnome.org/gdk-pixbuf/' ], ] -- cgit v1.2.1