Commit 37fdd87c82da02325061129618cc088a8311a8e0
2023-06-27T20:31:01
Add a meson flag to make cool URIs optional The script `ensure-stable-doc-urls.py` relies on the Doxygen output files names. These may change between Doxygen versions, although the Doxygen developers intend stability. Since the script is useful mainly for the online documentation of xkbcommon, make the target `doc-cool-uris` optional.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58
diff --git a/meson.build b/meson.build
index 2cd1ee7..6a79093 100644
--- a/meson.build
+++ b/meson.build
@@ -833,20 +833,22 @@ You can disable the documentation with -Denable-docs=false.''')
install_dir: docdir,
build_by_default: true,
)
- ensure_stable_urls = find_program('scripts'/'ensure-stable-doc-urls.py')
- custom_target(
- 'doc-cool-uris',
- input: [doc_gen, 'doc'/'cool-uris.yaml'],
- output: 'html-xtra',
- command: [
- ensure_stable_urls,
- 'generate-redirections',
- meson.current_source_dir()/'doc'/'cool-uris.yaml',
- meson.current_build_dir()/'html'
- ],
- install: false,
- build_by_default: true,
- )
+ if get_option('enable-cool-uris')
+ ensure_stable_urls = find_program('scripts'/'ensure-stable-doc-urls.py')
+ custom_target(
+ 'doc-cool-uris',
+ input: [doc_gen, 'doc'/'cool-uris.yaml'],
+ output: 'html-xtra',
+ command: [
+ ensure_stable_urls,
+ 'generate-redirections',
+ meson.current_source_dir()/'doc'/'cool-uris.yaml',
+ meson.current_build_dir()/'html'
+ ],
+ install: false,
+ build_by_default: true,
+ )
+ endif
endif
configure_file(output: 'config.h', configuration: configh_data)
diff --git a/meson_options.txt b/meson_options.txt
index 69850b8..924d1f7 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -62,6 +62,12 @@ option(
description: 'Enable building the documentation',
)
option(
+ 'enable-cool-uris',
+ type: 'boolean',
+ value: false,
+ description: 'Enable creating redirections to maintain stable documentation pages',
+)
+option(
'enable-wayland',
type: 'boolean',
value: true,