Generate Pango API docs with gi-docgen

Stop using gtk-doc, and switch to gi-docgen.

The gi-docgen tool generates API references through the introspection
data, which has various benefits:

 - it does not parse C code
 - it does not generate and run C code to introspect types at build time
 - it does not present a different API from the one we're exporting

Additionally, gi-docgen:

 - does not generate DocBook XML in order to generate HTML
 - does not go through xsltproc
 - parses proper Markdown

Which makes it markedly faster than gtk-doc has ever been.

1 files changed, 64 insertions, 0 deletions

diff --git a/docs/pango.toml.in b/docs/pango.toml.in
new file mode 100644
index 00000000..986bfc8b
--- /dev/null
+++ b/docs/pango.toml.in
@@ -0,0 +1,64 @@
+[library]
+namespace = "Pango"
+version = "@PANGO_VERSION@"
+browse_url = "https://gitlab.gnome.org/GNOME/pango/"
+repository_url = "https://gitlab.gnome.org/GNOME/pango.git"
+website_url = "https://www.pango.org"
+authors = "Owen Taylor, Behdad Esfahbod"
+logo_url = "pango-name.png"
+license = "GPL-2.1-or-later"
+description = "Internationalized text layout and rendering"
+dependencies = [ "GObject-2.0", "HarfBuzz-0.0", "PangoCairo-1.0",
+                 "PangoFc-1.0", "PangoFT2-1.0", "PangoOT-1.0",
+                 "PangoXft-1.0" ]
+
+  [dependencies."GObject-2.0"]
+  name = "GObject"
+  description = "The base type system library"
+  docs_url = "https://developer.gnome.org/gobject/stable"
+
+  [dependencies."HarfBuzz-0.0"]
+  name = "HarfBuzz"
+  description = "A text shaping library"
+  docs_url = "https://harfbuzz.github.io/"
+
+  [dependencies."PangoCairo-1.0"]
+  name = "PangoCairo"
+  description = "Cairo support for Pango"
+  docs_url = "https://developer.gnome.org/pango/stable" # fixme
+
+  [dependencies."PangoFc-1.0"]
+  name = "PangoFc"
+  description = "Fontconfig support for Pango"
+  docs_url = "https://developer.gnome.org/pango/stable" # fixme
+
+  [dependencies."PangoFT2-1.0"]
+  name = "PangoFT2"
+  description = "Freetype support for Pango"
+  docs_url = "https://developer.gnome.org/pango/stable" # fixme
+
+  [dependencies."PangoOT-1.0"]
+  name = "PangoOT"
+  description = "OpenType support for Pango"
+  docs_url = "https://developer.gnome.org/pango/stable" # fixme
+
+  [dependencies."PangoXft-1.0"]
+  name = "PangoXft"
+  description = "Xft support for Pango"
+  docs_url = "https://developer.gnome.org/pango/stable" # fixme
+
+[theme]
+name = "basic"
+
+[source-location]
+base_url = "https://gitlab.gnome.org/GNOME/pango/-/blob/master/"
+
+[extra]
+
+content_images = [
+  "pango-name.png",
+  "layout.png",
+  "pipeline.png",
+  "rects1.png",
+  "rects2.png"
+]