gtk/docs/reference/meson.build

if get_option('gtk_doc')
  glib_prefix = dependency('glib-2.0').get_variable(pkgconfig: 'prefix', default_value: '/usr')
  glib_docpath = join_paths(glib_prefix, 'share', 'gtk-doc', 'html')

  cairo_prefix = dependency('cairo-gobject').get_variable(pkgconfig: 'prefix', default_value: '/usr')
  cairo_docpath = join_paths(cairo_prefix, 'share', 'gtk-doc', 'html', 'cairo')

  gdkpixbuf_prefix = dependency('gdk-pixbuf-2.0').get_variable(pkgconfig: 'prefix', default_value: '/usr')
  gdkpixbuf_docpath = join_paths(gdkpixbuf_prefix, 'share', 'gtk-doc', 'html', 'gdk-pixbuf')

  docpath = join_paths(gtk_datadir, 'gtk-doc', 'html')

  version_conf = configuration_data()
  version_conf.set('GTK_VERSION', meson.project_version())

  src_dir_conf = configuration_data()
  src_dir_conf.set('SRC_DIR', meson.source_root())
endif

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

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

subdir('gdk')
subdir('gsk')
subdir('gtk')
meson: Rename documentation option to gtk_doc This name is what most of the stack is using. Lets follow along, even though it is (imo) uglier. 2019-07-01 16:57:16 +00:00			`if get_option('gtk_doc')`
build: Try to fix docs+subprojects Apparently, subprojects don't have pkgconfig variables :( 2020-09-30 20:21:39 +00:00			`glib_prefix = dependency('glib-2.0').get_variable(pkgconfig: 'prefix', default_value: '/usr')`
meson: allow building man pages without the documentation The 'documentation' option also guarded the man page build. Instead if skipping the whole docs subdir skip the specific gtkdoc calls, so that the man page build still works. This brings it in line with the gtk3 meson build. 2019-05-25 16:27:32 +00:00			`glib_docpath = join_paths(glib_prefix, 'share', 'gtk-doc', 'html')`
build: Generate the API references (WIP) Still a work in progress. 2017-04-19 10:35:45 +00:00
build: Try to fix docs+subprojects Apparently, subprojects don't have pkgconfig variables :( 2020-09-30 20:21:39 +00:00			`cairo_prefix = dependency('cairo-gobject').get_variable(pkgconfig: 'prefix', default_value: '/usr')`
meson: allow building man pages without the documentation The 'documentation' option also guarded the man page build. Instead if skipping the whole docs subdir skip the specific gtkdoc calls, so that the man page build still works. This brings it in line with the gtk3 meson build. 2019-05-25 16:27:32 +00:00			`cairo_docpath = join_paths(cairo_prefix, 'share', 'gtk-doc', 'html', 'cairo')`
build: Generate the API references (WIP) Still a work in progress. 2017-04-19 10:35:45 +00:00
build: Try to fix docs+subprojects Apparently, subprojects don't have pkgconfig variables :( 2020-09-30 20:21:39 +00:00			`gdkpixbuf_prefix = dependency('gdk-pixbuf-2.0').get_variable(pkgconfig: 'prefix', default_value: '/usr')`
meson: allow building man pages without the documentation The 'documentation' option also guarded the man page build. Instead if skipping the whole docs subdir skip the specific gtkdoc calls, so that the man page build still works. This brings it in line with the gtk3 meson build. 2019-05-25 16:27:32 +00:00			`gdkpixbuf_docpath = join_paths(gdkpixbuf_prefix, 'share', 'gtk-doc', 'html', 'gdk-pixbuf')`
build: Generate the API references (WIP) Still a work in progress. 2017-04-19 10:35:45 +00:00
meson: allow building man pages without the documentation The 'documentation' option also guarded the man page build. Instead if skipping the whole docs subdir skip the specific gtkdoc calls, so that the man page build still works. This brings it in line with the gtk3 meson build. 2019-05-25 16:27:32 +00:00			`docpath = join_paths(gtk_datadir, 'gtk-doc', 'html')`
build: Generate the API references (WIP) Still a work in progress. 2017-04-19 10:35:45 +00:00
meson: allow building man pages without the documentation The 'documentation' option also guarded the man page build. Instead if skipping the whole docs subdir skip the specific gtkdoc calls, so that the man page build still works. This brings it in line with the gtk3 meson build. 2019-05-25 16:27:32 +00:00			`version_conf = configuration_data()`
			`version_conf.set('GTK_VERSION', meson.project_version())`
build: Generate the API references (WIP) Still a work in progress. 2017-04-19 10:35:45 +00:00
meson: allow building man pages without the documentation The 'documentation' option also guarded the man page build. Instead if skipping the whole docs subdir skip the specific gtkdoc calls, so that the man page build still works. This brings it in line with the gtk3 meson build. 2019-05-25 16:27:32 +00:00			`src_dir_conf = configuration_data()`
			`src_dir_conf.set('SRC_DIR', meson.source_root())`
			`endif`
docs: Fix inclusion of source files in tutorial 2018-09-17 08:07:43 +00:00
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'))`

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')`