summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPatrick Griffis <pgriffis@igalia.com>2022-04-14 12:35:23 -0500
committerPatrick Griffis <pgriffis@igalia.com>2022-04-14 12:47:23 -0500
commit1b51db848bdb17794c4e8184f5a2b582d37ea988 (patch)
tree883f073dcecca496c406690aff023bcd536b4f91
parent64dffe06ca87b8aed5cbeae10ff4091e3a7ad961 (diff)
downloadlibsoup-1b51db848bdb17794c4e8184f5a2b582d37ea988.tar.gz
build: Change docs to a feature set to auto
-rw-r--r--docs/reference/meson.build61
-rw-r--r--meson.build8
-rw-r--r--meson_options.txt6
3 files changed, 38 insertions, 37 deletions
diff --git a/docs/reference/meson.build b/docs/reference/meson.build
index e36c2fd3..d868201c 100644
--- a/docs/reference/meson.build
+++ b/docs/reference/meson.build
@@ -10,37 +10,40 @@ expand_content_md_files = [
toml_data = configuration_data()
toml_data.set('VERSION', meson.project_version())
-libsoup_toml = configure_file(
- input: 'libsoup.toml.in',
- output: 'libsoup.toml',
- configuration: toml_data
+gidocgen_dep = dependency('gi-docgen', version: '>= 2021.1',
+ fallback: ['gi-docgen', 'dummy_dep'],
+ native: true,
+ required: get_option('docs')
)
-dependency('gi-docgen', version: '>= 2021.1',
- fallback: ['gi-docgen', 'dummy_dep'],
- native: true,
- required: get_option('gtk_doc'))
+if gidocgen_dep.found()
+ libsoup_toml = configure_file(
+ input: 'libsoup.toml.in',
+ output: 'libsoup.toml',
+ configuration: toml_data
+ )
-gidocgen = find_program('gi-docgen')
+ gidocgen = find_program('gi-docgen')
-docs_dir = get_option('datadir') / 'doc'
+ docs_dir = get_option('datadir') / 'doc'
-custom_target('libsoup-doc',
- input: [ libsoup_toml, soup_gir_gen_sources[0] ],
- output: 'libsoup-@0@'.format(apiversion),
- command: [
- gidocgen,
- 'generate',
- '--quiet',
- '--add-include-path=@0@'.format(meson.current_build_dir() / '../../libsoup'),
- '--config=@INPUT0@',
- '--output-dir=@OUTPUT@',
- '--no-namespace-dir',
- '--content-dir=@0@'.format(meson.current_source_dir()),
- '@INPUT1@',
- ],
- depend_files: [ expand_content_md_files ],
- build_by_default: true,
- install: true,
- install_dir: docs_dir,
-)
+ custom_target('libsoup-doc',
+ input: [ libsoup_toml, soup_gir_gen_sources[0] ],
+ output: 'libsoup-@0@'.format(apiversion),
+ command: [
+ gidocgen,
+ 'generate',
+ '--quiet',
+ '--add-include-path=@0@'.format(meson.current_build_dir() / '../../libsoup'),
+ '--config=@INPUT0@',
+ '--output-dir=@OUTPUT@',
+ '--no-namespace-dir',
+ '--content-dir=@0@'.format(meson.current_source_dir()),
+ '@INPUT1@',
+ ],
+ depend_files: [ expand_content_md_files ],
+ build_by_default: true,
+ install: true,
+ install_dir: docs_dir,
+ )
+endif \ No newline at end of file
diff --git a/meson.build b/meson.build
index b2f6798a..6ac3ebad 100644
--- a/meson.build
+++ b/meson.build
@@ -404,10 +404,8 @@ if get_option('tests')
subdir('tests')
endif
-if get_option('gtk_doc')
- srcdir = include_directories('libsoup')
- subdir('docs/reference')
-endif
+srcdir = include_directories('libsoup')
+subdir('docs/reference')
summary({
'prefix' : get_option('prefix'),
@@ -424,7 +422,7 @@ summary({
'Translations' : xgettext.found(),
'GIR' : enable_introspection,
'VAPI' : enable_vapi,
- 'Documentation' : get_option('gtk_doc'),
+ 'Documentation' : gidocgen_dep.found(),
},
section : 'Features'
)
diff --git a/meson_options.txt b/meson_options.txt
index 906e5597..85c09058 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -47,9 +47,9 @@ option('vapi',
description : 'Build Vala bindings'
)
-option('gtk_doc',
- type: 'boolean',
- value: false,
+option('docs',
+ type: 'feature',
+ value: 'auto',
description: 'Enable generating the API reference'
)