6f14db9ea2
This will work around such errors from the g-ir-doc build:
> devel-docs/g-ir-docs/pages/python/Gimp-3.0/Gimp.checks_get_colors.page:46: parser error : EntityRef: expecting ';'
> gimp_checks_get_colors (gimp_check_type (), &color1, &color2);
> ^
Similar to commit 7123b6c466, it cannot really be considered a proper
fix, barely a workaround for g-ir-doc-tool not even able to produce
valid XML. Here we have ampersands which it should have espaced into XML
entities.
Anyway this will do for now (until we just decide to drop the g-ir-docs
tools?).
136 lines
5.5 KiB
Meson
136 lines
5.5 KiB
Meson
foreach lang : [ 'python', 'gjs' ]
|
|
|
|
# XXX meson does not allow building into subdir:
|
|
# https://github.com/mesonbuild/meson/issues/2320
|
|
# Otherwise I could use '-o', '@OUTDIR@' into following commands if
|
|
# the `output` was subdir-able.
|
|
gir_docs_dir = custom_target('g-ir-docs-' + lang + '-dir',
|
|
depends: [ libgimp_gir, libgimpui_gir ],
|
|
input: [ ],
|
|
output: [ 'gir-' + lang + '-dirs' ],
|
|
command: [
|
|
'mkdir', '-p',
|
|
'@OUTDIR@' + '/pages/' + lang + '/GimpUi-' + gimp_api_version,
|
|
'@OUTDIR@' + '/pages/' + lang + '/Gimp-' + gimp_api_version,
|
|
'@OUTDIR@' + '/html/' + lang + '/GimpUi-' + gimp_api_version,
|
|
'@OUTDIR@' + '/html/' + lang + '/Gimp-' + gimp_api_version
|
|
],
|
|
build_by_default: true)
|
|
|
|
## Gimp Module ##
|
|
|
|
# XXX `output` is bogus. g-ir-doc-tool produces a lot of output,
|
|
# basically one page per public symbol, which is more than 1000 so
|
|
# it's not usable. Since custom_target() requires an 'output', I could
|
|
# just set one output such as 'index.page` as a trick, but since we
|
|
# have another issue on subdir anyway (cf. above), I use some bogus
|
|
# file instead. The fact the bogus file is not even created does not
|
|
# even seem to be a problem for meson.
|
|
# Moreover I realized that the targets listed by ninja are only the
|
|
# output files (not the target name), so I basically ends up using
|
|
# this field to create understandable names).
|
|
gir_docs_pages = custom_target('g-ir-Gimp-' + lang + '-pages',
|
|
depends: [ gir_docs_dir, libgimp_gir ],
|
|
input: [ libgimp_gir[0] ],
|
|
output: [ 'Gimp-' + lang + '-pages' ],
|
|
command: [
|
|
gir_doc_tool,
|
|
'-I', prefix / 'share/gir-1.0/',
|
|
'-I', meson.build_root() / 'libgimp',
|
|
'--language=' + lang,
|
|
'-o', '@OUTDIR@' + '/pages/' + lang + '/Gimp-' + gimp_api_version,
|
|
meson.build_root() / '@INPUT@'
|
|
],
|
|
build_by_default: true)
|
|
|
|
# This step is completely an ugly workaround for 2 tool issues. The
|
|
# first issue is that g-ir-doc-tool generates invalid XML by not
|
|
# transforming less-than signs into entities. So I am special-casing
|
|
# the one API documentation where we need to write a less-than (it will
|
|
# need to be updated if this happens again).
|
|
# See GIMP issue #7685.
|
|
# The second issue is in meson itself which transforms backslash into
|
|
# slashes preventing to write most basic regexp in a 'command'. For
|
|
# this reason, I need to add the sed command as an external script.
|
|
# See meson issue #1564.
|
|
docs_pages_fix_sh = find_program('docs_pages_fix.sh')
|
|
gir_docs_pages_fix = custom_target('g-ir-Gimp-' + lang + '-pages-fix',
|
|
input: [ gir_docs_pages ],
|
|
output: [ 'Gimp-' + lang + '-pages-fix' ],
|
|
command: [
|
|
docs_pages_fix_sh,
|
|
'@OUTDIR@' + '/pages/' + lang + '/Gimp-' + gimp_api_version + '/Gimp.Procedure.add_menu_path.page',
|
|
'@OUTDIR@' + '/pages/' + lang + '/Gimp-' + gimp_api_version + '/Gimp.checks_get_colors.page',
|
|
],
|
|
build_by_default: true)
|
|
|
|
gir_docs_cache = custom_target('g-ir-Gimp-' + lang + '-cache',
|
|
input: [ gir_docs_pages_fix ],
|
|
output: [ 'Gimp-' + lang + '-cache' ],
|
|
command: [
|
|
yelp_build, 'cache',
|
|
'-o', '@OUTDIR@' + '/pages/' + lang + '/Gimp-' + gimp_api_version + '/index.cache',
|
|
'@OUTDIR@' + '/pages/' + lang + '/Gimp-' + gimp_api_version,
|
|
],
|
|
build_by_default: true)
|
|
|
|
gir_docs_html = custom_target('g-ir-Gimp-' + lang + '-html',
|
|
input: [ gir_docs_cache ],
|
|
output: [ 'Gimp-' + lang + '-html' ],
|
|
# TODO: `output` needs to be complete for installation to work. So
|
|
# we need to figure out how to install the generated files (listing
|
|
# all of them is a crazy idea, but maybe we can generate the
|
|
# expected list somehow? Maybe even using the .def file which is
|
|
# already an exhaustive listing would be a good idea?
|
|
# Also where should we install exactly?
|
|
#install_dir: prefix / gimpdatadir / 'g-ir-docs/html/' + lang + '/Gimp',
|
|
#install: true,
|
|
command: [
|
|
'yelp-build', 'html',
|
|
'-o', '@OUTDIR@' + '/html/' + lang + '/Gimp-' + gimp_api_version,
|
|
'@OUTDIR@' + '/pages/' + lang + '/Gimp-' + gimp_api_version,
|
|
],
|
|
build_by_default: true)
|
|
|
|
## GimpUi module ##
|
|
|
|
gir_ui_docs_pages = custom_target('g-ir-GimpUi-' + lang + '-pages',
|
|
depends: [ gir_docs_dir, libgimpui_gir ],
|
|
input: [ libgimpui_gir[0] ],
|
|
output: [ 'GimpUi-' + lang + '-pages' ],
|
|
command: [
|
|
gir_doc_tool,
|
|
'-I', prefix / 'share/gir-1.0/',
|
|
'-I', meson.build_root() / 'libgimp',
|
|
'--language=' + lang,
|
|
'-o', '@OUTDIR@' + '/pages/' + lang + '/GimpUi-' + gimp_api_version,
|
|
meson.build_root() / '@INPUT@'
|
|
],
|
|
build_by_default: true)
|
|
|
|
gir_ui_docs_cache = custom_target('g-ir-GimpUi-' + lang + '-cache',
|
|
input: [ gir_ui_docs_pages ],
|
|
output: [ 'GimpUi-' + lang + '-cache' ],
|
|
command: [
|
|
yelp_build, 'cache',
|
|
'-o', '@OUTDIR@' + '/pages/' + lang + '/GimpUi-' + gimp_api_version + '/index.cache',
|
|
'@OUTDIR@' + '/pages/' + lang + '/GimpUi-' + gimp_api_version,
|
|
],
|
|
build_by_default: true)
|
|
|
|
gir_ui_docs_html = custom_target('g-ir-GimpUi-' + lang + '-html',
|
|
input: [ gir_ui_docs_cache ],
|
|
output: [ 'GimpUi-' + lang + '-html' ],
|
|
#install_dir: prefix / gimpdatadir / 'g-ir-docs/html/' + lang + '/GimpUi',
|
|
#install: true,
|
|
command: [
|
|
'yelp-build', 'html',
|
|
'-o', '@OUTDIR@' + '/html/' + lang + '/GimpUi-' + gimp_api_version,
|
|
'@OUTDIR@' + '/pages/' + lang + '/GimpUi-' + gimp_api_version,
|
|
],
|
|
build_by_default: true)
|
|
|
|
endforeach
|
|
|
|
## TODO: a unit test using yelp-check would be useful.
|