gtk2/docs/reference/meson.build

toml_conf = configuration_data()
toml_conf.set('version', meson.project_version())

gidocgen = find_program('gi-docgen', required: get_option('gtk_doc'))

docs_dir = gtk_datadir / 'doc'

if get_option('gtk_doc') and not build_gir
  error('API reference requires introspection.')
endif

subdir('gdk')
subdir('gsk')
subdir('gtk')
Generate GTK API reference(s) 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. 2021-02-10 13:41:53 +00:00			`toml_conf = configuration_data()`
			`toml_conf.set('version', meson.project_version())`

			`gidocgen = find_program('gi-docgen', required: get_option('gtk_doc'))`

Install documentation in the appropriate place We're already installing each reference into its own namespaced directory, so we don't need to add further path elements. Additionally, with the changes in: https://gitlab.gnome.org/GNOME/devhelp/-/merge_requests/20 https://gitlab.gnome.org/GNOME/gi-docgen/-/merge_requests/54 we can browse the GTK API references in DevHelp. 2021-04-07 13:57:31 +00:00			`docs_dir = gtk_datadir / 'doc'`
build: Install the API references We are building them, but not installing them. 2021-03-12 11:13:54 +00:00
build: Check that introspection is enabled for docs build 2021-08-29 00:47:34 +00:00			`if get_option('gtk_doc') and not build_gir`
			`error('API reference requires introspection.')`
			`endif`

build: Generate the API references (WIP) Still a work in progress. 2017-04-19 10:35:45 +00:00			`subdir('gdk')`
			`subdir('gsk')`
			`subdir('gtk')`